Laravel 5+ .env環(huán)境配置文件詳解

在我們開發(fā)的時候，有時候我們希望不同的環(huán)境中有不同的配置參數(shù)，舉例來說，你希望生產(chǎn)環(huán)境使用的緩存機(jī)制與本地環(huán)境不同。

要實(shí)現(xiàn)這個目的，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}"

可以看到，文件中列出了很多配置，包含了緩存，數(shù)據(jù)庫，開發(fā)環(huán)境，隊(duì)列等等。

因此，.env文件不應(yīng)該被加入到版本控制中，也就是說每一個開發(fā)環(huán)境下的.env文件都是獨(dú)立的。我們可以根據(jù)我們開發(fā)環(huán)境的不同，配置出不同的.env文件，從而實(shí)現(xiàn)不同的開發(fā)環(huán)境擁有不同的配置參數(shù)。

那么基本概念已經(jīng)介紹完了，接下來我們來分解一下.env文件中比較常用的幾個配置參數(shù)。

首先看到

APP_NAME=Laravel      

APP_ENV=local      

APP_KEY=base64:qDt/OQzs9YbNTyfHC4xgG+YY87+LcxDkPrB2RW1NxyI=      

APP_DEBUG=true      

APP_URL=http://localhost

其中APP_NAME是我們的項(xiàng)目名稱，這里我們可以根據(jù)需要自行修改。

注意：如果你輸入的字符串中含有空格，請將你的字符串放在""中，例如APP_NAME="Eagle Luo"

APP_ENV是我們的開發(fā)環(huán)境，在生產(chǎn)環(huán)境下，我們可以將其改為production。

APP_KEY是Laravel生成的一個32位的字符串，用于加密session等數(shù)據(jù)。

這個鑰匙很重要，引用官方文檔的話來說，

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

如果我們使用了compoer安裝Laravel，那么這個秘鑰會自動幫我們生成，否則我們需要運(yùn)行

$ php artisan key:generate

來生成這個秘鑰。

APP_DEBUG是我們是否打開DEBUG信息的開關(guān)，設(shè)置為true的時候，代碼出現(xiàn)錯誤將會顯示相應(yīng)的Stack trace，而如果設(shè)置為false將隱藏錯誤信息。

APP_URL則是我們的項(xiàng)目地址。

好了，再來我們看到

DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=

DB_USERNAME=

DB_PASSWORD=

DB_CONNECTION指的是我們的數(shù)據(jù)庫連接種類，這個值在config/database.php中connections數(shù)組中被定義：

  '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' => '',   
    ],   
  ],

我們可以根據(jù)需要修改這個數(shù)組，例如數(shù)據(jù)庫的charset，collation等信息。

DB_HOST和DB_PORT就不用多說，分別指代了數(shù)據(jù)庫連接的ip和端口號。

DB_DATABASE指的是我們連接上數(shù)據(jù)庫后默認(rèn)使用的數(shù)據(jù)庫名稱。

DB_USERNAME和DB_PASSWORD指的自然是我們連接數(shù)據(jù)庫所使用的用戶名和密碼。

在Homestead開發(fā)環(huán)境下，默認(rèn)的MySQL用戶名為homestead，密碼為secret。

好了，本文主要講解了Laravel 5+ .env環(huán)境配置文件的各項(xiàng)含義與使用方法，更多源于Laravel框架的使用技巧請查看下面的相關(guān)鏈接