安裝
安裝
安裝
安裝
{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
目錄下。每個選項都有文檔標注,便于通過文件查看并熟悉對你有用的選項。
目錄權(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)雅鏈接將會自動配置好。