Twig函数是模板中执行逻辑的核心工具，由扩展注册、容器管理；内置函数如path()、asset()开箱即用；自定义函数需继承AbstractExtension并返回TwigFunction实例；覆盖系统函数应通过服务替换而非删除；调用时须显式传参且注意性能。
Twig 函数是模板中执行逻辑操作、生成内容或调用服务的核心工具，不是 PHP 函数的直接映射，而是由 Twig 扩展注册并受 Symfony 容器管理的可复用功能。用对的关键在于理解“谁提供、怎么注册、怎么调用、怎么定制”四个环节。
内置函数：开箱即用，无需配置
Symfony 默认注入了大量 Twig 函数，比如 path()、url()、form_start()、asset()、include() 等。它们在模板里直接使用：
-
{{ path('app_home') }}→ 生成路由app_home对应的 URL -
{{ asset('images/logo.png') }}→ 输出带版本号的静态资源路径，如/build/logo.a1b2c3.png -
{{ include('_partial/menu.html.twig') }}→ 嵌入子模板（支持传参，如with {'items': menuItems}）
自定义函数：通过 Twig 扩展添加
要添加自己的函数（例如 money_format() 或 truncate_text()），需创建一个 Twig 扩展类：
- 继承
Twig\Extension\AbstractExtension - 在
getFunctions()中返回TwigFunction实例数组 - 函数回调可以是普通方法，也可注入 Symfony 服务（如
EntityManagerInterface）
示例：new TwigFunction('format_currency', [$this, 'doFormat'], ['is_safe' => ['html']])
其中 doFormat() 是类中定义的方法，is_safe 表示返回值已转义，可直接输出 HTML。
覆盖系统函数：替换 path() 等核心行为
不建议删除原函数，而是通过服务替换实现覆盖。常见做法是重写 RoutingExtension：
- 新建类继承
Symfony\Bridge\Twig\Extension\RoutingExtension - 重写
getPath()方法，加入多语言前缀、租户域名、缓存逻辑等 - 在
services.yaml中指定该类为路由扩展：twig.extension.routing.class: App\Twig\CustomRoutingExtension
这样所有模板中的 {{ path(...) }} 就会自动走你的逻辑，无需改模板代码。
函数调用注意事项
Twig 函数不支持默认参数或可变参数列表（...），所有参数都需显式传递；函数名区分大小写；若函数依赖数据库或外部 API，注意它在模板渲染时才执行——高频页面需加缓存层，避免 N+1 查询。
