PHP include_path 用法詳解

ini_set('include_path', CAKE_CORE_INCLUDE_PATH . PATH_SEPARATOR . ROOT . DS . APP_DIR . DS . PATH_SEPARATOR . ini_get('include_path'));

我們看到這個程序動態修改include_path,不過cake在這兒是把 CAKE_CORE_INCLUDE_PATH 和 APP_DIR 加到 include_path里,并且優先在這兩個目錄下找包含程序.

注意到它這里用到了PATH_SEPARATOR這個變量,這樣這段代碼在windows和linux下能通用.

從中受到啟發,我們可以根據自己的需要把一些include目錄動態的加入進來,比如說我們有很多libs:lib1,lib2,lib3等等,我們不必把這些libs都加到include_path里,因為它們之間可能沖突.

可以建立一個inc_dir,并把這個目錄加入到include_path,在inc_dir下,分別建立inc_path1.php inc_path2.php inc_path3.php,分別寫入:

在寫程序的時候,比如要用lib2的functions.php,就可以這么寫:

當時候函數include(),require(),fopen_with_path()函數來尋找文件時候.在不設置include_path的情況下,這些函數打開文件時候默認的是以web根目錄去尋找.當設置include_path以后,這些php函數就會先在指定的include_path目錄下面去搜索尋找.

其原理和window系統的環境變量相似,在window運行cmd命令的時候,輸入一些cmd的命令之后系統會在其設定的環境變量里面去搜索這些命令是否存在,存在就可以執行.

2.include_path的設置

第一種方法:修改php.ini文件中的include_path項。

include_path = .:/usr/local/lib/php:./include 

第二個方法：使用ini_set方法。 

ini_set("include_path", ".:../:./include:../include");　　　　　

3.注意 

zendframework include 設置 index.php,代碼如下:

PATH_SEPARATOR是一個常量,在Linux系統中是一個" : "號,Windows上是一個";"號,所以編寫程序時最好用常量 PATH_SEPARATOR 代替,否則如果系統從linux移植到win系統或反過來移植會出錯.

get_include_path取得當前已有的環境變量,加上前面的設置就是新的系統include

include_path是怎么起作用的?

如果有多個include_path順序是怎么樣的?什么情況下include_path不起作用?今天,我就全面的介紹下這個問題,先從一個例子開始吧.如下的目錄結構:

在1.php中:

而在2.php中:

而在root目錄下的3.php打印出”root”,在subdir目錄下的3.php打印出”subdir”;現在,我的問題來了:

1. 當在root目錄下運行1.php,會得到什么輸出?

2. 在subdir下運行上一級目錄的1.php,有會得到什么輸出?

3. 當取消include_path中的當前目錄path(也就是include_path=”path_to_subdir”),上面倆個問題又會是什么輸出?

PHP中的include_path

PHP在遇到require(_once)/include(_once)的指令的時候,首先會做如下的判斷:

要包含的文件路徑是絕對路徑么? 

如果是, 則直接包含, 并結束. 

如果不是, 進入另外的邏輯(經過多次調用,宏展開后進入_php_stream_fopen_with_path)尋找此文件 

接下來,在_php_stream_fopen_with_path中,會做如下判斷:

要包含的文件路徑是相對路徑么(形如./file, ../dir/file, 以下用”目錄相對路徑代替”)? 

如果是,則跳過include_path的作用邏輯,直接解析相對路徑(隨后單獨介紹),會根據include_path,和當前執行文件的path組成一個待選的目錄列表,比如對于文章前面的例子來說,會形成一個如下的待選列表.

“.:path_to_subdir:current_script_dir 

然后,依次從待選列表頭部開始,根據DEFAULT_DIR_SEPARATOR(本文的環境是”:”)取出待選列表中的一個路徑,然后把要包含的文件名附加在這個路徑后面,進行嘗試,如果成功包含,則返回,否則繼續下一個待選路徑.

到現在為止,我們已經可以回答我開頭提出的3個問題了:

1. 因為在root目錄下執行, 所以在1.php中包含2.php的時候, include_path的第二個待選路徑起了作用(path_to_subdir), 找到了path_to_subdir/2.php, 而在2.php包含3.php的時候, 當前工作目錄是root下, 所以在包含3.php的時候, include_path的第一個待選路徑”.”(當前工作目錄)下就找到的匹配的文件, 所以得到的輸出是”root”.

2. 同1, 只不過當前的路徑是subdir, 所以得到的輸出是”subdir”.

3. 因為沒有了當前路徑為include_path,所以在root目錄下運行的時候2.php中包含3.php的時候,是path_to_subdir起了作用,所以無論在root還是subdir都將得到”subdir”的輸出.

而如果在2.php中清空include_path:

那么將會是current_script_dir起作用,而這個時候current_script_dir是2.php的路徑,所以還是會得到”subdir”的輸出.

目錄相對路徑

在使用目錄相對路徑的情況下,相對路徑的基點,永遠都是當前工作目錄.為了說明在目錄相對路徑下的情況,我們再看個列子,還是上面的目錄結構,只不過1.php變成了:

2.php變成了:

如果在root目錄下執行,2.php中尋找3.php將會在當前目錄的相對路徑下尋找,所以得到的輸出是”root”,而如果是在subdir下執行上一級目錄的1.php(php -f ../1.php), 將會因為在subdir下找不到”./subdir/2.php”而異常退出.

后記:1.因為使用include_path和相對路徑的情況下,性能會和尋找的次數有關,最壞的情況下,如果你有10個include_path,那么最多可能會重試11次才能找到要包含的文件,所以,在能使用絕對路徑的情況下最好使用絕對路徑.

生活不易，碼農辛苦
如果您覺得本網站對您的學習有所幫助,可以手機掃描二維碼進行捐贈