安裝

安裝

伺服器需求

Laravel 框架有一些系統上的需求。當然,Laravel Homestead 虛擬機器都能滿足這些需求,所以強烈的建議你使用 Homestead 作為本機 Laravel 開發環境。

不過,如果你不使用 Homestead,你會需要確保你的伺服器符合下列要求:

  • PHP >= 5.5.9
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Mbstring PHP Extension
  • Tokenizer PHP Extension

安裝 Laravel

Laravel 使用 Composer 來管理相依性。所以,在使用 Laravel 之前,你必須確認電腦上是否安裝了 Composer。

透過 Laravel 安裝工具

首先,使用 Composer 下載 Laravel 安裝包:

composer global require "laravel/installer"

請確定把 ~/.composer/vendor/bin 路徑放置於你的 PATH 裡,這樣你的系統才能找到 laravel 執行檔。

一旦安裝完成後,就可以使用 laravel new 指令在指定的目錄建立一份全新安裝的 Laravel。例如:laravel new blog 將會建立一個名稱為 blog 的目錄,裡面存放著全新安裝的 Laravel 和相依程式碼。這個安裝方法比透過 Composer 安裝速度快上許多:

laravel new blog

透過 Composer Create-Project

你也可以透過 Composer 在命令列執行 create-project 指令來安裝 Laravel:

composer create-project --prefer-dist laravel/laravel blog

設定

所有 Laravel 框架的設定檔案都放置在 config 目錄下。每個選項都有說明,因此你可以輕鬆地瀏覽這些文件,並且熟悉這些選項配置。

目錄權限

安裝 Laravel 之後,你必須設定一些權限。storagebootstrap/cache 目錄中的目錄必須讓你的伺服器有寫入權限,否則 Laravel 就無法執行。如果你使用 Homestead 虛擬機器,那麼這些權限應該已經被設定完成。

應用程式金鑰

在你安裝完 Laravel 後,首先需要做的事情是設定一個隨機字串到應用程式金鑰。假設你是透過 Composer 或是 Laravel 安裝工具安裝 Laravel,那麼這個金鑰已經透過 key:generate 指令幫你設定完成。通常這個金鑰應該有 32 字元長。這個金鑰可以被設定在 .env 環境檔案中。如果你還沒將 .env.example 檔案重新命名為 .env,那麼你應該現在開始。如果應用程式金鑰沒有被設定的話,你的使用者 Sessions 和其他的加密資料都是不安全的!

其他設定

Laravel 幾乎不需設定就可以馬上使用,你可以自由的開始開發!當然,你可以瀏覽 config/app.php 檔案和對應的文件。它包含數個選項,如時區語言環境,你不仿根據你的應用程式來做修改。

你也可以設定 Laravel 的幾個附加元件,像是:

一旦 Laravel 安裝完成,你應該同時設定本機環境