Laravel 5 Chinese Document

安裝

安裝 Composer

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

安裝 Laravel

透過 Laravel 安裝工具

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

composer global require "laravel/installer=~1.1"

請確定把 ~/.composer/vendor/bin 路徑放置於您的 PATH 裡, 這樣 laravel 執行檔就會存在你的系統。

一旦安裝完成後,就可以使用 laravel new 指令建立一份全新安裝的 Laravel 專案,例如: laravel new blog 將會在當前目錄下建立一個叫 blog 的目錄, 此目錄裡面存放著全新安裝的 Laravel 相關程式碼,此方法跟其他方法不一樣的地方在於是提前安裝好所有相關程式碼,不需要再透過 composer install 安裝,速度變快許多。

laravel new blog

透過 Composer Create-Project

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

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

環境需求

Laravel 框架有一些系統上的需求:

  • PHP >= 5.4
  • Mcrypt PHP Extension
  • OpenSSL PHP Extension
  • Mbstring PHP Extension

在 PHP 5.5 之後, 有些作業系統需要手動安裝 PHP JSON 套件。如果你是使用 Ubuntu,可以透過 apt-get install php5-json 來進行安裝。

設定

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

通常這個金鑰應該有 32 字元長。這個金鑰可以被設定在 .env 環境檔案中。 如果這金鑰沒有被設定的話,你的使用者 sessions 和其他的加密資料都是不安全的!

Laravel 幾乎不需設定就可以馬上使用。你可以自由的開始開發!然而,你可以查看 config/app.php 檔案和其他的文件。你可能希望依據你的應用程式而做更改,檔案包含數個選項如 時區語言環境

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

注意: 你不應該在正式環境中將 app.debug 設定為 true。絕對!千萬不要!

權限

Laravel 框架有一個目錄需要額外設置權限:storage 要讓伺服器有寫入的權限。

優雅鏈結

Apache

Laravel 框架透過 public/.htaccess 檔案來讓網址中不需要 index.php。如果你網頁伺服器是使用 Apache 的話,請確認是否有開啟 mod_rewrite 模組。

假設 Laravel 附帶的 .htaccess 檔在 Apache無法作用的話,請嘗試下面的方法:

Options +FollowSymLinks
RewriteEngine On

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

Nginx

在 Nginx,在你的網站設定增加下面的設定,可以使用「優雅鏈結」:

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

當然,如果你使用 Homestead 的話,優雅鏈結會自動的幫你設定完成。