You need to enable JavaScript to run this app. PHPUnit测试渲染Twig模板遇Kernel访问报错,无法测试自定义SVG嵌入函数
优惠活动
大模型
产品
解决方案
定价
更多

PHPUnit测试渲染Twig模板遇Kernel访问报错,无法测试自定义SVG嵌入函数

报错根因

你当前的测试类继承的是通用PHPUnit\Framework\TestCase,这个基类没有内置$kernel静态属性。你参考的代码片段里的self::$kernel,是Symfony框架提供的WebTestCase基类自带的成员,直接搬用自然会触发未定义属性的错误。

两种可落地的修复方案

方案1:适配Symfony测试生态(最少改动)

这是和你参考的代码逻辑最匹配的写法,改动量最小:

  • 把测试类的父类从PHPUnit\Framework\TestCase替换为Symfony\Bundle\FrameworkBundle\Test\WebTestCase,框架会在测试启动阶段自动初始化符合测试环境配置的应用Kernel,把实例挂载到内置的静态$kernel属性上,原来写的self::$kernel->getContainer()->get('twig')代码就能正常执行。
  • 调整后的测试类基础结构参考:
namespace App\Tests\Templates\Icons;

use App\Twig\IconsExtension;
use DirectoryIterator;
// 移除原有的通用TestCase引入,替换为Symfony的测试基类
use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;

class IconsExtensionTest extends WebTestCase
{
    public function testIconsExtension()
    {
        // 原有文件遍历、后缀校验逻辑完全保留
        $icon_file_names = [];
        foreach (new DirectoryIterator('public/assets/icons/') as $file) {
            if ($file->isDot()) {
                continue;
            }
            $icon_file_names[] = $file->getFilename();
        }

        foreach ($icon_file_names as $icon_file_name) {
            static::assertRegExp('#([a-zA-Z0-9\s_\\.\-\(\):])+(.svg.twig)$#', $icon_file_name);
        }

        // 原来的Twig获取代码现在可以正常运行
        $twig = self::$kernel->getContainer()->get('twig');

        // 后续渲染比对的逻辑正常编写即可
    }
}
  • 注意点:Symfony高版本里推荐用self::getContainer()替代直接从Kernel拿容器的写法,能自动适配测试容器的服务权限,避免私有服务获取失败的问题。

方案2:纯单元测试模式(无框架依赖,执行速度更快)

如果不想绑定Symfony的测试基类,想做完全独立的扩展单元测试,可以手动构造Twig实例,全程不需要接触Kernel:

  • 构造和生产环境配置一致的Twig Loader,注册你代码里用到的@public_path模板命名空间,关闭测试环境的Twig缓存,避免比对结果偏差;
  • 直接把你写的IconsExtension挂载到Twig实例上,手动调用方法做断言,整个测试过程没有任何服务容器、Kernel的依赖,测试执行速度会比框架模式快很多。
  • 核心实现代码参考:
// 在测试方法内手动构造Twig实例
$loader = new \Twig\Loader\FilesystemLoader([
    // 把@public_path别名指向实际的public目录,和你生产环境的Twig配置保持一致
    'public_path' => realpath(__DIR__ . '/../../../../public'),
]);
$twig = new \Twig\Environment($loader, [
    'cache' => false, // 测试环境关闭缓存
    'autoescape' => false, // 你的SVG模板一般不需要自动转义,和生产配置对齐
]);
// 挂载自定义扩展
$twig->addExtension(new IconsExtension());

// 逐图标比对渲染结果
$iconExtension = new IconsExtension();
foreach ($icon_file_names as $icon_file_name) {
    // 从文件名提取图标标识
    $iconBaseName = str_replace('.svg.twig', '', $icon_file_name);
    // 调用自定义函数生成带指定class的SVG输出
    $renderedOutput = $iconExtension->embedSvgIcon(
        $twig,
        $iconBaseName,
        "icon icon-{$iconBaseName}"
    );
    // 直接通过Twig渲染原始模板,拿到预期输出做比对
    $expectedOutput = $twig->render("public_path/assets/icons/{$icon_file_name}", [
        'iconClass' => "icon icon-{$iconBaseName}"
    ]);

    static::assertEquals($expectedOutput, $renderedOutput);
}

常见踩坑提示

  • 如果在方案1中遇到容器拿不到twig服务的报错,检查当前应用的Symfony版本:Symfony 4.2+ 之后的私有容器,需要通过self::getContainer()获取的测试专用容器来访问twig服务,不能直接拿生产环境的全局容器。
  • 测试比对渲染结果时,一定要确保Loader注册的路径别名、自动转义配置、缓存开关和生产环境的Twig配置完全一致,不然会出现测试通过但生产环境渲染不一致的问题。

内容的提问来源于stack exchange,提问作者Ângelo Moura

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.19 03:15:03