必须继承abstractextension、注册为twigfilter、打上twig.extension标签，三者缺一不可；否则模板调用报unknown filter错误。类需置于src/twig/下，getfilters()返回twigfilter实例数组，方法须自行判空防致命错误，且需通过debug:twig和debug:container验证注册状态。
必须继承 AbstractExtension、注册为 TwigFilter、打上 twig.extension 标签，三者缺一不可；否则模板里调用会报 Unknown filter 错误。
过滤器类要继承 AbstractExtension 并实现 getFilters()
不能直接写个独立函数就完事。Symfony 的 Twig 集成依赖容器自动发现扩展类，而 AbstractExtension 提供了标准接口和默认行为，避免手动实现 getName()（已废弃）或处理 Twig 版本兼容逻辑。
- 类必须放在
src/Twig/下（如App\Twig\TextExtension），对应文件路径为src/Twig/TextExtension.php -
getFilters()返回TwigFilter实例数组，每个实例第一个参数是模板中用的名字（如'truncate'），第二个是回调（格式为[$this, 'methodName']） - 方法本身要自己处理边界值：空字符串、
null、非字符串输入都不会被 Twig 自动转换，不判空会导致strlen(null)这类致命错误
示例：
public function getFilters(): array
{
return [
new TwigFilter('truncate', [$this, 'truncateText']),
];
}
public function truncateText($text, int $length = 100, string $suffix = '…'): string
{
if (!is_string($text) || $text === '') {
return '';
}
if (strlen($text)
<h3>服务配置必须显式添加 <code>twig.extension</code> 标签</h3>
<p>Symfony 不会自动把任意类当 Twig 扩展加载。即使类写对了，没打标签就等于没注册——模板里永远找不到这个过滤器。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2491" title="Symfony Linux版"><img
src="https://img.php.cn/upload/zhuanqu/000/000/086/6a5f5ae8906a0613.png" alt="Symfony Linux版" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2491" title="Symfony Linux版" class="overflowclass">Symfony Linux版</a>
<p class="overflowclass">Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2491" title="Symfony Linux版" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
- 在
config/services.yaml中声明服务，并加tags: [{ name: 'twig.extension' }] - 类名路径必须与文件位置完全一致，比如
App\Twig\TextExtension对应src/Twig/TextExtension.php - 不要手动调用
$twig->addFilter()：那是纯 Twig 环境的做法，在 Symfony 里交给容器管理
正确写法：
services:
App\Twig\TextExtension:
tags: [{ name: 'twig.extension' }]
注意 TwigFilter 和版本兼容细节
Twig ≥ 3.0 和 Symfony ≥ 5.3 的写法和老项目差异明显，混用会直接导致服务加载失败或过滤器静默失效。
- Twig ≥ 3.0 必须用
TwigFilter，旧版Twig_SimpleFilter已移除 - Symfony ≥ 5.3 可用
#[AsTwigFilter('truncate')]注解替代getFilters()，但需开启属性自动注入（autowire: true+autoconfigure: true） - 老项目若还在用 Twig 1.x，
getName()方法仍需返回唯一字符串，否则容器无法识别扩展
调试时优先运行两个命令确认注册状态
过滤器不生效，90% 是注册环节断了，而不是逻辑写错了。别急着改 PHP 方法，先验证基础链路。
-
php bin/console debug:twig—— 查输出里有没有你的过滤器名（如truncate），没有说明没进 Twig 环境 -
php bin/console debug:container --tag=twig.extension—— 查服务是否被容器识别并打了标签，没列出来就是services.yaml配置有误或路径不对 - 模板中名字拼写必须一字不差：定义的是
'price_format'，就不能写成|priceFormat或|price_formatting
最容易被忽略的是空值处理和标签缺失——前者让过滤器在生产环境随机崩溃，后者让整个功能完全不可见，且无任何报错提示。
