Symfony2.3升级至3.4：.env与.env.dist关系及自动更新疑问

嘿，我来帮你理清这个升级中的困惑！首先你说得没错：.env.dist 和 .env 的角色确实和 Symfony 2 里的 parameters.yml.dist、parameters.yml 完全对应——前者是提交到版本库的模板/默认配置，后者是本地专属的敏感配置文件（不提交）。但在 composer update 时的交互机制上，Symfony 3.4 确实有不小的变化，具体如下：

核心机制变化：从参数文件到环境变量 #

Symfony 2 依赖 SensioDistributionBundle 提供的 incenteev-parameters 脚本，在执行 composer update 时会自动触发交互：检测 parameters.yml 是否存在、是否和 parameters.yml.dist 有差异，然后询问你是否用 dist 文件的默认值更新本地文件。

而 Symfony 3.4 引入了 Dotenv 组件，彻底替换了原来的 parameters.yml 机制，对应的交互逻辑也完全变了：

• 执行 composer update 时，默认不会再弹出任何交互提示来更新 .env 文件。因为 Dotenv 的设计思路是：.env 是开发者手动维护的本地配置，不应被 composer 自动覆盖或修改。
• 只有在全新创建 Symfony 3.4 项目时（composer create-project symfony/symfony:3.4.* my-project），composer 会自动复制 .env.dist 为 .env，然后让你手动修改里面的敏感参数（比如数据库信息）；但从 Symfony 2.3 升级过来的项目，这个自动复制不会触发，你需要手动执行复制操作。

如何同步 .env.dist 的更新？ #

如果团队更新了 .env.dist（比如新增了环境变量），你需要手动同步到本地的 .env：

1. 直接对比两个文件，把新增的变量添加到 .env 并设置对应值；
2. 或者先备份本地的 .env，然后复制 .env.dist 为 .env，再重新填入敏感信息（比如数据库密码、API 密钥等）。

另外提一句：Symfony 3.4 中环境变量的优先级是：系统环境变量 > .env.local > .env > .env.dist，所以只要 .env 里设置了值，就会覆盖 .env.dist 的默认值，不用担心冲突。

升级时的额外注意点 #

从 Symfony 2.3 升级到 3.4，你还需要把原来 parameters.yml 里的参数迁移到 .env 中：

• 比如原来的 database_host 要改成 DATABASE_HOST（全大写、下划线分隔的命名规范）；
• 然后在配置文件（比如 config/services.yml、config/packages/doctrine.yml）中用 %env(DATABASE_HOST)% 来引用这些环境变量。

内容的提问来源于stack exchange，提问作者yvoloshin