php中關於使用include(require)嵌套包含檔案時的問題需要注意

/** 
* Author:RDP 
* My mail:abel1314520@gmail.com 
* My blog:  http://blog.teamhaka.com
 */

附註：以下說明都適用於include、include_once、require、 require_once。

範例基本上都是a.php包含b.php，b.php包含c.php這樣的巢狀包含形式。主要討論的是a.php和c.php之間的結構關係。其中a.php為入口檔案。

 

包含檔案時的路徑其實有三種選擇。

分別是

一絕對路徑                                     例：/aaa/bbb/ccc/c.php

二相對路徑（當前目錄使用./）           例：./ccc /c.php

三相對路徑（目前目錄不使用./）       例：ccc/c.php

關於兩個相對路徑，可以直觀的注意上述(二)和(三)相對路徑的不同點。有沒有./在嵌套包含檔案的時候，會有很大的不同！後文具體說明。

 

一使用絕對路徑的注意點：

#直接寫絕對路徑沒有什麼好注意的，但是在使用dirname(FILE)來取得目前檔案的絕對路徑時，要注意無論寫這條語句的php檔案是否被其他檔案所包含，dirname(FILE)總是指向寫這條語句的php檔案所在的絕對路徑。

範例：  

#作為入口檔案的a.php： require './b/b.php';

b.php：require dirname(FILE).'/c.php';

那麼在執行a.php時，b.php中的dirname(FILE)得到的是b.php所在的絕對路徑，而不是a.php所在的絕對路徑。 (在此例中意味著b.php和c.php是同屬於b目錄下的)

 

二使用相對路徑（目前目錄使用./）的注意點：

相對路徑是以某個目錄為基準來決定需要包含的檔案所在的位置。 相對路徑的基準目錄就是程式執行的入口檔案所在的目錄，不管包含嵌套多少層。

範例：  

#作為入口檔案的a.php： require './b/b.php';

b.php： require './c/c.php';  //請注意這裡包含c目錄時使用的是./  

那麼，注意這裡的c.php所在的c目錄和b目錄是同級的，而並非是c目錄在b目錄的下面。因為b.php中的包含使用了相對路徑，而程式入口是a.php，所以b.php包含使用的相對路徑應是以入口檔案a.php所在目錄來作為基準的。

 

三 使用相對路徑（目前目錄不使用./）的注意點：

分兩步驟處理，首先以程式入口文件所在目錄為基準沿著相對路徑來尋找，找到存在的檔案則包含成功退出（和上述的【相對路徑（目前目錄使用./）】一樣）。如果找不到，則走第二步處理。即寫require語句的php檔案所在目錄來和require中包含的路徑進行拼接，還是以入口檔案所在目錄為基準，沿著這個拼接得到的相對路徑來搜尋，檔案存在則包含成功，否則表示被包含文件不存在。看例子理解比較容易。

範例：  

為入口檔案的a.php： require './b/b.php';

b.php： require 'c/c.php';  //請注意這裡包含c目錄時沒有使用./  

那麼，首先會在入口檔案a.php所在的目錄下搜尋c/ c.php，如果有，則包含成功。

如果沒找到，接下來就將b.php的所在路徑(./b/b.php)和b.php中require的路徑（c/c.php）進行拼接，得到拼接後的相對路徑./b/c/c.php。在入口檔案a.php所在的目錄下搜尋./b/c/c.php，存在就包含成功，否則即出錯。

 

/*******************分割線***********************/

稍微總結下相對路徑的巢狀包含。

相對路徑的巢狀包含，都是以程式入口檔案所在目錄為基準來沿著相對路徑來搜尋需要包含的檔案的。

但是如果在相對路徑中使用到了當前目錄這個概念時，就會有差異。即，使不使用./來表示當前目錄，所帶來的處理是不一樣的。

有./就是以入口文件所在目录为基准来直接搜寻，

没有./，则先以入口文件所在目录为基准来搜寻，找不到的情况下做路径的拼接处理，然后按拼接后的相对路径来搜寻，基准依然是入口文件所在目录。

综合下使用./和不使用./的一个例子：

文件结构如下：

/WEBROOT

——–test.php

——–/folder2/test2.php

——–/folder2/folder3/test3.php

作为程序入口的test.php包含test2.php，而test2.php中包含了test3.php。

那么在test2.php中的包含路径的写法有如下差异：

require ('folder2/folder3/test3.php'); //正确！ 直接在入口程test.php所在的WEBROOT目录下搜寻folder2/folder3/test3.php  
参考上述的【三 使用相对路径（当前目录不使用./）的注意点】

require ('folder3/test3.php');  //正确！ 拼接相对路径然后搜寻  参考上述的【三 使用相对路径（当前目录不使用./）的注意点】

1. require
    (
   './folder2/folder3/test3.php'
   );  
   //正确！  参考上述的【二 使用相对路径（当前目录使用./）的注意点】

1. require
    (
   './test3/test3.php'
   );    
   //错误！入口程序test.php所在的WEBROOT目录下并不存在test3这个目录！参考上述的【二 使用相对路径（当前目录使用./）的注意点】

以上是php中關於使用include(require)嵌套包含檔案時的問題需要注意的詳細內容。更多資訊請關注PHP中文網其他相關文章！