了解 PHP 中 include、require、include_once 和 require_once 之间的差异

使用 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)

要点：

• include：当文件是可选的时使用，并且丢失的文件不应停止脚本。
• require：当文件很关键时使用，如果文件丢失，脚本应该停止。
• include_once：当文件是可选的但只能包含一次以避免重复时使用。
• require_once：当文件很关键且必须仅包含一次时使用。

---

结论

选择正确的包含声明取决于您要包含的文件的性质以及您想要强制执行的行为。 require 和 require_once 通常用于重要文件，而 include 和 include_once 更适合非关键文件。使用这些语句的一次版本有助于防止出现多次包含时出现重新定义错误等问题。

通过了解这些差异，您可以编写更可靠、模块化且无错误的 PHP 代码，确保您的应用程序即使在处理丢失或重复的文件时也能正常运行。

以上是了解 PHP 中 include、require、include_once 和 require_once 之间的差异的详细内容。更多信息请关注PHP中文网其他相关文章！