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
相关产品推荐
相关产品推荐

