• #安裝
  • ##安裝
  • 伺服器要求
  • 安裝Laravel
  設定
• • Web 伺服器設定
  優雅連結

#安裝#########{video} 你是初學者嗎？ Laracasts 為初學者提供了 免費且全面的 Laravel 教程 。它是你開始 Laravel 學習之旅的好地方。 #########################

伺服器要求

Laravel 對系統有一些要求。當然，所有這些要求 Laravel Homestead 虛擬機都能滿足，因此強烈建議你使用 Homestead 做為你的開發環境。

當然，假如你不使用Homestead，請確保你的伺服器滿足以下要求：

安裝Laravel

Laravel 使用Composer  來管理專案依賴。因此，在使用 Laravel 之前，請確保你的機器已經安裝了 Composer。

透過Laravel 安裝器

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

composer global require laravel/installer

確保將composer's system-wide vendor bin 目錄放置在你的系統環境變數$PATH 中，以便系統可以找到Laravel 的可執行檔。目錄根據你的作業系統存在不同的位置；一些常見的設定包括:

安裝完成後，laravel new 指令會在你指定的目錄建立一個全新的Laravel 專案。例如， laravel new blog  將會建立一個名為 blog  的目錄，並且已安裝好Laravel 所有的相依性:

laravel new blog

透過Composer 建立專案

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

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

#本機開發環境

如果你在本地安裝了PHP， 並且你想使用PHP 內建的伺服器來為你的應用程式提供服務，則可以使用Artisan 指令 serve。這個指令會在 http://localhost:8000 上啟動開發伺服器:

php artisan serve

當然，最好還是選擇  Homestead 和 Valet。

設定

#公共路徑

安裝完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 的其他的一些元件，例如：

Web 伺服器設定

優雅連結

Apache

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

如果你使用 Nginx ，在你的網站配置中加入以下配置，所有的請求將會引導至 index.php 前端控制器。

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

當你使用 Homestead 或  Valet 時，優雅連結將會自動配置好。