include?語句包含并運(yùn)行指定文件。
以下文檔也適用于?require。
被包含文件先按參數(shù)給出的路徑尋找,如果沒有給出目錄(只有文件名)時則按照?include_path?指定的目錄尋找。如果在?include_path?下沒找到該文件則?include?最后才在調(diào)用腳本文件所在的目錄和當(dāng)前工作目錄下尋找。如果最后仍未找到文件則?include?結(jié)構(gòu)會發(fā)出一條警告;這一點(diǎn)和require?不同,后者會發(fā)出一個致命錯誤。
如果定義了路徑——不管是絕對路徑(在 Windows 下以盤符或者?\?開頭,在 Unix/Linux 下以?/?開頭)還是當(dāng)前目錄的相對路徑(以?.?或者?..?開頭)——include_path?都會被完全忽略。例如一個文件以?../?開頭,則解析器會在當(dāng)前目錄的父目錄下尋找該文件。
有關(guān) PHP 怎樣處理包含文件和包含路徑的更多信息參見?include_path?部分的文檔。
當(dāng)一個文件被包含時,其中所包含的代碼繼承了 include 所在行的變量范圍。從該處開始,調(diào)用文件在該行處可用的任何變量在被調(diào)用的文件中也都可用。不過所有在包含文件中定義的函數(shù)和類都具有全局作用域。