docs(deploy): 补充多环境 .env 管理约定

各环境配置文件(.env.test/.env.prod/.env.demo)放在仓库根目录,
部署时流水线将目标文件覆盖为 .env,代码完全一样只有 .env 不同
This commit is contained in:
augushong
2026-07-23 22:22:52 +08:00
parent 4ebcea0669
commit 8dce4ab48a

View File

@@ -41,3 +41,13 @@
2. **非默认端口**——如果修改了框架模板的默认端口(如 HTTP 8000、MySQL 13306、Redis 16379 等),必须记录实际端口。否则智能体调试时(如 `tools:http:call`)会用默认端口连接,导致失败。
目的是让后续会话中的智能体能从规则文件快速了解项目的实际运行方式、命令执行入口和访问地址,而不需要重新询问或猜测。
## 多环境 .env 管理
ThinkPHP 通过仓库根目录的 `.env` 文件读取环境配置(数据库连接、调试开关等)。多环境(测试 / 演示 / 正式等)的做法是:
- 各环境的配置文件都放在仓库根目录,命名为 `.env.<环境>`(如 `.env.test``.env.prod``.env.demo`
- `.env` 是当前生效的文件,不提交到 git已在 `.gitignore` 中排除)
- 部署时通过流水线CI/CD将目标环境的文件覆盖为 `.env`,例如 `cp .env.prod .env`
代码完全一样,只有 `.env` 不同。