安裝 · Laravel 5.6 中文文檔

* * * * * [TOC] ## 安裝 > {video} 你是一位初學者嗎？ Laracasts 為您提供[免費而又全面的 Laravel 教程](http://laravelfromscratch.com/)。它是你開始 Laravel 學習之旅的好地方。 ### 服務器要求 Laravel 對系統有一些要求。當然，所有這些要求 Laravel Homestead 虛擬機都能滿足，因此強烈推薦您使用 Homestead 作為你的開發環境。當然，如你不使用 Homestead ，請確保您的服務器滿足下面的要求： * PHP >= 7.1.3 * OpenSSL PHP * PHP PDO 擴展 * PHP Mbstring 擴展 * PHP Tokenizer 擴展 * PHP XML 擴展 * PHP Ctype 擴展 * PHP JSON 擴展 ### 安裝 Laravel Laravel 使用?[Composer](https://getcomposer.org/)?來管理項目依賴。因此，在使用 Laravel 之前，請確保你的機器已經安裝了 Composer。 #### 通過 Laravel 安裝器首先，通過使用 Composer 安裝 Laravel 安裝器： ~~~ composer global require "laravel/installer" ~~~ 確保將 composer vender bin 目錄放置在你的系統環境變量?`$PATH`?中，以便系統可以找到 Laravel 的可執行文件。該目錄根據您的操作系統存在不同的位置中；一些常見的配置包括： * macOS:?`$HOME/.composer/vendor/bin` * GNU / Linux 發行版:?`$HOME/.config/composer/vendor/bin` 安裝完成后，?`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內置的服務器來為您的應用程序提供服務，則可以使用?`serve`?Artisan 命令。該命令會在?`http://localhost:8000`?上啟動開發服務器： ~~~ php artisan serve ~~~ 當然，最好的選擇還是?[Homestead](http://www.hmoore.net/tonyyu/laravel_5_6/786195)?和?[Valet](http://www.hmoore.net/tonyyu/laravel_5_6/786196)。 ### 配置 #### 公共目錄安裝完 Laravel 之后，你必須將 web 服務器根目錄指向?`public`?目錄。該目錄下的?`index.php`?文件將作為所有進入應用程序的 HTTP 請求的前端控制器。 #### 配置文件 Laravel 框架的所有配置文件都放在?`config`?目錄中。每個選項都有注釋，方便你隨時查看文件并熟悉可用的選項。 #### 目錄權限安裝完 Laravel 后，你可能需要給這兩個文件配置讀寫權限：`storage`?目錄和?`bootstrap/cache`?目錄應該允許 Web 服務器寫入，否則 Laravel 程序將無法運行。如果你使用的是?[Homestead](http://www.hmoore.net/tonyyu/laravel_5_6/786195)?虛擬機, 這些權限已經為你配置好了。 #### 應用密鑰安裝 Laravel 之后下一件應該做的事就是將應用程序的密鑰設置為隨機字符串。如果你是通過 Composer 或 Laravel 安裝器安裝的 Laravel，那這個密鑰已經為你通過?`php artisan key:generate`?命令設置好了。通常來說，這個字符串長度為 32 個字符。密鑰可以在?`.env`?環境文件中設置。前提是你要將?`.env.example`?文件重命名為?`.env`。?**如果應用程序密鑰沒有被設置，就不能確保你的用戶會話和其他加密數據的安全！** #### 其他配置除了以上的配置，Laravel 幾乎就不需要再配置什么了。你隨時就能開發！但是，可能的話，還是希望你查看?`config/app.php`?文件及其注釋。它包含幾個你可能想要根據你的應用來更改的選項，比如?`timezone`?和?`locale`。你還可能想要配置 Laravel 的其他幾個組件，例如: * [緩存](http://www.hmoore.net/tonyyu/laravel_5_6/786240#_2) * [數據庫](http://www.hmoore.net/tonyyu/laravel_5_6/786260#_11) * [會話控制](http://www.hmoore.net/tonyyu/laravel_5_6/786180#_6) ## Web 服務器配置 ### 優雅鏈接 #### 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](http://www.hmoore.net/tonyyu/laravel_5_6/786195)?或?[Valet](http://www.hmoore.net/tonyyu/laravel_5_6/786196)，優雅鏈接會自動配置。