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'),'forge'),'username' => env('DB_USERNAME','password' => env('DB_PASSWORD',''),'unix_socket' => env('DB_SOCKET','charset' => 'utf8mb4','collation' => 'utf8mb4_unicode_ci','strict' => true,'engine' => null,'pgsql' => [ 'driver' => 'pgsql','5432'),'charset' => 'utf8','schema' => 'public','sslmode' => 'prefer','sqlsrv' => [ 'driver' => 'sqlsrv','localhost'),'1433'),
我們可以根據需要修改這個陣列,例如資料庫的charset,collation等資訊。
DB_HOST和DB_PORT就不用多說,分別指代了資料庫連線的ip和埠號。
DB_DATABASE指的是我們連線上資料庫後預設使用的資料庫名稱。
DB_USERNAME和DB_PASSWORD指的自然是我們連線資料庫所使用的使用者名稱和密碼。
在Homestead開發環境下,預設的MySQL使用者名稱為homestead,密碼為secret。
好了,本文主要講解了Laravel 5+ .env環境配置檔案的各項含義與使用方法,更多源於Laravel框架的使用技巧請檢視下面的相關連結