上一節(CI框架源碼閱讀筆記1 - 環境准備、基本術語和框架流程)中,我們提到了CI框架的基本流程,這裡再次貼出流程圖,以備參考:
作為CI框架的入口文件,源碼閱讀,自然由此開始。在源碼閱讀的過程中,我們並不會逐行進行解釋,而只解釋核心的功能和實現。
define('ENVIRONMENT', 'development');
這裡的development可以是任何你喜歡的環境名稱(比如dev,再如test),相對應的,你要在下面的switch case代碼塊中,對設定的環境做相關的錯誤控制,否則,CI框架會認為你沒有配置好相應的環境,從而退出進程並給出對應的錯誤信息:
default: exit('The application environment is not set correctly.');
為什麼一開始就要配置ENVIRONMENT?這是因為,CI框架中很多組件都依賴於ENVIRONMENT的配置,我們看一下system中,引用ENVIRONMENT的地方:
可以看到,很多組件都依賴於ENVIRONMENT.例如,查看system/config/Common.php, 這其中有一段引入配置文件的代碼,是這樣實現的:
if ( ! defined('ENVIRONMENT') OR ! file_exists($file_path = APPPATH.'config/'.ENVIRONMENT.'/config.php')) { $file_path = APPPATH.'config/config.php'; }
在CI框架中,很多配置文件都是通過這種方式引入的,因此ENVRIONMENT對於CI框架的正確運行時必須的,所以需要在開始的時候配置好ENVIRONMENT。設置ENVIRONMENT的一個好處是:可以很方便的切換系統的配置而不必修改系統代碼。例如,在系統進入測試階段時,database配置為測試的數據庫,而在系統測試完畢時,database切換到線上的數據庫。這好比是用一個開關控制了系統的環境切換,自然是非常方便的。
CI框架允許你將系統核心源碼和應用程序代碼分開放置,但是你必須設定好系統的system文件夾和application文件夾(同樣,文件夾名字可以是任何合法的文件夾名稱,而不一定使用’system’和’application’):
$system_path = 'system'; $application_folder = 'application';
接下來,有這麼一段代碼:
if (defined('STDIN')) { chdir(dirname(__FILE__)); }
這段代碼是干嘛的呢?首先,STDIN、STDOUT、STDERR是PHP以 CLI(Command Line Interface)模式運行而定義的三個常量,這三個常量類似於Shell的stdin,stdout,stdout,分別是PHP CLI模式下的標准輸入、標准輸出和標准錯誤流。也就是說,這三行代碼是為了保證命令行模式下,CI框架可以正常運行。關於PHP CLI的更多細節可以參考:http://www.php-cli.com/
(1). system目錄的正確性驗證
Realpath返回的是目錄或文件的絕對目錄名(沒有最後的/)
if (realpath($system_path) !== FALSE) { $system_path = realpath($system_path).'/'; } $system_path = rtrim($system_path, '/').'/'; if ( ! is_dir($system_path)) { exit("xxxxxxxx"); }
幾個定義的常量(PATH結尾的常量表示目錄路徑,DIR結尾的變量表示目錄名):
a. SELF(這裡指index.php文件)
b. EXT(deprecated,廢棄的,不必關注)
c. BASEPATH(system文件夾的路徑)
d. FCPATH(前端控制器的路徑)
e. SYSDIR(系統system目錄名)
f. APPPATH(應用程序路徑)
查看所有定義的常量的方法:
Print_r(get_defined_constants());
(2)application的目錄驗證。
代碼較簡單,不做過多的解釋:
if (is_dir($application_folder)) { define('APPPATH', $application_folder.'/'); } else { if ( ! is_dir(BASEPATH.$application_folder.'/')) { exit("Your application folder path does not appear to be set correctly. Please open the following file and correct this: ".SELF); } define('APPPATH', BASEPATH.$application_folder.'/'); }
入口文件的最後一行,引入CodeIgniter.php(也是下一步閱讀的關鍵)。CodeIgniter.php被稱為bootstrap file,也就是它是一個引導文件,是CI框架執行流程的核心文件。
require_once BASEPATH.'core/CodeIgniter.php';
總結一下,index.php並沒有做太多復雜的工作,而是類似一個後勤,為CI框架的運行提供了一系列配置參數和正確性驗證,而這些配置和驗證,是CI框架能夠正常運行的關鍵。
最後,按照慣例,貼一下整個文件的源碼(簡化注釋版):
1 <?php 2 3 define('ENVIRONMENT', 'development'); 4 5 if (defined('ENVIRONMENT')) 6 { 7 switch (ENVIRONMENT) 8 { 9 case 'development': 10 error_reporting(E_ALL); 11 break; 12 13 case 'testing': 14 case 'production': 15 error_reporting(0); 16 break; 17 18 default: 19 exit('The application environment is not set correctly.'); 20 } 21 } 22 23 /* 24 * SYSTEM FOLDER NAME 25 */ 26 $system_path = 'system'; 27 28 /* 29 * APPLICATION FOLDER NAME 30 */ 31 $application_folder = 'application'; 32 33 /* 34 * Resolve the system path for increased reliability 35 */ 36 if (defined('STDIN')) 37 { 38 chdir(dirname(__FILE__)); 39 } 40 41 if (realpath($system_path) !== FALSE) 42 { 43 $system_path = realpath($system_path).'/'; 44 } 45 46 $system_path = rtrim($system_path, '/').'/'; 47 48 if ( ! is_dir($system_path)) 49 { 50 exit("xxxxxxxx"); 51 } 52 53 /* 54 * set the main path constants 55 */ 56 // The name of THIS file 57 define('SELF', pathinfo(__FILE__, PATHINFO_BASENAME)); 58 59 // this global constant is deprecataaed. 60 define('EXT', '.php'); 61 62 // Path to the system folder 63 define('BASEPATH', str_replace("\\", "/", $system_path)); 64 65 // Path to the front controller (this file) 66 define('FCPATH', str_replace(SELF, '', __FILE__)); 67 68 // Name of the "system folder" 69 define('SYSDIR', trim(strrchr(trim(BASEPATH, '/'), '/'), '/')); 70 71 // The path to the "application" folder 72 if (is_dir($application_folder)) 73 { 74 define('APPPATH', $application_folder.'/'); 75 } 76 else 77 { 78 if ( ! is_dir(BASEPATH.$application_folder.'/')) 79 { 80 exit("Your application folder path does not appear to be set correctly. Please open the following file and correct this: ".SELF); 81 } 82 83 define('APPPATH', BASEPATH.$application_folder.'/'); 84 } 85 86 require_once BASEPATH.'core/CodeIgniter.php';
閣下需要在使用框架,那麼就要把項目裡的第一個程序都放在框架架構之中,而不能在根目錄下新建一個admin.php。
閣下應該知曉,CI框架的入口文件是index.php,裡面的任何頁面都應該基於這個入口文件,即訪問路徑永遠是index.php/*****這樣的形式,而不能單獨出來一個admin.php,這樣的話,沒有通過入口文件訪問了,那麼框架的效用也就沒有了。
所以,閣下應該在application裡的controllers目錄下建一個admin.php,並按CI框架控制器的規則來使用它,這樣,訪問路徑就是index.php/admin這樣了
當然,閣下會以為所有的URL中都有一個index.php非常難看,那麼閣下可以通過CI框架的路由規則將之隱藏掉,也可以使用服務器的偽靜態功能來隱藏掉。但也僅是隱藏了而已,實際路徑仍然有index.php這個入口文件。
1.修改Http.conf的LoadModule rewrite_module modules/mod_rewrite.so去掉注釋 2.ci根目錄增加.htaccess文件 RewriteEngine On RewriteBase /ci #Removes access to the system folder by users. #Additionally this will allow you to create a System.php controller, #previously this would not have been possible. #'system' can be replaced if you have renamed your system folder. RewriteCond %{REQUEST_URI} ^system.* RewriteRule ^(.*)$ /index.php?/$1 [L] #When your application folder isn't in the system folder #This snippet prevents user access to the application folder #Submitted by: Fabdrol #Rename 'application' to your applications folder name. RewriteCond %{REQUEST_URI} ^application.* RewriteRule ^(.*)$ /index.php?/$1 [L] #Checks to see if the user is attempting to access a valid file, #such as an image or css document, if this isn't true it sends the #request to index.php RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php?/$1 [L] # If we don't have mod_rewrite installed, all 404's # can be sent to index.php, and everything works as normal. # Submitted by: ElliotHaughin ErrorDocument 404 /index.php .htaccess文件內容