Laravel 對系統有一些要求。固然,全部這些要求 Laravel Homestead 虛擬機都能知足,所以強烈推薦你使用 Homestead 最爲你的開發環境。php
固然,假如你不使用 Homestead,請確保你的服務器知足如下要求:前端
Laravel 使用 Composer 來管理項目依賴。所以,在使用 Laravel 以前,請確保你的機器已經安裝了 Composer。laravel
首先,經過使用 Composer 安裝 Laravel 安裝器:web
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 Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
安裝完成後,laravel new
命令會在你指定的目錄建立一個全新的 Laravel 項目。例如, laravel new blog
將會建立一個名爲 blog
的目錄,並已安裝好 Laravel 全部的依賴項:bootstrap
laravel new blog
或者,你也能夠在終端中運行 create-project
命令來安裝 Laravel:緩存
composer create-project --prefer-dist laravel/laravel blog
若是你在本地安裝了 PHP, 而且你想使用 PHP 內置的服務器來爲你的應用程序提供服務,則可使用 Artisan 命令serve
。該命令會在 http://localhost:8000
上啓動開發服務器:安全
php artisan serve
固然,最好仍是選擇 Homestead 和 Valet。bash
安裝完 Laravel 以後,你應該配置你的 web 服務的文檔目錄指向 public
路徑。該路徑下的 index.php
文件做爲進入應用的全部 HTTP 請求的前端控制器。服務器
Laravel 框架的全部配置文件存放在 config
目錄下。每一個選項都有文檔標註,便於經過文件查看並熟悉對你有用的選項。
在安裝 Laravel 後,你可能須要配置一些權限。 storage
和 bootstrap/cache
目錄在你的 web 服務下應該是可寫的權限,不然 Laravel 將沒法運行。若是你用的是 Homestead 虛擬機,這些權限應該已經設置好了。
安裝好 Laravel 以後的下一步是設置你的應用祕鑰爲隨機字符串。若是你經過 composer
或者 Laravel 安裝器安裝的,這個祕鑰已經經過 php artisan key:generate
命令爲你設置好了。
一般,這個字符串應該是 32 個字符長度。這個祕鑰將會設置在環境變量文件 .env
中。若是你尚未將 .env.example
文件重命名爲 .env
文件,你須要將 .env.example
文件重命名爲 .env
文件。若是應用祕鑰尚未設置,你的用戶會話和其餘的加密數據將會不安全!
Laravel 幾乎不須要除上面所說的其餘什麼配置了。你能夠爲所欲爲的開始開發了!然而,你可能會想要再次查看 config/app.php
文件和它的註釋說明。它包含一些你可能但願根據你應用來更改的選項,諸如: timezone
和 locale
。
你還可能想要配置 Laravel 的其餘的一些組件,例如:
Laravel 中包含了一個 public/.htaccess
文件一般用於在資源路徑中隱藏 index.php
的前端控制器。在用 Apache 爲 Laravel 提供服務以前,確保啓用了 mod_write
模塊,這樣 .htaccess
文件才能被服務器解析。
若是 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 ,在你的站點配置中加入如下配置,全部的請求將會引導至 index.php
前端控制器。
location / { try_files $uri $uri/ /index.php?$query_string; }
當你使用 Homestead 或者 Valet 時,優雅連接將會自動配置好。