了解 PHP 中 include、require、include_once 和 require_once 之间的区别

# Web 开发 # 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 中包括和评估文件。但是，主要区别在于如何处理错误。

要求的行为：

如果找不到该文件或无法包含该文件，PHP 将发出致命错误 (E_COMPILE_ERROR)，并且脚本将立即停止执行。

与包含不同，如果文件丢失很严重，脚本将会停止。

需要的用例：

当包含的文件对于应用程序的功能**必不可少**时，您应该使用“require”。例如，设置常量或包含应用程序重要功能的配置文件应包含在“require”中。如果文件丢失，继续执行可能会导致不可预测的行为或失败。

例子：

// 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.";

为什么要使用 require？

当包含的文件对于脚本的运行至关重要时，如配置文件或数据库连接脚本。

您想确保如果文件丢失则脚本停止执行，以避免脚本稍后出现意外错误或崩溃。

3.include_once语句

什么是include_once？

`include_once` 语句与 `include` 语句类似，但有一个主要区别：它确保在脚本执行期间文件只被包含一次，无论在代码中调用多少次 `include_once` 语句。

include_once 的行为：

它将尝试像 include 一样包含该文件。

如果该文件之前已经在当前脚本中包含过，则不会再次包含它。

如果找不到该文件，它会发出警告，就像 include 一样，但脚本会继续运行。

include_once的用例：

通常，在包含可能包含函数或类定义的文件时，无论调用包含多少次，这些函数或类定义都应仅包含一次，这时应使用“include_once”。例如，您不会希望包含多次定义类的文件，因为这可能会导致**重新定义错误**。

例子：

// Ensuring a file is included only once
include_once 'functions.php';  // The file will be included only once
include_once 'functions.php';  // This will be ignored, file not included again
echo "The functions file is included once.";

为什么使用include_once？

防止多次包含文件。

在仅应包含一次的文件（如实用程序文件或配置文件）中定义函数、类或常量时很有用。

4. require_once 语句

什么是 require_once？

`require_once` 语句的工作方式与 `require` 类似，但附加了确保文件在脚本执行期间仅包含一次的行为。

require_once 的行为：

它将尝试像 require 一样包含该文件。

如果该文件已被包含，它将不会再次包含它，从而防止类、函数或常量的重新定义错误。

如果该文件丢失，就会导致致命错误，就像 require 一样，停止脚本的执行。

require_once 的用例：

在包含必须仅包含一次的重要文件（例如数据库连接文件、配置文件或类定义）时，应使用“require_once”。这是确保关键文件仅包含一次且不存在重新定义风险的最可靠、最安全的方法。

例子：

// Ensuring a critical file is included only once
require_once 'database.php';  // Will include only once, even if called multiple times
require_once 'database.php';  // This will be ignored
echo "The database file is included once.";

为什么要使用 require_once？

当您需要包含对脚本至关重要的文件并确保它们只包含一次时，例如配置文件或类定义。

通过确保文件不被多次包含来防止重新定义错误。

include、require、include_once 和 require_once 的比较

关键要点：

包括：当文件是可选的并且缺少的文件不应停止脚本时使用。

require：当文件至关重要时使用，如果文件丢失，脚本应该停止。

include_once：当文件是可选的但只应包含一次以避免重复时使用。

require_once：当文件至关重要并且只能包含一次时使用。

结论

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

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

CLIS.CC