Yii框架CI部署需拆解数据库迁移、环境隔离、测试验证和部署策略：迁移须等MySQL就绪（用wait-for-it.sh检测），测试库名动态生成防冲突，生产禁用自动migrate，敏感配置通过CI secrets动态写入且禁用日志输出。
Yii框架的自动化部署不是“配个脚本就能跑”，而是必须把数据库迁移、环境隔离、测试验证和部署策略四件事拆开理清楚。直接套用通用CI模板，90%会卡在php yii migrate报错或测试连不上临时DB上。
为什么php yii migrate在CI里总失败
本地能跑，CI里报SQLSTATE[HY000] [2002] Connection refused，根本原因不是命令写错，是数据库服务没真正就绪就执行了迁移。
- GitLab CI或GitHub Actions中，
services启动MySQL容器是异步的，php yii migrate可能在MySQL端口监听前就运行了 - Yii默认用
localhost连接DB，但CI里MySQL通常跑在mysql这个Docker服务名下，db配置必须动态适配 -
--interactive=0只是关掉确认提示，不解决连接时序问题；得加重试逻辑或健康检查
实操建议：在script里用wait-for-it.sh或循环检测mysqladmin ping -h mysql -u root -proot成功后再执行迁移。
测试环境怎么做到真正的数据库隔离
单元测试可以mock，但功能测试（functional）和集成测试（integration）必须连真实DB——而共享一个测试库会导致并发构建相互干扰、数据污染、迁移冲突。
- 不要复用
test数据库名，每次CI job生成唯一库名，比如test_${CI_JOB_ID} - 在
config/test.php里用getenv('TEST_DB_NAME')动态读取，而不是硬编码'dsn' => 'mysql:host=localhost;dbname=test' - 迁移前先
DROP DATABASE IF EXISTS ${TEST_DB_NAME}; CREATE DATABASE ${TEST_DB_NAME} CHARACTER SET utf8mb4;
否则你会看到两个并行job同时对同一个test库执行migrate/up，一个删表，一个建索引，然后全挂。
部署到生产环境时yii migrate该不该自动执行
不该。生产环境数据库结构变更必须人工审核、备份、分步执行。CI里自动跑php yii migrate上线等于埋雷。
- CI流程里只允许在
test和staging环境自动迁移，且必须带--no-ansi --interactive=0 - 生产部署阶段只做文件同步（rsync）、容器重启（docker-compose up -d）或K8s滚动更新，
migrate命令留白或注释掉 - 如果真要自动迁移，至少拆成两步：
yii migrate/create生成空迁移文件 → 人工补SQL →yii migrate手动触发
很多团队踩坑在于把测试流程和生产流程混在一个yaml里，用if: ${{ github.event_name == 'push' && github.head_ref == 'main' }}这种条件判断，结果误操作推到main就直接改了线上库。
敏感配置怎么安全传进CI又不出现在日志里
Yii项目里的params.php或common/config/main-local.php常含API密钥、DB密码，硬编码进代码库或用env变量明文写死都会泄露。
- GitHub Actions用
secrets，但不能直接注入PHP配置文件；得在CI脚本里用sed或php -r "file_put_contents(...)"动态生成main-local.php - GitLab CI用
variables+masking，但要确认DB_PASSWORD字段在job日志里显示为[MASKED]，否则echo $DB_PASSWORD会暴露 - 绝对不要在CI里
cat config/main-local.php或print_r(Yii::$app->params)——日志默认全量输出，密钥就裸奔了
最易被忽略的一点：本地开发用.env，但Yii原生不读.env，得靠vlucas/phpdotenv扩展+自定义引导逻辑，否则CI里getenv()永远返回false。
