Laravel 5.0 中文文檔

Laravel 安裝指南

• 安裝 Composer
• 安裝 Laravel
• 環境需求

安裝 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 自帶了用戶注冊和認證的腳手架。如果你想要移除這個腳手架，使用 fresh 命令即可：

php artisan fresh

環境需求

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

• PHP 版本 >= 5.4
• Mcrypt PHP 擴展
• OpenSSL PHP 擴展
• Mbstring PHP 擴展

在 PHP 5.5 之后， 有些操作系統需要手動安裝 PHP JSON 擴展包。如果你是使用 Ubuntu，可以通過 apt-get install php5-json 來進行安裝。

配置

在你安裝完 Laravel 后，首先需要做的事情是配置一個隨機字串作為應用程序密鑰。假設你是通過 comoser 安裝 Laravel ，這個密鑰會自動通過 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 的話，優雅鏈接會自動的幫你配置完成。

詳細內容：http://laravel-china.org/docs/5.0