php app env,Laravel .env 多环境配置文件的使用-CSDN博客

在项目开发中，Laravel通过APP_ENV环境变量来切换本地、内网测试和线上环境的配置。可以修改Nginx或PHP-FPM配置文件设置APP_ENV值，然后重启服务。当APP_ENV设置后，Laravel会加载对应.env配置文件。执行Artisan命令时，终端也需要设置此环境变量。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

项目开发中，通常会有本地开发环境、内网测试环境、线上真实环境。这三种环境的配置通常都不尽相同，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 $app5 * @return void6 */

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 的值。