require_once()
require_once()
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 下不區分大小寫
<?php
require_once("a.php"); // this will include a.php
require_once("A.php"); // this will include a.php again on Windows!
?>
警告 |
Windows 版本的 PHP 在 4.3.0 版之前不支援該函式的遠端檔案訪問,即使 allow_url_fopen 選項已被啟用。 |