安裝
安裝 Composer
Laravel 框架使用 Composer 來管理其相依性。首先,下載一份 composer.phar
下來。之後,你可以把它放在本地端的專案目錄,或者是搬移至 /usr/local/bin
讓全站皆可使用。在 Windows 下,你可以使用 Composer Windows 安裝工具。
安裝 Laravel
透過 Laravel 安裝工具
首先,使用 Composer
下載 Laravel 安裝包:
composer global require "laravel/installer=~1.1"
請確定把 ~/.composer/vendor/bin
路徑放置於您的 PATH
裡,這樣 laravel
執行檔才可以被找到,以後就可以在終端機下直接使用 laravel
指令。
一旦安裝完成後,就可以使用 laravel new
指令建立一份全新安裝的 Laravel
專案,例如:laravel new blog
將會在當前目錄下建立一個叫 blog
的目錄,此目錄裡面存放着全新安裝的 Laravel 相關程式碼,此方法跟其他方法不一樣的地方在於是提前安裝好所有相關程式碼,您無需再透過 composer install
安裝,速度一下子提高了很多。
透過 Composer Create-Project
你一樣可以透過 Composer 在命令列執行 create-project
來安裝 laravel:
composer create-project laravel/laravel --prefer-dist
透過下載
Composer 安裝完成後,下載 最新版 的 Laravel 框架並且解壓縮到伺服器上的一個目錄中。接著,在 Laravel 應用程式的根目錄下,執行 php composer.phar install
(或者是 composer install
)來將所有框架所需的相依套件安裝完成。為了能夠成功完成安裝,您必須在伺服器上安裝好 Git。
如果你想要更新 Laravel 框架,你需要在命令列執行 php composer.phar update
來更新。
伺服器環境需求
Laravel 框架有一些系統需求:
- PHP >= 5.4
- MCrypt PHP 套件
PHP 5.5 之後,一些作業系統需要手動安裝 PHP JSON 套件。如果你使用的是 Ubuntu,可以透過 apt-get install php5-json
來直接安裝。
設定
Laravel 幾乎無需設定即可馬上使用。你可以自由的開始開發。然而,你可以查看 app/config/app.php
檔案和他的文件。它包含了數個你的應用程式所想要更動的選項如 時區(timezone)
和 語系(locale)
。
一旦 Laravel 安裝完成,你應該同時 設定本地環境。當你在你的本機上部署時,可以讓你得到更詳細的錯誤訊息。預設在你的正式環境裡詳細的錯誤訊息是被關掉的。
附註: 你不應該在正式環境中將
app.debug
設為true
。絕對!千萬不要!
權限
Laravel 框架有一個目錄需要額外設置權限:app/storage 需要讓網頁伺服器有寫入的權限。
路徑
一些框架的目錄路徑是可以被設定配置的。如果要更改這些目錄的位置,請查看 bootstrap/paths.php
檔案。
優雅鏈結
Apache
Laravel 框架透過 public/.htaccess
檔案來讓網址中不需要 index.php
。如果你網頁伺服器是使用 Apache 的話,請確認你有開啟 'mod_rewrite` 模組。
如果框架附帶的 .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;
}