PHP include 和 require 的核心区别与使用指南

错误处理机制的差异

include() 和 require() 的主要区别在于当指定文件无法被找到或访问时，脚本的处理方式。对于这两种结构而言，除了对错误的响应外，其行为是完全一致的。

• include：如果发生错误（如文件丢失），该语句会生成一个警告（Warning），但脚本会继续向下执行。这适用于那些即使缺失也不应中断程序主要流程的文件，例如可选的配置片段或非关键的模板部分。
• require：如果发生错误，该语句会导致一个致命的错误（Fatal Error），脚本将立即停止运行。这确保了代码的完整性，防止后续代码在一个缺少关键依赖的环境中不可靠地运行。

变量范围与作用域继承

当一个文件被包含时，其中所包含的代码继承了 include 或 require 所在行的变量范围。在此位置之后，调用文件中可用的任何变量在被调用的文件中也同样可用。

如果被包含的文件是在某个函数内部调用的，情况会有所不同。在被调用文件中执行的所有代码，其行为表现得如同它们是在该函数内部定义的一样。这意味着它将遵循该函数的变量作用域。因此，除非在调用文件中显式声明为全局变量，否则局部变量在文件间不会自动共享。

<?php
$color = 'green';
$fruit = 'apple';
?>

<?php
function foo()
{
    global $color;
    include 'vars.php';
    echo "A $color $fruit";
}
/* vars.php 处于 foo() 的作用域内，所以 * 
 * $fruit 在该作用域之外是不可用的。而 $color 因为被声明为全局变量而出现在外部。 */
foo(); // 输出: A green apple
echo "A $color $fruit"; // 输出: A green
?>

远程文件包含

如果启用了 PHP 配置中的 allow_url_fopen 选项（默认情况下通常启用），你可以使用 URL（通过 HTTP）而不是本地路径来指定要包含的文件。请注意，远程服务器必须正确配置以解析并执行 PHP 代码。

需要注意的是，Windows 版本的标准分发版 PHP 通常不支持远程文件访问，即使相关选项已激活。

返回值处理

可以在被包含的文件中使用 return() 语句来立即终止该文件的执行，并将控制权返回给调用它的脚本。这使得我们可以像获取函数返回值一样，获取 include 操作的返回值。

如果被包含的文件中没有 return 语句，则 include 成功执行后会返回整数 1。

<?php
// return.php 的内容
$var = 'PHP';
return $var;
?>

<?php
$foo = include 'return.php';
echo $foo; // 输出: PHP

$bar = include 'noreturn.php';
echo $bar; // 输出: 1 (代表包含成功)
?>

语法注意事项

由于 include() 和 require() 是特殊的语言结构而非普通函数，它们在语法上有特定的限制。尤其是在条件语句（如 if）中使用时，必须将其放在花括号（组）内，否则可能导致语法错误或意外行为。

<?php
// 这是错误的写法，可能导致解析问题
if ($condition)
    include $file;
else
    include $other;

// 这是正确的写法
if ($condition) {
    include $file;
} else {
    include $other;
}
?>