上一節(jié)(CI框架源碼閱讀筆記1 - 環(huán)境準(zhǔn)備、基本術(shù)語和框架流程)中,我們提到了CI框架的基本流程,這里再次貼出流程圖,以備參考:
作為CI框架的入口文件,源碼閱讀,自然由此開始。在源碼閱讀的過程中,我們并不會逐行進(jìn)行解釋,而只解釋核心的功能和實(shí)現(xiàn)。
define('ENVIRONMENT', 'development');
這里的development可以是任何你喜歡的環(huán)境名稱(比如dev,再如test),相對應(yīng)的,你要在下面的switch case代碼塊中,對設(shè)定的環(huán)境做相關(guān)的錯(cuò)誤控制,否則,CI框架會認(rèn)為你沒有配置好相應(yīng)的環(huán)境,從而退出進(jìn)程并給出對應(yīng)的錯(cuò)誤信息:
default: exit('The application environment is not set correctly.');
為什么一開始就要配置ENVIRONMENT?這是因?yàn)椋珻I框架中很多組件都依賴于ENVIRONMENT的配置,我們看一下system中,引用ENVIRONMENT的地方:
可以看到,很多組件都依賴于ENVIRONMENT.例如,查看system/config/Common.php, 這其中有一段引入配置文件的代碼,是這樣實(shí)現(xiàn)的:
if ( ! defined('ENVIRONMENT') OR ! file_exists($file_path = APPPATH.'config/'.ENVIRONMENT.'/config.php')){ $file_path = APPPATH.'config/config.php';}
在CI框架中,很多配置文件都是通過這種方式引入的,因此ENVRIONMENT對于CI框架的正確運(yùn)行時(shí)必須的,所以需要在開始的時(shí)候配置好ENVIRONMENT。設(shè)置ENVIRONMENT的一個(gè)好處是:可以很方便的切換系統(tǒng)的配置而不必修改系統(tǒng)代碼。例如,在系統(tǒng)進(jìn)入測試階段時(shí),database配置為測試的數(shù)據(jù)庫,而在系統(tǒng)測試完畢時(shí),database切換到線上的數(shù)據(jù)庫。這好比是用一個(gè)開關(guān)控制了系統(tǒng)的環(huán)境切換,自然是非常方便的。
2. 配置系統(tǒng)目錄和應(yīng)用程序目錄CI框架允許你將系統(tǒng)核心源碼和應(yīng)用程序代碼分開放置,但是你必須設(shè)定好系統(tǒng)的system文件夾和application文件夾(同樣,文件夾名字可以是任何合法的文件夾名稱,而不一定使用’system’和’application’):
$system_path = 'system';$application_folder = 'application';
接下來,有這么一段代碼:
if (defined('STDIN')){ chdir(dirname(__FILE__));}
這段代碼是干嘛的呢?首先,STDIN、STDOUT、STDERR是PHP以 CLI(Command Line Interface)模式運(yùn)行而定義的三個(gè)常量,這三個(gè)常量類似于Shell的stdin,stdout,stdout,分別是PHP CLI模式下的標(biāo)準(zhǔn)輸入、標(biāo)準(zhǔn)輸出和標(biāo)準(zhǔn)錯(cuò)誤流。也就是說,這三行代碼是為了保證命令行模式下,CI框架可以正常運(yùn)行。關(guān)于PHP CLI的更多細(xì)節(jié)可以參考:http://www.php-cli.com/
3. system目錄的正確性驗(yàn)證和application目錄驗(yàn)證(1). system目錄的正確性驗(yàn)證
Realpath返回的是目錄或文件的絕對目錄名(沒有最后的/)
if (realpath($system_path) !== FALSE){ $system_path = realpath($system_path).'/';}$system_path = rtrim($system_path, '/').'/';if ( ! is_dir($system_path)){ exit("xxxxxxxx");}
幾個(gè)定義的常量(PATH結(jié)尾的常量表示目錄路徑,DIR結(jié)尾的變量表示目錄名):
a. SELF(這里指index.php文件)
b. EXT(deprecated,廢棄的,不必關(guān)注)
c. BASEPATH(system文件夾的路徑)
d. FCPATH(前端控制器的路徑)
e. SYSDIR(系統(tǒng)system目錄名)
f. APPPATH(應(yīng)用程序路徑)
查看所有定義的常量的方法:
Print_r(get_defined_constants());
(2)application的目錄驗(yàn)證。
代碼較簡單,不做過多的解釋:
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(也是下一步閱讀的關(guān)鍵)。CodeIgniter.php被稱為bootstrap file,也就是它是一個(gè)引導(dǎo)文件,是CI框架執(zhí)行流程的核心文件。
require_once BASEPATH.'core/CodeIgniter.php';
總結(jié)一下,index.php并沒有做太多復(fù)雜的工作,而是類似一個(gè)后勤,為CI框架的運(yùn)行提供了一系列配置參數(shù)和正確性驗(yàn)證,而這些配置和驗(yàn)證,是CI框架能夠正常運(yùn)行的關(guān)鍵。
最后,按照慣例,貼一下整個(gè)文件的源碼(簡化注釋版):
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 NAME25 */26 $system_path = 'system';27 28 /*29 * APPLICATION FOLDER NAME30 */31 $application_folder = 'application';32 33 /*34 * Resolve the system path for increased reliability35 */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 constants55 */56 // The name of THIS file57 define('SELF', pathinfo(__FILE__, PATHINFO_BASENAME));58 59 // this global constant is deprecataaed.60 define('EXT', '.php');61 62 // Path to the system folder63 define('BASEPATH', str_replace("http://", "/", $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" folder72 if (is_dir($application_folder))73 {74 define('APPPATH', $application_folder.'/');75 }76 else77 {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';PHP編程
鄭重聲明:本文版權(quán)歸原作者所有,轉(zhuǎn)載文章僅為傳播更多信息之目的,如作者信息標(biāo)記有誤,請第一時(shí)間聯(lián)系我們修改或刪除,多謝。
新聞熱點(diǎn)
疑難解答
圖片精選