Laravel 5+ .env环境配置文件详解

在我们开发的时候，有时候我们希望不同的环境中有不同的配置参数，举例来说，你希望生产环境使用的缓存机制与本地环境不同。

要实现这个目的，laravel使用了dotenv这个php库。在laraval的安装根目录下，我们会看到一个名为.env.example的文件，我们需要手动将其命名为.env（或拷贝一个副本并将其命名为.env）。

打开.env文件，可以看到一系列配置信息：

app_name=laravel        

app_env=local        

app_key=base64:qdt/oqzs9ybntyfhc4xgg+yy87+lcxdkprb2rw1nxyi=        

app_debug=true        

app_url=http://localhost        

   

log_channel=stack        

   

db_connection=mysql        

db_host=127.0.0.1        

db_port=3306        

db_database=      

db_username=        

db_password=        

   

broadcast_driver=log        

cache_driver=file        

session_driver=file        

session_lifetime=120        

queue_driver=sync        

   

redis_host=127.0.0.1        

redis_password=null        

redis_port=6379        

   

mail_driver=smtp        

mail_host=smtp.mailtrap.io        

mail_port=2525        

mail_username=null        

mail_password=null        

mail_encryption=null        

   

pusher_app_id=        

pusher_app_key=        

pusher_app_secret=        

pusher_app_cluster=mt1        

   

mix_pusher_app_key="${pusher_app_key}"        

mix_pusher_app_cluster="${pusher_app_cluster}"

可以看到，文件中列出了很多配置，包含了缓存，数据库，开发环境，队列等等。

因此，.env文件不应该被加入到版本控制中，也就是说每一个开发环境下的.env文件都是独立的。我们可以根据我们开发环境的不同，配置出不同的.env文件，从而实现不同的开发环境拥有不同的配置参数。

那么基本概念已经介绍完了，接下来我们来分解一下.env文件中比较常用的几个配置参数。

首先看到

app_name=laravel      

app_env=local      

app_key=base64:qdt/oqzs9ybntyfhc4xgg+yy87+lcxdkprb2rw1nxyi=      

app_debug=true      

app_url=http://localhost

其中app_name是我们的项目名称，这里我们可以根据需要自行修改。

注意：如果你输入的字符串中含有空格，请将你的字符串放在""中，例如app_name="eagle luo"

app_env是我们的开发环境，在生产环境下，我们可以将其改为production。

app_key是laravel生成的一个32位的字符串，用于加密session等数据。

这个钥匙很重要，引用官方文档的话来说，

if the application key is not set, your user sessions and other encrypted data will not be secure!

如果我们使用了compoer安装laravel，那么这个秘钥会自动帮我们生成，否则我们需要运行

$ php artisan key:generate

来生成这个秘钥。

app_debug是我们是否打开debug信息的开关，设置为true的时候，代码出现错误将会显示相应的stack trace，而如果设置为false将隐藏错误信息。

app_url则是我们的项目地址。

好了，再来我们看到

db_connection=mysql

db_host=127.0.0.1

db_port=3306

db_database=

db_username=

db_password=

db_connection指的是我们的数据库连接种类，这个值在config/database.php中connections数组中被定义：

  'connections' => [   
  
    'sqlite' => [   
      'driver' => 'sqlite',   
      'database' => env('db_database', database_path('database.sqlite')),   
      'prefix' => '',   
    ],   
  
    'mysql' => [   
      'driver' => 'mysql',   
      'host' => env('db_host', '127.0.0.1'),   
      'port' => env('db_port', '3306'),   
      'database' => env('db_database', 'forge'),   
      'username' => env('db_username', 'forge'),   
      'password' => env('db_password', ''),   
      'unix_socket' => env('db_socket', ''),   
      'charset' => 'utf8mb4',   
      'collation' => 'utf8mb4_unicode_ci',   
      'prefix' => '',   
      'strict' => true,   
      'engine' => null,   
    ],   
  
    'pgsql' => [   
      'driver' => 'pgsql',   
      'host' => env('db_host', '127.0.0.1'),   
      'port' => env('db_port', '5432'),   
      'database' => env('db_database', 'forge'),   
      'username' => env('db_username', 'forge'),   
      'password' => env('db_password', ''),   
      'charset' => 'utf8',   
      'prefix' => '',   
      'schema' => 'public',   
      'sslmode' => 'prefer',   
    ],   
  
    'sqlsrv' => [   
      'driver' => 'sqlsrv',   
      'host' => env('db_host', 'localhost'),   
      'port' => env('db_port', '1433'),   
      'database' => env('db_database', 'forge'),   
      'username' => env('db_username', 'forge'),   
      'password' => env('db_password', ''),   
      'charset' => 'utf8',   
      'prefix' => '',   
    ],   
  ],

我们可以根据需要修改这个数组，例如数据库的charset，collation等信息。

db_host和db_port就不用多说，分别指代了数据库连接的ip和端口号。

db_database指的是我们连接上数据库后默认使用的数据库名称。

db_username和db_password指的自然是我们连接数据库所使用的用户名和密码。

在homestead开发环境下，默认的mysql用户名为homestead，密码为secret。

好了，本文主要讲解了laravel 5+ .env环境配置文件的各项含义与使用方法，更多源于laravel框架的使用技巧请查看下面的相关链接