了解 PHP 中 include、require、include_once 與 require_once 之間的差異-php教程-PHP中文網

Understanding the Differences Between include, require, include_once, and require_once in PHP

使用 PHP 時，您將遇到的常見任務之一是將外部檔案包含到腳本中。 PHP 為此任務提供了多種機制，分別為 include、require、include_once 和 require_once。這些語句對於模組化程式碼和實作應用程式各個部分的檔案重用至關重要。然而，理解這些命令之間的差異對於編寫高效且可維護的 PHP 程式碼至關重要。

本文將引導您了解每個語句，解釋它們的行為，突出它們的差異，並提供實際用例。

1. include 語句

什麼是包含？

PHP中的include語句用於在腳本執行過程中包含並評估指定的檔案。如果找到該文件，則會將其包含一次並在腳本中的該位置執行。

包含的行為：

如果找不到指定的文件，PHP 會發出警告 (E_WARNING)，但會繼續執行腳本。
警告訊息將包含無法找到的檔案的路徑。
它不會停止腳本的執行，因此如果包含的檔案不重要，腳本可以繼續運行而不會中斷。

包含的用例：

當檔案對程式流程並不重要且即使檔案遺失也可以繼續執行腳本時，您可以使用 include。這通常用於非必要文件，例如可選模板、設定檔或日誌記錄機制。

範例：

// Including a non-critical file
include 'header.php';  // This will continue if header.php is missing
echo "This part of the script will run regardless of the missing header file.";

登入後複製

為什麼要使用 include？

在包含頁面模板或非必要配置等可選文件時很有用。
即使無法包含文件，也允許腳本繼續運行。

2. require 語句

需要什麼？

與 include 一樣，require 語句用於在 PHP 中包含和評估檔案。然而，主要的區別在於如何處理錯誤。

require 的行為：

如果找不到或無法包含該文件，PHP 將發出致命錯誤 (E_COMPILE_ERROR)，並且腳本將立即停止執行。
與包含不同，遺失的檔案將停止腳本（如果它很重要）。

需求用例：

當包含的檔案對於應用程式的功能必不可少時，您應該使用require。例如，為應用程式設定常數或包含重要功能的設定檔應包含在 require 中。如果檔案遺失，繼續執行可能會導致不可預測的行為或失敗。

範例：

// Including a non-critical file
include 'header.php';  // This will continue if header.php is missing
echo "This part of the script will run regardless of the missing header file.";

登入後複製

為什麼要使用require？

當包含的檔案對於腳本的功能至關重要時，例如設定檔或資料庫連線腳本。
您希望確保腳本在檔案遺失時停止執行，以避免腳本稍後出現意外錯誤或崩潰。

3. include_once 語句

什麼是 include_once？

include_once 語句與 include 語句類似，有一個關鍵區別：它確保在腳本執行期間僅包含檔案一次，無論程式碼中呼叫 include_once 語句多少次。

include_once 的行為：

它將嘗試像 include 一樣包含該檔案。
如果該檔案之前已經包含在目前腳本中，則不會再次包含它。
如果找不到文件，會發出警告，就像include一樣，但腳本會繼續運行。

include_once 的用例：

當包含可能包含只應包含一次的函數或類別定義的檔案時，您通常會使用 include_once，無論您呼叫包含多少次。例如，您不想包含多次定義類別的文件，因為這可能會導致重新定義錯誤。

範例：

// Including a critical file
require 'config.php';  // This will stop the script if config.php is missing
echo "This will not run if config.php is not found.";

登入後複製

為什麼要使用 include_once？

防止多次包含文件。
在只應包含一次的檔案中定義函數、類別或常數時非常有用，例如實用程式檔案或設定檔。

4. require_once 語句

什麼是require_once？

require_once 語句的工作方式與 require 類似，但具有確保在腳本執行期間僅包含文件一次的附加行為。

require_once 的行為：

它將嘗試像 require 一樣包含該檔案。
如果該文件已被包含，則不會再次包含該文件，從而防止類別、函數或常數的重新定義錯誤。
如果檔案遺失，將會導致致命錯誤，就像require一樣，停止腳本的執行。

require_once 的用例：

在包含必須僅包含一次的基本檔案（例如資料庫連線檔案、設定檔或類別定義）時，應使用 require_once。這是確保關鍵文件僅包含一次且不存在重新定義風險的最穩健、最安全的方法。

範例：

// Including a non-critical file
include 'header.php';  // This will continue if header.php is missing
echo "This part of the script will run regardless of the missing header file.";

登入後複製

為什麼要使用 require_once？

當您需要包含對腳本至關重要的檔案並確保它們僅包含一次，例如設定檔或類別定義。
透過確保檔案不被多次包含來防止重新定義錯誤。

include、require、include_once 與 require_once 的比較

Statement	Behavior if File is Missing	Includes Only Once	Error Type
include	Warning, continues script	No	Warning (E_WARNING)
require	Fatal error, halts script	No	Fatal error (E_COMPILE_ERROR)
include_once	Warning, continues script	Yes	Warning (E_WARNING)
require_once	Fatal error, halts script	Yes	Fatal error (E_COMPILE_ERROR)