require()

require() 語句包括並運行指定檔案。

require() 語句包括並運行指定檔案。有關內含如何工作的詳細訊息見 include() 的文件。

require() 和 include() 除了怎樣處理失敗之外在各方面都完全一樣。include() 產生一個警示而 require() 則導致一個致命錯誤。換句話說，若果想在丟失檔案時停止處理頁面，那就別猶豫了，用 require() 吧。include() 就不是這樣，腳本會繼續運行。同時也要確認設定了合適的include_path。

例子 16-4. 基本的 require() 例子
<?php require 'prepend.php'; require $somefile; require ('somefile.txt'); ?>

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

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

注: 由於這是一個語系結構而非函數，因此它無法被變量函數呼叫。

警示

Windows 版本的 PHP 在 4.3.0 版之前不支援本函數的遠端檔案訪問，即使 allow_url_fopen 選項已被啟動。

參見 include()，require_once()，include_once()，eval()，file()，readfile()，virtual() 和 include_path。