Laravel 框架使用 Composer 來管理其相依性。所以,在你使用 Laravel 之前,你必須確認你在你電腦上是否安裝了 Composer。
首先,使用 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
來安裝 Laravel:
composer create-project laravel/laravel --prefer-dist
Laravel 框架有一些系統上的需求:
在 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
要讓伺服器有寫入的權限。
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,在你的網站設定增加下面的設定,可以使用「優雅鏈結」:
location / {
try_files $uri $uri/ /index.php?$query_string;
}
當然,如果你使用 Homestead 的話,優雅鏈結會自動的幫你設定完成。