Laravel 5 中的配置

Laravel 的全部的配置文件都放在了 config 這個目錄的下面。每一個選項都有介紹。php

config
├── app.php
├── auth.php
├── cache.php
├── compile.php
├── database.php
├── filesystems.php
├── mail.php
├── queue.php
├── services.php
├── session.php
└── view.php

0 directories, 11 files

安裝以後

命名應用

安裝完 Laravel 之後，你可能想要給應用起個名字。默認狀況下， app 目錄是在 App 這個命名空間下面，Composer 會用 PSR-4-autoloading 標準自動去加載它。你能夠經過 Artisan 的 app:name 命令去修改這個命名空間匹配你的應用的名字。node

好比，你打算把應用命名爲「Movietalk」，在項目的根目錄下執行下面這個命令：緩存

php artisan app:name Movietalk

上面的命令會修改一系列的文件裏的內容。給應用起個名字是可選的，你可使用默認的 App 這個命名空間。我建議先別在意爲命名應用程序，使用默認的 App 就行。服務器

其它配置

Laravel 基本上不須要太多配置。你能夠立刻去開發應用，不過你能夠看一下 config/app.php 這個文件，上面的選項有說明。好比 timezone，locale 這些選項，能夠根據本身所在的地區去配置。session

安裝完 Laravel 之後，你須要配置一下本地的環境。app

注意：在生產環境下，不要把 app.debug 設置成 true 。dom

權限

Web 服務器須要有能夠寫入 storage 這個目錄的權限。ide

訪問配置的值

咱們能夠根據應用程序運行的環境去使用不一樣的配置。好比，你可能想在本地環境跟生產環境上使用不一樣的緩存引擎，這樣就能夠去使用基於不一樣環境的配置。網站

爲了讓這件事更容易，Laravel 使用了 Vance Lucas 的 DotEnv 這個庫。在全新安裝的 Laravel 裏面，應用的根目錄下有個叫 .env.example 的文件。若是你用的是 Composer 安裝的 Laravel，這個文件會自動重命名成 .env，否則的話，你須要本身手工去重命名這個文件。this

當應用接收到請求的時候，在這個 .env 文件裏列出的全部的變量都會被載入到 $_ENV 這個 PHP 的超級全局變量裏。你可使用 env 幫手從這些變量裏獲取到值。看一下 Laravel 的配置文件，你會發現不少地方都用到了這個 env 幫手。好比在 config/app.php 這個文件裏：

'debug' => env('APP_DEBUG'),

'key' => env('APP_KEY', 'SomeRandomString'),

根據本身的需求去爲本地與生產環境去修改這些環境變量。不要把這個 .env 文件提供到應用的版本倉庫裏面，由於使用這個應用的不一樣的開發者或者服務器可能須要不一樣的環境配置。

若是你是跟一個團隊一塊兒開發，能夠在應用裏包含這個 .env.example 文件。在上面放一些配置的示例，這樣團隊裏的其它的開發者能夠很清楚的看到使用你的應用須要去配置哪些環境變量。

訪問應用當前的環境

你能夠經過 Application 實例上的 environment 這個方法訪問到當前應用的環境：

$environment = $app->environment();

你能夠爲 environment 方法傳遞參數來檢查是否匹配指定的環境：

if ($app->environment('local'))
{
    // 環境是 local
}

if ($app->environment('local', 'staging'))
{
    // 環境是 local 或者 staging... }

要獲得應用的實例，可使用 Service Container 來 Resolve Illuminate\Contracts\Foundation\Applicationcontract 。若是你在一個 Service Provider 裏面，應用的實例能夠經過 $this->app 獲得。

應用的實例可使用 App facade 裏面的 app 幫手訪問到：

$environment = app()->environment();

$environment = App::environment();

配置緩存

使用 config:cache 這個 Artisan 命令，能夠把應用裏的全部的配置文件合併成一個文件，這樣 Laravel 在加載它的時候會更快一些。

維護模式

當應用在維護模式下，會用一個自定義的視圖顯示給全部的請求。通常在升級或者維護應用的時候，能夠用這樣的方法暫時關閉應用。檢查維護模式包含在了應用的默認的 middleware stack 裏面。當應用在維護模式下的時候，HttpException 會扔出一個狀態碼是 503 的異常。

使用 Artisan 的 down 命令能夠打開應用的維護模式：

php artisan down

關閉維護維護，用的是 up 命令：

php artisan up

維護模式模板

默認的維護模式使用的模板是：resources/views/errors/503.blade.php

維護模式與隊列（Queues）

當應用在維護模式下，不會處理在隊列中的工做。關閉維護模式之後，隊列工做會像正常同樣去處理。

簡潔的URL

Apache

應用裏面的 public 目錄下面有個 .htaccess 文件，它能夠去掉 URL 裏面的 index.php 。若是你打算用 Apache 去爲 Laravel 應用提供服務，肯定你啓用了 Apache 的 mod_rewrite 模塊。

若是自帶的 .htaccess 無論用，能夠試試下面的代碼：

Options +FollowSymLinks
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

Nginx

使用 Nginx 服務器，在網站的配置文件裏，使用下面的指令能夠啓用簡潔的 URL ：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}