Symfony 4应用中Messenger场景下locale无故变更致日期显示异常
问题背景
- 基于Symfony 4开发的应用,通过dompdf生成PDF文件
- Twig模板中使用Twig扩展提供的
localizeddate过滤器渲染日期,预期输出法语本地化格式,对应模板代码:
<div> Date : <span>{{ myCustomDate | localizeddate('long', 'none') }}</span> </div>
- 同一套模板被两类场景调用:
- 浏览器直接发起的常规Web请求流程
- 通过Symfony Messenger组件调度的异步处理流程
异常现象
- 常规Web请求流程生成的PDF中,日期可正常输出法语格式:
Date : 12 décembre 2020
- Messenger异步流程生成的PDF中,日期输出为英语格式:
Date : December 12, 2020
问题成因
localizeddate 过滤器依赖运行环境的全局locale设置渲染本地化内容:
- 常规Web请求场景下,Symfony会在请求生命周期内,根据路由配置、请求参数、配置文件的默认设置自动完成locale初始化,因此能正确匹配到法语locale
- Messenger的异步Worker是独立于Web请求生命周期的常驻进程,启动时不会自动加载Web请求的上下文,默认继承操作系统全局的基础locale配置(通常为en_US这类英语格式),因此渲染日期时会输出英语格式
解决方法
- 方案1:在Messenger的消息处理逻辑中,渲染Twig模板前手动设置对应locale,确保运行环境的本地化配置和Web请求场景保持一致:
// 渲染PDF、调用Twig前执行 \Locale::setDefault('fr_FR'); setlocale(LC_ALL, 'fr_FR.UTF-8'); - 方案2:如果多个异步任务都需要统一的法语locale配置,可以直接在Messenger Worker的启动脚本中全局设置默认locale,避免每个处理方法重复写初始化逻辑
- 注意事项:需要同时设置intl扩展对应的
\Locale值和PHP系统层的setlocale值,缺漏任意一项都可能导致本地化渲染异常
内容的提问来源于stack exchange,提问作者darckcrystale
相关产品推荐
相关产品推荐

