安裝

安裝

服務(wù)器要求

Laravel 對系統(tǒng)有一些要求。當(dāng)然，所有這些要求 Laravel Homestead 虛擬機都能滿足，因此強烈推薦你使用 Homestead 做為你的開發(fā)環(huán)境。

當(dāng)然，假如你不使用 Homestead，請確保你的服務(wù)器滿足以下要求：

安裝 Laravel

Laravel 使用 Composer 來管理項目依賴。因此，在使用 Laravel 之前，請確保你的機器已經(jīng)安裝了 Composer。

通過 Laravel 安裝器

首先，通過使用 Composer 安裝 Laravel 安裝器：

composer global require laravel/installer

確保將 Composer's system-wide vendor 目錄放置在你的系統(tǒng)環(huán)境變量 $PATH 中，以便系統(tǒng)可以找到 Laravel 的可執(zhí)行文件。該目錄根據(jù)你的操作系統(tǒng)存在不同的位置中；一些常見的配置包括 :

安裝完成后， laravel new 命令會在你指定的目錄創(chuàng)建一個全新的 Laravel 項目。例如， laravel new blog 將會創(chuàng)建一個名為 blog 的目錄，并已安裝好 Laravel 所有的依賴項:

laravel new blog

通過 Composer 創(chuàng)建項目

或者，你也可以在終端中運行 create-project 命令來安裝 Laravel：

composer create-project --prefer-dist laravel/laravel blog

本地開發(fā)環(huán)境

如果你在本地安裝了 PHP， 并且你想使用 PHP 內(nèi)置的服務(wù)器來為你的應(yīng)用程序提供服務(wù)，則可以使用 Artisan 命令 serve 。該命令會在 http://localhost:8000 上啟動開發(fā)服務(wù)器：

php artisan serve

當(dāng)然，最好還是選擇 Homestead 和 Valet。

配置

公共路徑

安裝完 Laravel 之后，你應(yīng)該配置你的 web 服務(wù)的文檔目錄指向 public 路徑。該路徑下的 index.php 文件作為進(jìn)入應(yīng)用的所有 HTTP 請求的前端控制器。

配置文件

Laravel 框架的所有配置文件存放在 config 目錄下。每個選項都有文檔標(biāo)注，便于通過文件查看并熟悉對你有用的選項。

目錄權(quán)限

在安裝 Laravel 后，你可能需要配置一些權(quán)限。 storage 和 bootstrap/cache 目錄在你的 web 服務(wù)下應(yīng)該是可寫的權(quán)限，否則 Laravel 將無法運行。如果你用的是 Homestead 虛擬機，這些權(quán)限應(yīng)該已經(jīng)設(shè)置好了。

應(yīng)用密鑰

安裝好 Laravel 之后的下一步是設(shè)置你的應(yīng)用密鑰為隨機字符串。如果你通過 Composer 或者 Laravel 安裝器安裝的，這個密鑰已經(jīng)通過 php artisan key:generate 命令為你設(shè)置好了。

通常，這個字符串應(yīng)該是 32 個字符長度。這個密鑰將會設(shè)置在環(huán)境變量文件 .env 中。如果你還沒有將 .env.example 文件重命名為 .env 那么你現(xiàn)在應(yīng)當(dāng)把此文件重命名。 如果應(yīng)用密鑰還沒有設(shè)置，你的用戶會話和其他的加密數(shù)據(jù)將會不安全

其他配置

Laravel 幾乎不需要除上面所說的其他什么配置了。你可以隨心所欲的開始開發(fā)了！然而，你可能會想要再次查看 config/app.php 文件和它的注釋說明。它包含一些你希望根據(jù)你應(yīng)用來更改的選項，諸如： timezone 和 locale 。

你還可能想要配置 Laravel 的其他的一些組件，例如：

Web 服務(wù)器配置

優(yōu)雅鏈接

Apache

Laravel 中包含了一個 public/.htaccess 文件，通常用于在資源路徑中隱藏 index.php 的前端控制器。在用 Apache 為 Laravel 提供服務(wù)之前，確保啟用了 mod_rewrite 模塊，這樣 .htaccess 文件才能被服務(wù)器解析。

如果 Laravel 附帶的 .htaccess 文件不起作用，嘗試下面的方法替代：

Options +FollowSymLinks -IndexesRewriteEngine OnRewriteCond %{HTTP:Authorization} .RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]RewriteCond %{REQUEST_FILENAME} !-dRewriteCond %{REQUEST_FILENAME} !-fRewriteRule ^ index.php [L]

Nginx

如果你使用 Nginx ，在你的站點配置中加入以下配置，所有的請求將會引導(dǎo)至 index.php 前端控制器：

location / {    try_files $uri $uri/ /index.php?$query_string;}

當(dāng)你使用 Homestead 或 Valet 時，優(yōu)雅鏈接將會自動配置好。