Mezzio结合Swoole/OpenSwoole时全局常量无法在中间件中访问的问题排查

你遇到的Undefined constant "APPROOT"错误，核心原因确实和Swoole的进程模型以及常量定义的时机有关，具体来说有这几个关键点：

1. Swoole进程模型的特性 #

当用Mezzio结合Swoole运行时，应用会分为Master进程和Worker进程：

• Master进程负责管理Worker进程，实际处理请求的是Worker进程。
• 如果你的APPROOT常量是在Master进程的初始化阶段定义的，理论上Worker进程会通过fork继承这个常量，但如果开启了Swoole的热重载功能，Worker进程重启时并不会重新执行入口脚本的完整初始化流程（比如你那个自执行的匿名函数），就会导致常量丢失。

2. 匿名函数的潜在影响 #

虽然define()默认定义的是全局常量，但你的常量定义包裹在自执行匿名函数中：

(function () {
    if (!defined('APPROOT')) {
        define('APPROOT', __DIR__);
    }
    // ... 其他代码
})();

如果Worker进程重启时，这个匿名函数没有被重新执行（比如热重载仅重新加载业务代码，而非入口脚本的初始化逻辑），就不会触发常量定义的逻辑，自然找不到APPROOT。

解决方案 #

方案一：抽离常量定义到独立文件 #

把常量定义从匿名函数中抽出来，放在一个单独的文件里，确保任何进程启动/重启时都会加载它：

1. 创建constants.php文件放在项目根目录：

<?php
// constants.php
if (!defined('APPROOT')) {
    define('APPROOT', __DIR__);
}

2. 在index.php的最顶部引入这个文件（在自执行匿名函数外面）：

require __DIR__ . '/constants.php';

(function () {
    /** @var \Psr\Container\ContainerInterface $container */
    $container = require 'config/container.php';
    // ... 剩下的原有代码
})();

这样不管是Master进程启动，还是Worker进程热重载重启，都会先加载constants.php，确保APPROOT常量被定义。

方案二：使用依赖注入替代全局常量（推荐） #

全局常量不符合Mezzio基于PSR-11依赖注入的设计理念，更优雅的方式是把APPROOT作为容器参数注入到中间件中：

1. 在config/container.php中添加容器参数：

// 假设config目录在项目根目录下，所以用__DIR__ . '/..'指向APPROOT
$container->set('app.root', __DIR__ . '/..');

2. 修改中间件的构造函数，注入这个参数：

<?php
declare(strict_types=1);

namespace Application\Middleware;

use Psr\Http\Message\ResponseFactoryInterface;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\MiddlewareInterface;
use Psr\Http\Server\RequestHandlerInterface;

class BootstrapMiddleware implements MiddlewareInterface
{
    // 新增appRoot参数
    public function __construct(
        private ResponseFactoryInterface $responseFactory,
        private string $appRoot
    ) {
    }

    public function process(
        ServerRequestInterface $request,
        RequestHandlerInterface $handler
    ): ResponseInterface {
        $this->setAssetsCompiledLoc();
        $response = $handler->handle($request);
        return $response;
    }

    private function setAssetsCompiledLoc()
    {
        if ( ! defined('ASSET_MAP')) {
            // 使用注入的appRoot替代全局常量
            $manifestPath = $this->appRoot . '/manifests/manifest-' . ENV . '.json';
            // ... 原有逻辑
        }
    }
}

3. 在中间件工厂中配置参数注入（比如config/autoload/middleware-factories.php）：

return [
    Application\Middleware\BootstrapMiddleware::class => function (\Psr\Container\ContainerInterface $container) {
        return new Application\Middleware\BootstrapMiddleware(
            $container->get(ResponseFactoryInterface::class),
            $container->get('app.root')
        );
    },
];

这种方式完全避免了全局变量的问题，也让代码的依赖关系更清晰，符合现代PHP框架的最佳实践。

内容的提问来源于stack exchange，提问作者Dannyboy