PHP 中 require() 语句返回值的用法详解

2026-01-01 00:00:00 作者：聖光之護

php 的 require 本质是语言构造而非函数，当被包含文件以 return 结尾时，require 表达式会返回该值，从而支持链式调用（如 ->run()），这是 slim 4 等现代框架常见的启动模式。

在 Slim 4 应用的入口文件（如 public/index.php）中，你常会看到这样一行简洁而有力的代码：

run();

这行代码看似“语法糖”，实则融合了 PHP 的两个关键特性：require 的返回值行为与表达式求值能力。

? require 不是函数，但可以“返回值”

严格来说，require 是 PHP 的语言构造（language construct），和 echo、isset 类似，并非函数，因此括号不是必需的——require 'file.php'; 和 require('file.php'); 完全等价。但此处使用括号，是为了将整个 require 表达式作为可求值的右值（r-value），从而支持后续方法调用。

关键前提在于：被 require 的文件（这里是 bootstrap.php）必须以 return 语句结尾，并返回一个对象。例如，典型的 bootstrap.php 可能如下：

// config/bootstrap.php
addRoutingMiddleware();
$app->addErrorMiddleware(true, true, true);

// ✅ 必须返回 $app 实例，才能支持 ->run()
return $app; // ← 这一行至关重要

正是因为 bootstrap.php 最终 return $app;，require ... 表达式才实际返回该 Slim 应用实例，进而可直接调用其 run() 方法。

⚠️ 注意事项

若 bootstrap.php 没有 return 语句，require 表达式的值为 null，调用 ->run() 将触发 Fatal error: Uncaught Error: Call to a member function run() on null。
require 与 include 的核心区别在于错误处理：require 在文件不存在或解析失败时抛出 E_COMPILE_ERROR 并中止脚本；include 则仅发出警告并继续执行。
不要混淆 require_once —— 它虽保证文件只加载一次，但同样支持返回值，前提是目标文件含 return。