安裝
安裝
安裝
安裝
{video} 你是一位初學(xué)者嗎？Laracasts 為初學(xué)者提供了 免費而又全面的 Laravel 教程 。 它是你開始 Laravel 學(xué)習(xí)之旅的好地方。
服務(wù)器要求
Laravel 對系統(tǒng)有一些要求。當(dāng)然，所有這些要求 Laravel Homestead 虛擬機都能滿足，因此強烈推薦你使用 Homestead 做為你的開發(fā)環(huán)境。
當(dāng)然，假如你不使用 Homestead，請確保你的服務(wù)器滿足以下要求：
- PHP >= 7.1.3
- OpenSSL PHP 拓展
- PDO PHP 拓展
- Mbstring PHP 拓展
- Tokenizer PHP 拓展
- XML PHP 拓展
- Ctype PHP 拓展
- JSON PHP 拓展
- BCMath PHP 拓展
安裝 Laravel
Laravel 使用 Composer 來管理項目依賴。因此，在使用 Laravel 之前，請確保你的機器已經(jīng)安裝了 Composer。
通過 Laravel 安裝器
首先，通過使用 Composer 安裝 Laravel 安裝器：
composer global require laravel/installer
確保將 composer's system-wide vendor bin 目錄放置在你的系統(tǒng)環(huán)境變量 $PATH 中，以便系統(tǒng)可以找到 Laravel 的可執(zhí)行文件。該目錄根據(jù)你的操作系統(tǒng)存在不同的位置中；一些常見的配置包括 :
- macOS:
$HOME/.composer/vendor/bin - GNU / Linux 發(fā)行版:
$HOME/.config/composer/vendor/bin - Windows:
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin
安裝完成后，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 文件作為進入應(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 文件，你需要將 .env.example 文件重命名為 .env 文件。如果應(yīng)用密鑰還沒有設(shè)置，你的用戶會話和其他的加密數(shù)據(jù)將會不安全！
其他配置
Laravel 幾乎不需要除上面所說的其他什么配置了。你可以隨心所欲的開始開發(fā)了！然而，你可能會想要再次查看 config/app.php 文件和它的注釋說明。它包含一些你可能希望根據(jù)你應(yīng)用來更改的選項，諸如： timezone 和 locale 。
你還可能想要配置 Laravel 的其他的一些組件，例如：
- 緩存
- 數(shù)據(jù)庫
- 會話控制
Web 服務(wù)器配置
優(yōu)雅鏈接
Apache
Laravel 中包含了一個 public/.htaccess 文件通常用于在資源路徑中隱藏 index.php 的前端控制器。在用 Apache 為 Laravel 提供服務(wù)之前，確保啟用了 mod_write 模塊，這樣 .htaccess 文件才能被服務(wù)器解析。
如果 Laravel 附帶的 .htaccess 文件不起作用，嘗試下面的方法替代：
Options +FollowSymLinks -Indexes
RewriteEngine On
RewriteCond %{HTTP:Authorization} .RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]Nginx
如果你使用 Nginx ，在你的站點配置中加入以下配置，所有的請求將會引導(dǎo)至 index.php 前端控制器。
location / {
try_files $uri $uri/ /index.php?$query_string;}當(dāng)你使用 Homestead 或者 Valet 時，優(yōu)雅鏈接將會自動配置好。