Pimcore 6.6中Codeception单元测试报错：未定义PIMCORE_PROJECT_ROOT

• 使用Pimcore 6.6版本结合Codeception执行单元测试，已完成Codeception安装并创建tests目录
• 调用PdfImportService时触发错误：[PHPUnit\Framework\Exception] Use of undefined constant PIMCORE_PROJECT_ROOT - assumed ‘PIMCORE_PROJECT_ROOT’，报错位置在src/GenericBundle/Service/PdfImportService.php第31行
• 测试代码直接实例化服务类，导致部分服务出现容器为null的问题；后端实际功能可正常运行，但测试卡壳3天无法解决

1. 修复PIMCORE_PROJECT_ROOT未定义问题 #

单元测试环境默认不会加载Pimcore的核心初始化逻辑，需要在bootstrap脚本中手动引入：
编辑tests目录下的bootstrap.php，添加以下代码：

<?php
// 加载Composer自动加载器
require_once __DIR__ . '/../vendor/autoload.php';
// 引入Pimcore启动文件
require_once __DIR__ . '/../pimcore/config/startup.php';

// 确保PIMCORE_PROJECT_ROOT常量已定义
defined('PIMCORE_PROJECT_ROOT') || define('PIMCORE_PROJECT_ROOT', realpath(__DIR__ . '/../'));

// 初始化Pimcore应用
\Pimcore\Bootstrap::setProjectRoot();
\Pimcore\Bootstrap::bootstrap();

2. 通过容器获取服务实例，避免直接new #

直接实例化服务类会导致依赖（如Symfony容器）无法自动注入，必须从Pimcore的容器中获取服务：
修改PdfImportServiceTest.php代码如下：

<?php
use Codeception\Test\Unit;
use YourNamespace\GenericBundle\Service\PdfImportService;

class PdfImportServiceTest extends Unit
{
    protected $pdfService;

    protected function _before()
    {
        // 从Pimcore容器中获取服务实例
        $container = \Pimcore::getContainer();
        $this->pdfService = $container->get(PdfImportService::class);
    }

    public function testGetFilesArray()
    {
        $this->assertFalse($this->pdfService->getFilesArray());
    }
}

注意替换YourNamespace为你实际的命名空间。

3. 检查Codeception配置，确保Symfony模块正确加载 #

打开codeception.yml或codeception.dist.yml，确认Symfony模块配置正确：

actor: Tester
paths:
    tests: tests
    output: tests/_output
    data: tests/_data
    support: tests/_support
bootstrap: _bootstrap.php
modules:
    enabled:
        - Symfony
    config:
        Symfony:
            app_path: src
            kernel_class: AppKernel # 对应项目的Kernel类
            environment: test
            debug: true

4. 配置测试环境的Pimcore参数 #

• 复制app/config/config.yml到app/config/config_test.yml，按需调整测试环境的配置（比如使用独立的测试数据库）
• 确保app/config/parameters_test.yml存在，配置测试环境的数据库连接、文件路径等参数

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