Twig自定义过滤器需三步闭环：定义逻辑、注册为TwigFilter、交由Symfony容器管理；须继承AbstractExtension，用TwigFilter包装方法，处理空值等边界情况，并注意Twig/Symfony版本差异。
Twig自定义过滤器不是写个函数就行，关键在三步闭环：定义逻辑、注册为Twig过滤器、让Symfony容器识别它。缺一不可，否则模板里调用会报错“Unknown filter”。
写一个干净的扩展类
继承 AbstractExtension，避免手动实现接口细节。过滤器逻辑写成普通方法，参数和返回值类型明确：
- 用 TwigFilter 类包装，第一个参数是模板中用的名字（如
|truncate），第二个参数是回调，格式为[$this, 'methodName'] - 方法本身要处理边界情况，比如空字符串、非字符串输入——Twig不会自动类型转换
- 示例：截断过滤器支持长度和后缀
public function getFilters(): array<br>{<br> return [<br> new TwigFilter('truncate', [$this, 'truncateText']),<br> ];<br>}<br><br>public function truncateText(string $text, int $length = 100, string $suffix = '…'): string<br>{<br> if (strlen($text) <= $length) {<br> return $text;<br> }<br> return substr($text, 0, $length) . $suffix;<br>}
服务配置必须打上 twig.extension 标签
Symfony靠这个标签发现并加载你的扩展。不加就等于没注册，模板里永远找不到这个过滤器：
- 在
config/services.yaml中声明服务，并添加tags: [{ name: 'twig.extension' }] - 类名路径要准确，比如
App\Twig\TextExtension对应文件src/Twig/TextExtension.php - 不需要手动调用
$twig->addFilter()，那是纯Twig环境的做法，Symfony里交给容器
注意版本兼容细节
不同Twig/Symfony版本写法略有差异，容易踩坑：
- Twig ≥ 3.0 用
TwigFilter，不再支持旧版Twig_SimpleFilter - Symfony ≥ 5.3 可用
#[AsTwigFilter]注解替代getFilters()，但需同时启用 attribute autowiring -
getName()方法在 Twig ≥ 1.26 已废弃，新项目不必写；若维护老项目且用 Twig 1.x，则必须提供唯一名称
调试小技巧
过滤器不生效？先确认这几件事：
- 运行
php bin/console debug:twig，看输出里有没有你的过滤器名 - 检查服务是否被正确加载：
php bin/console debug:container --tag=twig.extension - 模板中拼写一致，比如定义的是
'price_format'，就不能写成|priceFormat或|price_formatting
