require

require?和?include?幾乎完全一樣，除了處理失敗的方式不同之外。?require?在出錯時產生?E_COMPILE_ERROR?級別的錯誤，換句話說將導致腳本中止而?include?只產生警告（E_WARNING），腳本會繼續運行。

include

include?語句包含并運行指定文件。

以下文檔也適用于?require：

被包含文件先按參數給出的路徑尋找，如果沒有給出目錄（只有文件名）時則按照?include_path?指定的目錄尋找。如果在?include_path?下沒找到該文件則?include?最后才在調用腳本文件所在的目錄和當前工作目錄下尋找。如果最后仍未找到文件則?include?結構會發出一條警告；這一點和?require?不同，后者會發出一個致命錯誤。（關于include_path可參考這篇文章：PHP擴展之選項和配置信息）

如果定義了路徑——不管是絕對路徑（在 Windows 下以盤符或者??開頭，在 Unix/Linux 下以?/?開頭）還是當前目錄的相對路徑（以?.?或者?..?開頭）——include_path?都會被完全忽略。例如一個文件以?../?開頭，則解析器會在當前目錄的父目錄下尋找該文件。

當一個文件被包含時，其中所包含的代碼繼承了 include 所在行的變量范圍。從該處開始，調用文件在該行處可用的任何變量在被調用的文件中也都可用。不過所有在包含文件中定義的函數和類都具有全局作用域。

Example #1 基本的?include?例子

vars.php<?php $color = ’green’; $fruit = ’apple’;?>test.php<?php echo 'A $color $fruit'; // A include ’vars.php’; echo 'A $color $fruit'; // A green apple?>

如果 include 出現于調用文件中的一個函數里，則被調用的文件中所包含的所有代碼將表現得如同它們是在該函數內部定義的一樣。所以它將遵循該函數的變量范圍。此規則的一個例外是魔術常量，它們是在發生包含之前就已被解析器處理的。

Example #2 函數中的包含

<?phpfunction foo(){ global $color; include ’vars.php’; echo 'A $color $fruit';}/* vars.php is in the scope of foo() so ** $fruit is NOT available outside of this ** scope. $color is because we declared it ** as global. */foo(); // A green appleecho 'A $color $fruit'; // A green?>

當一個文件被包含時，語法解析器在目標文件的開頭脫離 PHP 模式并進入 HTML 模式，到文件結尾處恢復。由于此原因，目標文件中需要作為 PHP 代碼執行的任何代碼都必須被包括在有效的 PHP 起始和結束標記之中。

如果“URL fopen wrappers”在 PHP 中被激活（默認配置），可以用 URL（通過 HTTP 或者其它支持的封裝協議——見支持的協議和封裝協議）而不是本地文件來指定要被包含的文件。如果目標服務器將目標文件作為 PHP 代碼解釋，則可以用適用于 HTTP GET 的 URL 請求字符串來向被包括的文件傳遞變量。嚴格的說這和包含一個文件并繼承父文件的變量空間并不是一回事；該腳本文件實際上已經在遠程服務器上運行了，而本地腳本則包括了其結果。

WarningWindows 版本的 PHP 在 4.3.0 版之前不支持通過此函數訪問遠程文件，即使已經啟用?allow_url_fopen.

Example #3 通過 HTTP 進行的?include

<?php /* This example assumes that www.example.com is configured to parse .php * * files and not .txt files. Also, ’Works’ here means that the variables * * $foo and $bar are available within the included file. */ // Won’t work; file.txt wasn’t handled by www.example.com as PHP include ’http://www.example.com/file.txt?foo=1&bar=2’; // Won’t work; looks for a file named ’file.php?foo=1&bar=2’ on the // local filesystem. include ’file.php?foo=1&bar=2’; // Works. include ’http://www.example.com/file.php?foo=1&bar=2’; $foo = 1; $bar = 2; include ’file.txt’; // Works. include ’file.php’; // Works.?>安全警告

遠程文件可能會經遠程服務器處理（根據文件后綴以及遠程服務器是否在運行 PHP 而定），但必須產生出一個合法的 PHP 腳本，因為其將被本地服務器處理。如果來自遠程服務器的文件應該在遠端運行而只輸出結果，那用?readfile()?函數更好。另外還要格外小心以確保遠程的腳本產生出合法并且是所需的代碼。

處理返回值：在失敗時?include?返回?FALSE?并且發出警告。成功的包含則返回?1，除非在包含文件中另外給出了返回值。可以在被包括的文件中使用?return?語句來終止該文件中程序的執行并返回調用它的腳本。同樣也可以從被包含的文件中返回值。可以像普通函數一樣獲得 include 調用的返回值。不過這在包含遠程文件時卻不行，除非遠程文件的輸出具有合法的 PHP 開始和結束標記（如同任何本地文件一樣）。可以在標記內定義所需的變量，該變量在文件被包含的位置之后就可用了。

因為?include?是一個特殊的語言結構，其參數不需要括號。在比較其返回值時要注意。

Example #4 比較 include 的返回值

<?php//?won’t?work,?evaluated?as?include((’vars.php’)?==?’OK’),?i.e.?include(’’)if?(include(’vars.php’)?==?’OK’)?{????echo?’OK’;}//?worksif?((include?’vars.php’)?==?’OK’)?{????echo?’OK’;}?>

Example #5?include?和?return?語句

return.php<?php$var?=?’PHP’;return?$var;?>noreturn.php<?php$var?=?’PHP’;?>testreturns.php<?php$foo?=?include?’return.php’;echo?$foo;?//?prints?’PHP’$bar?=?include?’noreturn.php’;echo?$bar;?//?prints?1?>

$bar?的值為?1?是因為 include 成功運行了。注意以上例子中的區別。第一個在被包含的文件中用了?return?而另一個沒有。如果文件不能被包含，則返回?FALSE?并發出一個E_WARNING?警告。

如果在包含文件中定義有函數，這些函數不管是在?return?之前還是之后定義的，都可以獨立在主文件中使用。如果文件被包含兩次，PHP 5 發出致命錯誤因為函數已經被定義，但是 PHP 4 不會對在?return?之后定義的函數報錯。推薦使用?include_once?而不是檢查文件是否已包含并在包含文件中有條件返回。

另一個將 PHP 文件“包含”到一個變量中的方法是用輸出控制函數結合?include?來捕獲其輸出，例如：

Example #6 使用輸出緩沖來將 PHP 文件包含入一個字符串

<?php$string?=?get_include_contents(’somefile.php’);function?get_include_contents($filename)?{????if?(is_file($filename))?{????????ob_start();????????include?$filename;????????$contents?=?ob_get_contents();????????ob_end_clean();????????return?$contents;????}????return?false;}?>

要在腳本中自動包含文件，參見?php.ini?中的?auto_prepend_file?和?auto_append_file?配置選項。

Note:?因為是一個語言構造器而不是一個函數，不能被?可變函數?調用。

require_once

(PHP 4, PHP 5)

require_once?語句和?require?語句完全相同，唯一區別是 PHP 會檢查該文件是否已經被包含過，如果是則不會再次包含

include_once

(PHP 4, PHP 5)

include_once?語句在腳本執行期間包含并運行指定文件。此行為和?include?語句類似，唯一區別是如果該文件中已經被包含過，則不會再次包含。如同此語句名字暗示的那樣，只會包含一次。

include_once?可以用于在腳本執行期間同一個文件有可能被包含超過一次的情況下，想確保它只被包含一次以避免函數重定義，變量重新賦值等問題。

Note:

在 PHP 4中，_once?的行為在不區分大小寫字母的操作系統（例如 Windows）中有所不同，例如：

Example #1?include_once?在 PHP 4 運行于不區分大小寫的操作系統中

<?phpinclude_once?'a.php';?//?這將包含?a.phpinclude_once?'A.php';?//?這將再次包含?a.php！（僅?PHP?4）?>

此行為在 PHP 5 中改了，例如在 Windows 中路徑先被規格化，因此?C:PROGRA~1A.php?和?C:Program Filesa.php?的實現一樣，文件只會被包含一次。