1. <?php 
2. require 'prepend.php'; 
3. require $somefile; 
4. require ('somefile.txt'); 
5. ?> 

更多例子參見 include() 文檔。

注: 在 php 4.0.2 之前適用以下規則：require() 總是會嘗試讀取目標文件，即使它所在的行根本就不會執行。條件語句不會影響 require()。不過如果 require() 所在的行沒有執行，則目標文件中的代碼也不會執行。同樣，循環結構也不影響 require() 的行為。盡管目標文件中包含的代碼仍然是循環的主體，但 require() 本身只會運行一次。

注: 由于這是一個語言結構而非函數，因此它無法被“變量函數”調用。

include() 語句包括并運行指定文件。

以下文檔也適用于 require()。這兩種結構除了在如何處理失敗之外完全一樣。include() 產生一個警告而 require() 則導致一個致命錯誤。換句話說，如果你想在遇到丟失文件時停止處理頁面就用 require()。include() 就不是這樣，腳本會繼續運行。同時也要確認設置了合適的 include_path。

當一個文件被包括時，其中所包含的代碼繼承了 include 所在行的變量范圍。從該處開始，調用文件在該行處可用的任何變量在被調用的文件中也都可用。

例子 16-3. 基本的 include() 例子 vars.php

1. <?php 
2. $color = 'green'; 
3. $fruit = 'apple'; 
4. ?> 
5. test.php 
6. <?php 
7. echo "a $color $fruit"; // a 
8. include 'vars.php'; 
9. echo "a $color $fruit"; // a green apple 
10. ?> 

如果 include 出現于調用文件中的一個函數里，則被調用的文件中所包含的所有代碼將表現得如同它們是在該函數內部定義的一樣,所以它將遵循該函數的變量范圍。

例子 16-4. 函數中的包括

1. <?php 
2. function foo() 
3. { 
4.    global $color; 
5.    include 'vars.php'; 
6.    echo "a $color $fruit"; 
7. } 
8. /* vars.php is in the scope of foo() so    * 
9.  * $fruit is not available outside of this  * 
10.  * scope.  $color is because we declared it * 
11.  * as global.      */ 
12. foo();    // a green apple 
13. echo "a $color $fruit";  // a green 
14. ?> 

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

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

警告:windows 版本的 php 在 4.3.0 版之前不支持本函數的遠程文件訪問，即使 allow_url_fopen 選項已被激活。

例子 16-5. 通過 http 進行的 include()

1. <?php 
2. include 'file.php?foo=1&bar=2'; 
3. // works. 
4. include 'http://www.example.com/file.php?foo=1&bar=2'; 
5. $foo = 1; 
6. $bar = 2; 
7. include 'file.txt';  // works. 
8. include 'file.php';  // works. 
9. ?> 

相關信息參見使用遠程文件，fopen() 和 file(),因為 include() 和 require() 是特殊的語言結構，在條件語句中使用必須將其放在語句組中（花括號中）。

例子 16-6. include() 與條件語句組

1. <?php 
2. // this is wrong and will not work as desired. 
3. if ($condition) 
4.    include $file; 
5. else 
6.    include $other; 
7.  
8. // this is correct. 
9. if ($condition) { 
10.    include $file; 
11. } else { 
12.    include $other; 
13. } 
14. ?> 

處理返回值：可以在被包括的文件中使用 return() 語句來終止該文件中程序的執行并返回調用它的腳本。同樣也可以從被包括的文件中返回值?？梢韵衿胀ê瘮狄粯荧@得 include 呼叫的返回值。

注: 在 php 3 中，除非是在函數中調用否則被包括的文件中不能出現 return。在此情況下 return() 作用于該函數而不是整個文件。

例子 16-7. include()和 return()語句 return.php

1. <?php 
2. $var = 'php'; 
3. return $var; 
4. ?> 

noreturn.php

1. <?php 
2. $var = 'php'; 
3. ?> 

testreturns.php

1. <?php 
2. $foo = include 'return.php'; 
3. echo $foo; // prints 'php' 
4. $bar = include 'noreturn.php'; 
5. echo $bar; // prints 1 
6. ?> 

$bar 的值為 1 是因為 include 成功運行了。注意以上例子中的區別。第一個在被包括的文件中用了 return() 而另一個沒有。其它幾種把文件“包括”到變量的方法是用 fopen()，file() 或者 include() 連同輸出控制函數一起使用。

注: 由于這是一個語言結構而非函數，因此它無法被“變量函數”調用。

require_once() 語句在腳本執行期間包括并運行指定文件。此行為和 require() 語句類似，唯一區別是如果該文件中的代碼已經被包括了，則不會再次包括。有關此語句怎樣工作參見 require() 的文檔。

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

使用 require_once() 和 include_once() 的例子見最新的 php 源程序發行包中的 pear 代碼。

注: require_once() 是 php 4.0.1pl2 中新加入的,要注意 require_once() 和 include_once() 在大小寫不敏感的操作系統中（例如 windows）的行為可能不是你所期望的。 例子 16-8. require_once() 在 windows 下不區分大小寫

1. <?php 
2. require_once("a.php"); // this will include a.php 
3. require_once("a.php"); // this will include a.php again on windows! 
4. ?> 

警告：windows 版本的 php 在 4.3.0 版之前不支持本函數的遠程文件訪問，即使 allow_url_fopen 選項已被激活。

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

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

使用 require_once() 和 include_once() 的更多例子見最新的 php 源程序發行包中的 pear 代碼。

注: include_once() 是 php 4.0.1pl2 中新加入的, 要注意 include_once() 和 require_once() 在大小寫不敏感的操作系統中（例如 windows）的行為可能不是你所期望的。 

例子16-9:include_once()在windows下不區分大小寫:

1. <?php 
2. include_once("a.php"); // this will include a.php 
3. include_once("a.php"); // this will include a.php again on windows! 
4. ?> 

警告:windows 版本的 php 在 4.3.0 版之前不支持本函數的遠程文件訪問，即使 allow_url_fopen 選項已被激活。