Laravel .env 多环境配置文件的使用

Posted 2020-09-22

项目开发中，通常会有本地开发环境、内网测试环境、线上真实环境。这三种环境的配置通常都不尽相同，Laravel 可以通过环境变量  APP_ENV 的值来加载不同的 .env 配置文件。下面会介绍两种方法，分别是通过 nginx 和 php-FPM 来设置 APP_ENV 环境变量的值。

方法一：修改 Nginx 配置文件设置 APP_ENV：

location = /index.php {
  index index.php;
  try_files $uri =404;
  fastcgi_pass unix__tmp_php_cgi_sock;
  include fastcgi_params;
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  fastcgi_param SCRIPT_NAME $fastcgi_script_name;
  fastcgi_param APP_ENV xxxx;
}

方法二：修改 PHP-FPM 配置文件设置 APP_ENV：

env[APP_ENV] = xxxx

上述两种方法只需二选一。重启 Nginx 和 PHP-FPM 服务，Laravel 框架就会自动选择加载项目根目录下的 .env.xxxx 配置文件，而不会去加载 .env 配置文件了。

通过 APP_ENV 环境变量值加载特定 .env 配置文件的 Laravel 源代码位于文件Illuminate/Foundation/Bootstrap/DetectEnvironment.php 中，摘录关键代码如下：

 1 /**
 2  * Detect if a custom environment file matching the APP_ENV exists.
 3  *
 4  * @param  \Illuminate\Contracts\Foundation\Application  $app
 5  * @return void
 6  */
 7 protected function checkForSpecificEnvironmentFile($app)
 8 {
 9     if (! env(‘APP_ENV‘)) {
10         return;
11     }
12 
13     $file = $app->environmentFile().‘.‘.env(‘APP_ENV‘);
14 
15     if (file_exists($app->environmentPath().‘/‘.$file)) {
16         $app->loadEnvironmentFrom($file);
17     }
18 }

请注意：

当设置了 APP_ENV 环境变量时，当运行 Laravel 的 Aritsan 终端命令之前，比如迁移命令（./artisan migrate）、启动队列侦听器（./artisan queue:listen）等等，均需要在终端也导入 APP_ENV 环境变量。

$ export APP_ENV=xxxx

$ ./artisan migrate

或者

$ APP_ENV=xxxx ./artisan migrate

当然，也可以选择在 ~/.bash_profile 或者 ~/.bashrc 中一劳永逸地设定好终端环境变量 APP_ENV 的值。