安裝

安裝

伺服器需求

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

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

  • PHP >= 5.6.4
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Mbstring PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension

安裝 Laravel

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

方式一:透過 Laravel Installer

首先,使用 Composer 下載 Laravel installer:

composer global require "laravel/installer"

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

一旦安裝完成後,就可以使用 laravel new 指令在指定的目錄建立一份全新安裝的 Laravel。例如:laravel new blog 將會建立一個名稱為 blog 的目錄,裡面存放著全新安裝的 Laravel 和相依程式碼:

laravel new blog

方式二:透過 Composer Create-Project

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

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

本地開發伺服器

If you have PHP installed locally and you would like to use PHP's built-in development server to serve your application, you may use the serve Artisan command. This command will start a development server at http://localhost:8000:

php artisan serve

Of course, more robust local development options are available via Homestead and Valet.

設定

Public 目錄

安裝完 Laravel 之後,需要將您的網站伺服器根目錄指向 public 目錄。該目錄下的 index.php 將作為前端控制器,所有的 HTTP 請求將會透過它進入你的應用程式。

設定檔

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

目錄權限

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

應用程式金鑰

在你安裝完 Laravel 後,首先需要做的事情是設定一個隨機字串到應用程式金鑰。假設你是透過 Composer 或是 Laravel 安裝工具安裝 Laravel,那麼這個金鑰已經透過 php artisan key:generate 指令幫你設定完成。

通常這個金鑰應該有 32 字元長。這個金鑰可以被設定在 .env 環境檔案中。如果你還沒將 .env.example 檔案重新命名為 .env,那麼你應該現在開始。如果應用程式金鑰沒有被設定的話,你的使用者 Sessions 和其他的加密資料都是不安全的!

其他設定

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

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

Web 伺服器設定

優雅的 URL

Apache

Laravel 包含 public/.htaccess 檔案,提供無需顯示 index.php 前端控制器的優雅 URL。當 Laravel 架設於 Apache 時,確認您的伺服器已啟用 mod_rewrite 模組,則 .htaccess 檔案會被啟用。

若在您的 Apache 環境中 .htaccess 檔案沒有效的話,嘗試以下的替代內容:

Options +FollowSymLinks
RewriteEngine On

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

Nginx

若你使用的是 Nginx,在網站設定檔中使用以下的指令,會重導所有的請求給 index.php 前端控制器:

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

理所當然的是,當使用 HomesteadValet,優雅的 URL 已自動設定完畢。