Symfony 4中如何让PHPUnit直接使用.env配置，避免提交凭据到VCS？

完全理解你的顾虑——把敏感凭据塞进会提交到VCS的phpunit.xml.dist确实不太合理，而且违背了Symfony关于.env文件的最佳实践。其实有个更优雅的方案，能让PHPUnit直接复用.env系列文件的配置，不需要硬编码敏感信息。

核心思路：让PHPUnit自动加载Dotenv配置 #

Symfony的Dotenv组件本来就支持按环境加载配置，我们只需要确保测试环境能正确读取这些配置文件，而不是依赖phpunit.xml.dist里的<env>标签。具体步骤如下：

1. 清理phpunit.xml.dist的敏感配置
   打开你的phpunit.xml.dist，移除所有包含敏感信息的<env>标签（比如DATABASE_URL），只保留必要的环境标识：

   <php>
       <env name="APP_ENV" value="test" />
       <!-- 移除其他敏感的<env>标签 -->
   </php>
   

   这里的APP_ENV=test是安全的，可以提交到VCS，它只是告诉Symfony当前运行在测试环境。

2. 确保测试入口加载Dotenv
   检查tests/bootstrap.php文件，确保它已经加载了Symfony的Dotenv组件。Symfony 4的默认bootstrap文件通常已经包含了这段逻辑，如果没有的话，手动添加：

   use Symfony\Component\Dotenv\Dotenv;
   
   require dirname(__DIR__).'/vendor/autoload.php';
   
   if (file_exists(dirname(__DIR__).'/config/bootstrap.php')) {
       require dirname(__DIR__).'/config/bootstrap.php';
   } elseif (method_exists(Dotenv::class, 'bootEnv')) {
       (new Dotenv())->bootEnv(dirname(__DIR__).'/.env');
   }
   

   这段代码会自动加载项目根目录的.env文件，并且根据APP_ENV的值加载对应的环境配置文件（比如APP_ENV=test时会优先加载.env.test）。

3. 创建测试专用的.env.test文件
   在项目根目录创建.env.test文件，专门存放测试环境的配置，比如：

   # .env.test
   APP_ENV=test
   DATABASE_URL=mysql://test_user:test_pass@127.0.0.1:3306/myapp_test
   # 其他测试环境需要的配置
   

   然后把.env.test添加到.gitignore里，这样它就不会被提交到VCS，完美隔离敏感信息。

4. （可选）本地测试的个性化配置
   如果需要在本地覆盖测试配置（比如用不同的数据库端口），可以创建.env.test.local文件，同样加入.gitignore。Symfony的Dotenv会按以下优先级加载配置：
   .env.local > .env.test.local > .env.test > .env
   这样你本地的测试配置不会影响团队其他成员。

为什么这个方案更合理？ #

• 完全遵循Symfony的配置最佳实践，敏感信息都放在不提交到VCS的.env系列文件里；
• 不需要在shell里手动设置环境变量，也不用把配置放到项目外部；
• 测试环境的配置管理和开发、生产环境保持一致，维护成本更低；
• 不仅解决数据库凭据的问题，其他需要配置的环境变量也能统一处理。

这样调整后，PHPUnit就会自动读取测试环境的.env配置，再也不用把敏感信息塞进phpunit.xml.dist里了。

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