include_once()

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

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

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

返回值和 include() 相同。若果檔案已被包括，本函數返回 TRUE。

注: include_once() 是 PHP 4.0.1pl2 中新加入的。

注: 要注意 include_once() 和 require_once() 在大小寫不敏感的動作系統中（例如 Windows）的行為可能不是所期望的。
例子 16-13. include_once() 在 Windows 下不區分大小寫
<?php include_once("a.php"); // this will include a.php include_once("A.php"); // this will include a.php again on Windows! (PHP 4 only) ?>
此行為在 PHP 5 中改了，路徑先被規格化，因此 C:\PROGRA~1\A.php 和 C:\Program Files\a.php 的實現一樣，檔案只會被包括一次。

警示

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

參見 include()，require()，require_once()，get_required_files()，get_included_files()，readfile() 和 virtual()。