安裝
安裝
安裝
安裝
{video} 你是一位初學(xué)者嗎?Laracasts 為初學(xué)者提供了 免費(fèi)而又全面的 Laravel 教程 。 它是你開(kāi)始 Laravel 學(xué)習(xí)之旅的好地方。
服務(wù)器要求
Laravel 對(duì)系統(tǒng)有一些要求。當(dāng)然,所有這些要求 Laravel Homestead 虛擬機(jī)都能滿足,因此強(qiáng)烈推薦你使用 Homestead 做為你的開(kāi)發(fā)環(huán)境。
當(dāng)然,假如你不使用 Homestead,請(qǐng)確保你的服務(wù)器滿足以下要求:
- PHP >= 7.1.3
- OpenSSL PHP 拓展
- PDO PHP 拓展
- Mbstring PHP 拓展
- Tokenizer PHP 拓展
- XML PHP 拓展
- Ctype PHP 拓展
- JSON PHP 拓展
- BCMath PHP 拓展
安裝 Laravel
Laravel 使用 Composer 來(lái)管理項(xiàng)目依賴。因此,在使用 Laravel 之前,請(qǐng)確保你的機(jī)器已經(jīng)安裝了 Composer。
通過(guò) Laravel 安裝器
首先,通過(guò)使用 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)存在不同的位置中;一些常見(jiàn)的配置包括 :
- macOS:
$HOME/.composer/vendor/bin
- GNU / Linux 發(fā)行版:
$HOME/.config/composer/vendor/bin
- Windows:
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin
安裝完成后,laravel new
命令會(huì)在你指定的目錄創(chuàng)建一個(gè)全新的 Laravel 項(xiàng)目。例如, laravel new blog
將會(huì)創(chuàng)建一個(gè)名為 blog
的目錄,并已安裝好 Laravel 所有的依賴項(xiàng):
laravel new blog
通過(guò) Composer 創(chuàng)建項(xiàng)目
或者,你也可以在終端中運(yùn)行 create-project
命令來(lái)安裝 Laravel:
composer create-project --prefer-dist laravel/laravel blog
本地開(kāi)發(fā)環(huán)境
如果你在本地安裝了 PHP, 并且你想使用 PHP 內(nèi)置的服務(wù)器來(lái)為你的應(yīng)用程序提供服務(wù),則可以使用 Artisan 命令 serve
。該命令會(huì)在 http://localhost:8000
上啟動(dòng)開(kāi)發(fā)服務(wù)器:
php artisan serve
當(dāng)然,最好還是選擇 Homestead 和 Valet。
配置
公共路徑
安裝完 Laravel 之后,你應(yīng)該配置你的 web 服務(wù)的文檔目錄指向 public
路徑。該路徑下的 index.php
文件作為進(jìn)入應(yīng)用的所有 HTTP 請(qǐng)求的前端控制器。
配置文件
Laravel 框架的所有配置文件存放在 config
目錄下。每個(gè)選項(xiàng)都有文檔標(biāo)注,便于通過(guò)文件查看并熟悉對(duì)你有用的選項(xiàng)。
目錄權(quán)限
在安裝 Laravel 后,你可能需要配置一些權(quán)限。 storage
和 bootstrap/cache
目錄在你的 web 服務(wù)下應(yīng)該是可寫的權(quán)限,否則 Laravel 將無(wú)法運(yùn)行。如果你用的是 Homestead 虛擬機(jī),這些權(quán)限應(yīng)該已經(jīng)設(shè)置好了。
應(yīng)用密鑰
安裝好 Laravel 之后的下一步是設(shè)置你的應(yīng)用密鑰為隨機(jī)字符串。如果你通過(guò) composer
或者 Laravel 安裝器安裝的,這個(gè)密鑰已經(jīng)通過(guò) php artisan key:generate
命令為你設(shè)置好了。
通常,這個(gè)字符串應(yīng)該是 32 個(gè)字符長(zhǎng)度。這個(gè)密鑰將會(huì)設(shè)置在環(huán)境變量文件 .env
中。如果你還沒(méi)有將 .env.example
文件重命名為 .env
文件,你需要將 .env.example
文件重命名為 .env
文件。如果應(yīng)用密鑰還沒(méi)有設(shè)置,你的用戶會(huì)話和其他的加密數(shù)據(jù)將會(huì)不安全!
其他配置
Laravel 幾乎不需要除上面所說(shuō)的其他什么配置了。你可以隨心所欲的開(kāi)始開(kāi)發(fā)了!然而,你可能會(huì)想要再次查看 config/app.php
文件和它的注釋說(shuō)明。它包含一些你可能希望根據(jù)你應(yīng)用來(lái)更改的選項(xiàng),諸如: timezone
和 locale
。
你還可能想要配置 Laravel 的其他的一些組件,例如:
- 緩存
- 數(shù)據(jù)庫(kù)
- 會(huì)話控制
Web 服務(wù)器配置
優(yōu)雅鏈接
Apache
Laravel 中包含了一個(gè) 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 ,在你的站點(diǎn)配置中加入以下配置,所有的請(qǐng)求將會(huì)引導(dǎo)至 index.php
前端控制器。
location / { try_files $uri $uri/ /index.php?$query_string;}
當(dāng)你使用 Homestead 或者 Valet 時(shí),優(yōu)雅鏈接將會(huì)自動(dòng)配置好。