PHP 中 require 语句后直接调用返回对象方法的语法解析

本文详解 php 中 `require` 语言构造后紧跟 `->run()` 的写法原理，说明其本质是利用 `require` 可返回值的特性，实现“引入即执行”的链式调用，常见于 slim 4 等现代框架启动流程。

在 Slim 4 应用中，你常会看到这样一行简洁的启动代码：

run();

这行代码看似“反直觉”，实则体现了 PHP 一个关键但易被忽略的特性：require（以及 include）不是函数，而是语言构造（language construct），但它支持返回值——前提是被引入的文件以 return 语句显式返回一个值。

它是如何工作的？

1. require 加载并执行 bootstrap.php
   PHP 解析器读取该行时，首先执行 require __DIR__ . '/../config/bootstrap.php'。此操作会：

   • 定位并包含该文件；
   • 完全执行其中的 PHP 代码（如依赖注入、容器配置、路由注册等）；
   • 若 bootstrap.php 末尾为 return $app;（例如返回一个 Slim\App 实例），则整个 require 表达式求值为该返回值（即 $app 对象）。

2. 链式调用 ->run()
   因此，(require ...) 的结果是一个对象，可立即调用其 run() 方法——这等价于：

   $app = require __DIR__ . '/../config/bootstrap.php';
   $app->run();

   只是更紧凑、无临时变量。

注意事项与最佳实践

• ✅ require 不是函数，括号非必需但合法
  require 'file.php'; 和 require('file.php'); 完全等效。此处加括号是为了明确表达“将 require 的返回值作为整体参与后续调用”，提升可读性与运算优先级控制。

• ⚠️ 必须确保 bootstrap.php 有 return 语句
  若遗漏 return，require 表达式返回 null，调用 ->run() 将触发 Fatal error: Uncaught Error: Call to a member function run() on null。典型正确的 bootstrap.php 结尾应类似：

  // ... 其他初始化代码
  return $app; // ← 关键：必须返回 Slim\App 实例

• ? include 同理，但 require_once/include_once 也适用
  只要被引入文件以 return 结尾，所有四类包含构造均可用于此类链式调用，但 require 更常用，因其在文件缺失时抛出 E_COMPILE_ERROR，符合生产环境对引导文件完整性的强依赖。

总结

这种写法是 Slim 4 官方推荐的“极简入口模式”，它将应用初始化与运行解耦到 bootstrap.php 中，主入口仅保留一行语义清晰的执行指令。理解其底层机制——require 的返回值行为——不仅能读懂框架代码，还能在自定义微服务或 CLI 工具中复用该模式，写出更简洁、更具表达力的 PHP 启动逻辑。