symfony项目ci/cd需覆盖语法、翻译、迁移、测试四类验证，仅用php bin/console命令不够；须在.gitlab-ci.yml中配置only: [merge_requests, main]触发，执行phpunit、doctrine:migrations:status、逐语言translation:lint，并确保环境变量与数据库配置正确、所有命令加--no-interaction。
Symfony 项目跑 CI/CD 不是加几个 php bin/console 命令就完事，关键在于让每次提交都真正“可交付”——语法合法、翻译完整、迁移就绪、测试通过。漏掉任意一环，问题就会卡在测试环境甚至滚进生产。
怎么配置基础 CI 流水线（以 GitLab CI 为例）
GitLab CI 的核心是 .gitlab-ci.yml，它必须覆盖验证、测试、构建三类动作，且只对有效分支触发：
- 用
only: [merge_requests, main]限制触发范围，避免 feature 分支频繁刷流水线 - 测试阶段必须包含
vendor/bin/phpunit --no-coverage：CI 环境不生成覆盖率报告，能省下 20–40 秒 - 数据库检查不能跳过：
php bin/console doctrine:migrations:status --no-interaction要确保新迁移文件未被遗漏或重复注册 - 翻译校验要按语言逐个执行：
php bin/console translation:lint en --format=json、php bin/console translation:lint fr --format=json，别只跑一个语言就以为全通
为什么 translation:lint 总报错或漏检
常见现象是 YAML 文件缩进错误、键名重复、缺失占位符，但更隐蔽的问题是：CI 环境里没加载全部翻译域（domain），导致 translation:lint 只扫了 messages+en，却漏掉了 validators.fr.yaml。
- 确保
translations/目录下所有语言子目录结构一致（如translations/en/、translations/fr/） - 在 lint 命令中显式指定 domain：
php bin/console translation:lint en --domain=validators --format=json - 如果项目用了自定义 loader（比如从数据库读翻译），
translation:lint会完全失效——它只校验文件系统里的静态文件
如何避免 Doctrine 多库配置在 CI 中崩掉
错误典型表现为 Access denied for user 'myapptest'@'%' to database 'cf_CleanerFuture'，根源不是权限，而是 URL 拼接逻辑被破坏。
- 别在
doctrine.yaml里写url: '%env(resolve:DATABASE_URL)%cf_central'这种拼接式配置 - 改用独立环境变量：为每个库定义完整 URL，例如
DATABASE_URL_CENTRAL=mysql://...，再在配置中引用'%env(resolve:DATABASE_URL_CENTRAL)%' - CI 环境的
.env.test必须显式覆盖所有 DB 变量，不能依赖 fallback 逻辑 - 运行前加一步验证：
php bin/console debug:container --parameter=doctrine.connections，确认连接名和 URL 都解析正确
部署阶段该不该用 Symfony Filesystem 组件
可以，但仅限于轻量同步（如复制 public/ 资源或导出配置），别把它当 rsync 用。
-
$filesystem->mirror()在大项目里容易 OOM，尤其含 node_modules 或 vendor 时；应先rsync -av --delete同步，再用dumpFile()写入 release 版本号 -
mkdir()和remove()可安全用于清理临时目录，但权限设置（如0755）在容器内常被 umask 覆盖，建议用chmod命令兜底 - 若部署目标是远程服务器，优先走 SSH +
rsync或容器镜像推送，Symfony\Filesystem仅作本地构建环节的辅助工具
最易被忽略的一点：所有 console 命令在 CI 中必须加 --no-interaction，否则遇到交互式提示（比如 migration confirm）会直接卡死。这不是警告，是硬性要求。
