Laminas+PHPUnit测试报错：无法创建Session ConfigInterface服务

数据老陈

2026-7-12

解决Laminas单元测试中"Headers already sent"的Session报错问题

问题原因

PHPUnit运行时可能提前输出内容（如测试启动信息、警告），导致HTTP头部已发送，而Laminas的Session组件初始化时需要通过ini_set()修改session相关配置，此时就会触发报错。

解决方案

方案1：覆盖Session配置，避免修改需头部未发送的INI选项

在测试类的setUp()方法中，添加Session配置覆盖，跳过会触发ini_set()的选项：

protected function setUp(): void
{
    $configOverrides = [
        'session_config' => [
            'use_cookies' => false,
            'cache_limiter' => '',
            'use_only_cookies' => false,
        ],
    ];
    $this->setApplicationConfig(ArrayUtils::merge(
        include 'config/application.config.php',
        $configOverrides
    ));
    parent::setUp();
}

方案2：在phpunit.xml中提前设置PHP INI选项

编辑项目根目录的phpunit.xml（或phpunit.xml.dist），在<php>节点下添加以下配置，提前设置session相关选项并开启输出缓冲：

<php>
    <ini name="session.cache_limiter" value="" />
    <ini name="output_buffering" value="On" />
</php>

方案3：禁用Session组件（测试无需Session时）

如果你的测试用例不需要Session功能，可以直接从模块列表中移除Laminas Session模块：

protected function setUp(): void
{
    $originalModules = include 'config/application.config.php';
    $configOverrides = [
        'modules' => array_filter($originalModules['modules'], function($module) {
            return $module !== 'Laminas\Session';
        }),
    ];
    $this->setApplicationConfig(ArrayUtils::merge($originalModules, $configOverrides));
    parent::setUp();
}