# 安裝 - [安裝](#installation) - [服務器要求](#server-requirements) - [安裝 Laravel](#installing-laravel) - [配置](#configuration) - [Web 服務器配置](#web-server-configuration) - [優雅鏈接](#pretty-urls) <a name="installation"></a> ## 安裝 > {video} 如果你喜歡看視頻學習，Laracasts 為你提供了免費而又全面的 Laravel 教程。 <a name="server-requirements"></a> ### 服務器要求 Laravel 框架對系統有一些要求。所有這些要求 Laravel Homestead 虛擬機都能滿足，因此強烈建議你使用 Homestead 作為你本地的 Laravel 開發環境。 但如果你不使用 Homestead，則需要確保你的服務器符合以下要求： <div class="content-list" markdown="1"> - PHP >= 7.0.0 - PHP OpenSSL 擴展 - PHP PDO 擴展 - PHP Mbstring 擴展 - PHP Tokenizer 擴展 - PHP XML 擴展 </div> <a name="installing-laravel"></a> ### 安裝 Laravel Laravel 利用 [Composer](https://getcomposer.org) 來管理依賴。所以，在使用 Laravel 之前，請確保你的機器上安裝了 Composer。 #### 通過 Laravel 安裝器 首先，使用 Composer 下載 Laravel 安裝程序： composer global require "laravel/installer" 確保 `$HOME/.composer/vendor/bin` 目錄（或你的操作系統的等效目錄）已經放在你的環境變量 $PATH 中，以便系統可以找到 `laravel` 的可執行文件。 安裝之后， `laravel new` 命令會在你指定的目錄中創建一個新的 Laravel 項目。例如，`laravel new blog` 命令會創建一個名為 `blog` 的目錄，其中包含所有已經安裝好的 Laravel 的依賴項： laravel new blog #### 通過 Composer 創建項目 或者，你還可以通過在終端中運行 `create-project` 命令來安裝 Laravel： composer create-project --prefer-dist laravel/laravel blog #### 本地開發服務器 如果你在本地安裝了 PHP，并且想使用 PHP 內置的開發服務器來為你的應用程序提供服務，那就使用 Artisan 命令 `serve`。這個命令會在 `http://localhost:8000` 上啟動開發服務器： php artisan serve 當然，對于本地開發來說，最好的選擇還是 [Homestead](/docs/{{version}}/homestead) 和 [Valet](/docs/{{version}}/valet)。 <a name="configuration"></a> ### 配置 #### Public 目錄 安裝 Laravel 之后，你要將 Web 服務器的根目錄指向 `public` 目錄。該目錄下的 `index.php` 文件將作為所有進入應用程序的 HTTP 請求的前端控制器。 #### 配置文件 Laravel 框架的所有配置文件都放在 `config` 目錄中。每個選項都有注釋，方便你隨時查看文件并熟悉可用的選項。 #### 目錄權限 安裝完 Laravel 后，你可能需要給這兩個文件配置讀寫權限：`storage` 目錄和 `bootstrap/cache` 目錄應該允許 Web 服務器寫入，否則 Laravel 將無法運行。如果你使用的是 [Homestead](/docs/{{version}}/homestead) 虛擬機，這些權限已經為你設置好了。 #### 應用密鑰 安裝 Laravel 之后下一件應該做的事就是將應用程序的密鑰設置為隨機字符串。如果你是通過 Composer 或 Laravel 安裝器安裝的 Laravel，那這個密鑰已經為你通過 `php artisan key:generate` 命令設置好了。 通常來說，這個字符串長度為 32 個字符。密鑰可以在 `.env` 環境文件中設置。前提是你要將 `.env.example` 文件重命名為 `.env`。**如果應用程序密鑰沒有被設置，就不能確保你的用戶會話和其他加密數據的安全！** #### 更多的配置 除了以上的配置，Laravel 幾乎就不需要再配置什么了。你隨時就能開發！但是，可能的話，還是希望你查看 `config/app.php` 文件及其注釋。它包含幾個你可能想要根據你的應用來更改的選項，比如 `timezone` 和 `locale`。 你還可能想要配置 Laravel 的其他幾個組件，例如： <div class="content-list" markdown="1"> - [緩存](/docs/{{version}}/cache#configuration) - [數據庫](/docs/{{version}}/database#configuration) - [會話](/docs/{{version}}/session#configuration) </div> <a name="web-server-configuration"></a> ## Web 服務器配置 <a name="pretty-urls"></a> ### 優雅鏈接 #### Apache Laravel 使用 `public/.htaccess` 文件來為前端控制器提供隱藏了 `index.php` 的優雅鏈接。如果你的 Laravel 使用了 Apache 作為服務容器，請務必啟用 `mod_rewrite `模塊，讓服務器能夠支持 `.htaccess` 文件的解析。 如果 Laravel 附帶的 `.htaccess` 文件不起作用，就嘗試用下面的方法代替： Options +FollowSymLinks RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^ index.php [L] #### Nginx 如果你使用的是 Nginx，在你的站點配置中加入以下內容，它將會將所有請求都引導到 `index.php` 前端控制器： location / { try_files $uri $uri/ /index.php?$query_string; } 當然，使用 [Homestead](/docs/{{version}}/homestead) 或者 [Valet](/docs/{{version}}/valet) 時，你無需配置這些。 ## 譯者署名 | 用戶名 | 頭像 | 職能 | 簽名 | |---|---|---|---| | [@JokerLinly](https://laravel-china.org/users/5350) | <img class="avatar-66 rm-style" src="https://dn-phphub.qbox.me/uploads/avatars/5350_1481857380.jpg"> | 翻譯 | Stay Hungry. Stay Foolish. | --- > {note} 歡迎任何形式的轉載，但請務必注明出處，尊重他人勞動共創開源社區。 > > 轉載請注明：本文檔由 Laravel China 社區 [laravel-china.org](https://laravel-china.org) 組織翻譯，詳見 [翻譯召集帖](https://laravel-china.org/topics/5756/laravel-55-document-translation-call-come-and-join-the-translation)。 > > 文檔永久地址： https://d.laravel-china.org