安裝 · Laravel5.7中文文檔

# 安裝 ## 服務器要求 Laravel 對系統有一些要求。當然，所有這些要求[Laravel Homestead]虛擬機都能滿足。如你不使用 Homestead ，請確保你的服務器滿足下面的要求： * PHP >= 7.1.3 * OpenSSL PHP 擴展 * PDO PHP 擴展 * Mbstring PHP 擴展 * Tokenizer PHP 擴展 * XML PHP 擴展 * Ctype PHP 擴展 * JSON PHP 擴展 ### 安裝 Laravel Laravel 使用[Composer](https://getcomposer.org/)來管理項目依賴。因此，在使用 Laravel 之前，請確保你的機器已經安裝了 Composer。 #### 通過 Laravel 安裝器首先，通過使用 Composer 安裝 Laravel 安裝器： ~~~php composer global require "laravel/installer" ~~~ 確保將 composer's system-wide vendor bin 目錄放置在你的系統環境變量`$PATH`中，以便系統可以找到 Laravel 的可執行文件。該目錄根據你的操作系統存在不同的位置中；一些常見的配置包括： * macOS:`$HOME/.composer/vendor/bin` * GNU / Linux 發行版:`$HOME/.config/composer/vendor/bin` 安裝完成后，`laravel new`命令會在你指定的目錄創建一個全新的 Laravel 項目。例如，`laravel new blog`將會創建一個名為`blog`的目錄，并已安裝好所有的 Laravel 依賴項： ~~~php laravel new blog ~~~ #### 通過 Composer 創建項目或者，你也可以在終端中運行`create-project`命令來安裝 Laravel ~~~php composer create-project --prefer-dist laravel/laravel blog ~~~ #### 本地開發環境如果你在本地安裝了 PHP，并且你想使用 PHP內置的服務器來為你的應用程序提供服務，則可以使用`serve Artisan`命令。該命令會在`http://localhost:8000`上啟動開發服務器： ~~~php php artisan serve ~~~ 當然，最好的選擇還是[Homestead](https://laravel-china.org/docs/laravel/5.7/homestead)和[Valet](https://laravel-china.org/docs/laravel/5.7/valet)。 ### 配置 #### 公共目錄安裝完 Laravel 之后，你必須將 web 服務器根目錄指向`public`目錄。該目錄下的`index.php`文件將作為所有進入應用程序的 HTTP 請求的前端控制器。 #### 配置文件 Laravel 框架的所有配置文件都放在`config`目錄中。每個選項都有注釋，方便你隨時查看文件并熟悉可用的選項。 #### 目錄權限安裝完 Laravel 后，你可能需要給這兩個文件配置讀寫權限：`storage`目錄和`bootstrap/cache`目錄應該允許 Web 服務器寫入，否則 Laravel 程序將無法運行。 #### 應用密鑰安裝 Laravel 之后下一件應該做的事就是將應用程序的密鑰設置為隨機字符串。如果你是通過 Composer 或 Laravel 安裝器安裝的 Laravel，那這個密鑰已經為你通過`php artisan key:generate`命令設置好了。通常來說，這個字符串長度為 32 個字符。密鑰可以在`.env`環境文件中設置。前提是你要將`.env.example`文件重命名為`.env`。**如果應用程序密鑰沒有被設置，就不能確保你的用戶會話和其他加密數據的安全！** #### 其他配置除了以上的配置，Laravel 幾乎就不需要再配置什么了。你隨時就能開發！但是，可能的話，還是希望你查看`config/app.php`文件及其注釋。它包含幾個你可能想要根據你的應用來更改的選項，比如`timezone`和`locale`。 ## Web 服務器配置 ### 優雅鏈接 #### Apache Laravel 使用?`public/.htaccess`?文件來為前端控制器提供了隱藏?`index.php`?的優雅鏈接. Laravel 使用 Apache 作為服務器，請務必啟用?`mod_rewrite`?模塊讓服務器能夠支持?`.htaccess`?的解析。如果 Laravel 附帶的?`.htaccess`?文件不起作用，嘗試下面的方法替代: ~~~php Options +FollowSymLinks -Indexes RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^ index.php [L] ~~~ #### Nginx 如果你使用 Nginx 服務器，在你的站點配置中加入以下內容，它將會將所有請求引導到?`index.php`?前端控制器中： ~~~php location / { try_files $uri $uri/ /index.php?$query_string; } ~~~ 當然，你使用[Homestead]或[Valet]，優雅鏈接會自動配置。