# 安裝 - [安裝](#installation) - [運行環境要求](#server-requirements) - [安裝 Laravel](#installing-laravel) - [配置信息](#configuration) <a name="installation"></a> ## 安裝 <a name="server-requirements"></a> ### 運行環境要求 Laravel 框架會有一些系統上的要求。當然，這些要求在 [Laravel Homestead](/docs/{{version}}/homestead) 虛擬機上都已經完全配置好了，強烈建議使用 Homestead 作為本地開發環境。 系統要求為以下： <div class="content-list" markdown="1"> - PHP >= 5.6.4 - OpenSSL PHP Extension - PDO PHP Extension - Mbstring PHP Extension - Tokenizer PHP Extension - XML PHP Extension </div> > 譯者注：強烈推薦使用 Homestead 作為開發環境，尤其是新手，可以避免很多不必要的麻煩。線上環境可以參考 [Homestead 的環境部署腳本](https://github.com/laravel/settler/blob/master/scripts/provision.sh) 進行部署。 <a name="installing-laravel"></a> ### 安裝 Laravel Laravel 使用 [Composer](http://getcomposer.org) 來管理代碼依賴。所以，在使用 Laravel 之前，請先確認你的電腦上安裝了 Composer。 #### 通過 Laravel 安裝工具 首先，使用 Composer 下載 Laravel 安裝包： composer global require "laravel/installer" 請確定你已將 `~/.composer/vendor/bin` 路徑加到 PATH，只有這樣系統才能找到 `laravel` 的執行文件。 一旦安裝完成，就可以使用 `laravel new` 命令在指定目錄創建一個新的 Laravel 項目，例如：`laravel new blog` 將會在當前目錄下創建一個叫 `blog` 的目錄，此目錄里面存放著新安裝的 Laravel 和代碼依賴。這個方法的安裝速度比通過 Composer 安裝要快上許多： laravel new blog 因為代碼依賴是直接一起打包安裝的。 #### 通過 Composer Create-Project 除此之外，你也可以通過 Composer 在命令行運行 `create-project` 命令來安裝 Laravel： composer create-project --prefer-dist laravel/laravel blog #### 本地開發服務器 如果你在本地安裝了 PHP，你可能希望像運行 PHP 內置的開發服務器一樣來訪問自己的應用程序，你可以使用 `serve` Artisan 命令來啟動一個本地開發服務器，這樣你就可以在 `http://localhost:8000` 來訪問它。 php artisan serve 不過有更健壯的本地開發選項可用，比如 [Homestead](/doc/{{version}}/homestead) 和 [Valet](/doc/{{version}}/valet)。 <a name="configuration"></a> ### 配置信息 #### Public 目錄 安裝完成后，你應該指定 Web 服務器的網站根目錄到 `public` 文件夾上。`index.php` 文件是 Laravel 的主要入口文件。 #### 配置文件 所有 Laravel 框架的配置文件都放置在 `config` 目錄下。每個選項都有說明，請仔細閱讀這些說明，并熟悉這些選項配置。 #### 目錄權限 安裝 Laravel 之后，你必須設置一些文件目錄權限。`storage` 和 `bootstrap/cache` 目錄必須讓服務器有寫入權限。如果你使用 [Homestead](/docs/{{version}}/homestead) 虛擬機，那么這些權限已經被設置好了。 #### 應用程序密鑰 在你安裝完 Laravel 后，首先需要做的事情是設置一個隨機字符串的密鑰。假設你是通過 Composer 或是 Laravel 安裝工具安裝的 Laravel，那么這個密鑰已經通過 `key:generate` 命令幫你設置完成。通常這個密鑰會有 32 字符長。這個密鑰可以被設置在 `.env` 環境文件中。如果你還沒將 `.env.example` 文件重命名為 `.env`，那么你現在應該去設置下。 **如果應用程序密鑰沒有被設置的話，你的用戶 Session 和其它的加密數據都是不安全的！** #### 其它設置 Laravel 幾乎不需做任何其它設置就可以馬上使用，但是建議你先瀏覽 `config/app.php` 文件和對應的文檔，這里面包含著一些選項，如 `時區` 和 `語言環境`，你可以根據應用程序的情況來修改。 你也可以設置 Laravel 的幾個附加組件，像是： - [緩存](/docs/{{version}}/cache#configuration) - [數據庫](/docs/{{version}}/database#configuration) - [Session](/docs/{{version}}/session#configuration) 一旦 Laravel 安裝完成，你應該立即 [設置本機環境](/docs/{{version}}/installation#environment-configuration)。