安裝
瞭解 Laravel
Laravel 是一個具有表達力、優雅語法的 Web 應用程式框架。Web 框架為建立應用程式提供了結構和起點，讓你能夠專注於創作出色的產品，而我們將處理繁瑣的細節。
Laravel 致力於提供絕佳的開發體驗，同時提供強大的功能，如全面的依賴注入、富有表達力的資料庫抽象層、佇列和定時任務、單元與整合測試等。
無論你是 PHP Web 框架的新手，還是擁有多年經驗的開發者，Laravel 都是一個能與你共同成長的框架。我們將幫助你邁出 Web 開發的第一步，或在你提升專業技能時助你一臂之力。我們迫不及待想看到你構建的作品。
為什麼選擇 Laravel？
在構建 Web 應用程式時，你可以選擇各種工具和框架。然而，我們相信 Laravel 是構建現代、全棧 Web 應用程式的最佳選擇。
漸進式框架
我們喜歡稱 Laravel 為“漸進式”框架。這意味著 Laravel 可以與你共同成長。如果你剛剛踏入 Web 開發領域，Laravel 豐富的文件、指南和 影片教程 將幫助你輕鬆入門，而不會感到不知所措。
如果你是一位資深開發者，Laravel 為你提供了強大的工具，用於 依賴注入、單元測試、佇列、即時事件等。Laravel 經過精心調優，適合構建專業的 Web 應用程式，並能夠勝任企業級負載。
可擴充套件的框架
Laravel 具有極佳的可擴充套件性。得益於 PHP 的可擴充套件性以及 Laravel 對 Redis 等快速分散式快取系統的內建支援，使用 Laravel 進行橫向擴充套件輕而易舉。事實上，Laravel 應用程式已輕鬆擴充套件到每月處理數億次請求。
需要極致擴充套件？像 Laravel Cloud 這樣的平臺讓你能夠以近乎無限的規模執行 Laravel 應用程式。
適配 AI 智慧體的框架
Laravel 嚴謹的約定和定義明確的結構，使其成為使用 Cursor 和 Claude Code 等工具進行 AI 輔助開發 的理想框架。當你要求 AI 智慧體新增控制器時，它確切地知道放在哪裡。當你需要新的遷移時，命名約定和檔案位置都是可預測的。這種一致性消除了在更靈活的框架中常讓 AI 工具困惑的猜測。
除了檔案組織，Laravel 富有表達力的語法和全面的文件，為 AI 智慧體提供了生成準確、地道程式碼所需的上下文。Eloquent 關係、表單請求和中介軟體等功能遵循智慧體可以可靠理解和復刻的模式。結果就是 AI 生成的程式碼看起來就像出自資深 Laravel 開發者之手，而不是從通用的 PHP 程式碼片段中拼湊出來的。
想了解更多關於為什麼 Laravel 是 AI 輔助開發的完美選擇，請檢視我們關於 智慧體開發 的文件。
社群驅動的框架
Laravel 整合了 PHP 生態系統中最好的包，提供了目前最強大且對開發者友好的框架。此外，全球成千上萬的優秀開發者為 該框架做出了貢獻。誰知道呢，也許你也會成為 Laravel 的貢獻者。
建立 Laravel 應用程式
安裝 PHP 和 Laravel 安裝程式
在建立第一個 Laravel 應用程式之前，請確保你的本地機器已安裝 PHP、Composer 和 Laravel 安裝程式。此外，你應該安裝 Node 和 NPM 或 Bun，以便編譯應用程式的前端資源。
如果你本地沒有安裝 PHP 和 Composer，以下命令將在 macOS、Windows 或 Linux 上安裝 PHP、Composer 和 Laravel 安裝程式：
1/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"1# Run as administrator...2Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.4'))1/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"執行上述命令之一後，應重啟終端會話。要在透過 php.new 安裝後更新 PHP、Composer 和 Laravel 安裝程式，你可以在終端中重新執行該命令。
如果你已經安裝了 PHP 和 Composer，你可以透過 Composer 安裝 Laravel 安裝程式：
1composer global require laravel/installer想要獲得功能齊全的圖形化 PHP 安裝與管理體驗，請檢視 Laravel Herd。
建立應用程式
安裝好 PHP、Composer 和 Laravel 安裝程式後，你就可以建立新的 Laravel 應用程式了。Laravel 安裝程式會提示你選擇首選的測試框架、資料庫和入門套件。
1laravel new example-app應用程式建立完成後，你可以使用 dev Composer 指令碼啟動 Laravel 的本地開發伺服器、佇列工作程序和 Vite 開發伺服器：
1cd example-app2npm install && npm run build3composer run dev啟動開發伺服器後，你可以在瀏覽器中訪問 https://:8000。接下來，你可以 邁出進入 Laravel 生態系統的下一步。當然，你可能還想 配置資料庫。
如果你想在開發 Laravel 應用程式時快人一步，請考慮使用我們的 入門套件。Laravel 的入門套件為你的新應用程式提供了後端和前端的身份驗證腳手架。
初始配置
Laravel 框架的所有配置檔案都儲存在 config 目錄中。每個選項都有文件說明，請隨意瀏覽這些檔案，熟悉可用的選項。
Laravel 開箱即用，幾乎無需額外配置。你可以直接開始開發！不過，你可能希望查閱 config/app.php 檔案及其文件。它包含了一些選項（如 url 和 locale），你可能需要根據應用程式進行調整。
基於環境的配置
由於 Laravel 的許多配置選項值可能取決於應用程式是在本地機器還是生產 Web 伺服器上執行，因此許多重要的配置值是透過位於應用程式根目錄的 .env 檔案來定義的。
你的 .env 檔案不應提交到版本控制系統中，因為每個開發者或伺服器可能需要不同的環境配置。此外，如果入侵者獲得對你程式碼倉庫的訪問許可權，這也將構成安全風險，因為敏感憑據會暴露。
有關 .env 檔案和基於環境的配置的更多資訊，請查閱完整的 配置文件。
資料庫與遷移
既然你已經建立了 Laravel 應用程式，你可能想要在資料庫中儲存一些資料。預設情況下，你的 .env 配置檔案指定 Laravel 將使用 SQLite 資料庫。
在建立應用程式期間，Laravel 已為你生成了 database/database.sqlite 檔案，並運行了必要的遷移來建立應用程式的資料庫表。
如果你傾向於使用 MySQL 或 PostgreSQL 等其他資料庫驅動，你可以更新 .env 配置檔案來使用相應的資料庫。例如，如果你想使用 MySQL，請按如下方式更新 .env 配置檔案中的 DB_* 變數：
1DB_CONNECTION=mysql2DB_HOST=127.0.0.13DB_PORT=33064DB_DATABASE=laravel5DB_USERNAME=root6DB_PASSWORD=如果你選擇使用 SQLite 以外的資料庫，則需要自行建立資料庫並執行應用程式的 資料庫遷移。
1php artisan migrate目錄配置
Laravel 始終應該從 Web 伺服器配置的“Web 目錄”根路徑執行。你不應嘗試從“Web 目錄”的子目錄執行 Laravel 應用程式。這樣做可能會暴露應用程式內部的敏感檔案。
使用 Herd 安裝
Laravel Herd 是一個專為 macOS 和 Windows 設計的極其快速、原生的 Laravel 和 PHP 開發環境。Herd 包含了 Laravel 開發所需的一切，包括 PHP 和 Nginx。
一旦安裝了 Herd，你就可以開始 Laravel 開發了。Herd 包含了用於 php、composer、laravel、expose、node、npm 和 nvm 的命令列工具。
Herd Pro 為 Herd 增強了強大的功能，例如建立和管理本地 MySQL、Postgres 和 Redis 資料庫的能力，以及本地郵件檢視和日誌監控。
macOS 上的 Herd
如果你在 macOS 上開發，可以從 Herd 官網 下載安裝程式。安裝程式會自動下載最新版本的 PHP，並將你的 Mac 配置為始終在後臺執行 Nginx。
macOS 版 Herd 使用 dnsmasq 來支援“駐留”（parked）目錄。任何位於駐留目錄中的 Laravel 應用程式都會自動由 Herd 提供服務。預設情況下，Herd 會在 ~/Herd 建立一個駐留目錄，你可以透過 .test 域名並在其後加上目錄名來訪問此目錄中的任何 Laravel 應用程式。
安裝 Herd 後，建立新 Laravel 應用程式最快的方法是使用隨 Herd 捆綁的 Laravel CLI：
1cd ~/Herd2laravel new my-app3cd my-app4herd open當然，你也可以透過 Herd 的使用者介面管理駐留目錄和其他 PHP 設定，該介面可從系統托盤的 Herd 選單中開啟。
你可以檢視 Herd 文件 來了解更多資訊。
Windows 上的 Herd
你可以在 Herd 官網 下載 Windows 版安裝程式。安裝完成後，啟動 Herd 以完成引導過程並首次訪問 Herd UI。
透過左鍵點選系統托盤中的 Herd 圖示即可訪問 Herd UI。右鍵點選則會開啟快捷選單，方便使用日常所需的所有工具。
在安裝過程中，Herd 會在你的使用者主目錄下建立一個名為 %USERPROFILE%\Herd 的“駐留”目錄。該目錄下的任何 Laravel 應用程式都會由 Herd 自動提供服務，你可以透過 .test 域名及目錄名來訪問。
安裝 Herd 後，建立新 Laravel 應用程式最快的方法是使用隨 Herd 捆綁的 Laravel CLI。若要開始使用，請開啟 Powershell 並執行以下命令：
1cd ~\Herd2laravel new my-app3cd my-app4herd open你可以檢視 Herd Windows 文件 以瞭解更多資訊。
IDE 支援
在開發 Laravel 應用程式時，你可以自由選擇任何程式碼編輯器。如果你正在尋找輕量級且可擴充套件的編輯器，VS Code 或 Cursor 結合官方的 Laravel VS Code 擴充套件 可以提供出色的支援，包括語法高亮、程式碼片段、Artisan 命令整合，以及針對 Eloquent 模型、路由、中介軟體、資源、配置和 Inertia.js 的智慧補全。
若要獲得全面且強大的 Laravel 支援，請看一看 JetBrains 的 IDE：PhpStorm。PhpStorm 對 Laravel 框架的內建支援包括 Blade 模板、Eloquent 模型/路由/檢視/翻譯/元件的智慧補全，以及強大的程式碼生成和 Laravel 專案導航功能。
對於尋求基於雲的開發體驗的使用者，Firebase Studio 提供了一種無需設定、直接在瀏覽器中構建 Laravel 應用的方式，讓你能夠從任何裝置開始開發。
Laravel 與 AI
Laravel Boost 是一款強有力的工具，填補了 AI 編碼智慧體與 Laravel 應用程式之間的鴻溝。Boost 為 AI 智慧體提供了 Laravel 專用的上下文、工具和指南，使它們能夠生成更準確、符合特定版本及 Laravel 規範的程式碼。
在 Laravel 應用程式中安裝 Boost 後，AI 智慧體即可訪問超過 15 種專業工具，包括識別所用包、查詢資料庫、搜尋 Laravel 文件、讀取瀏覽器日誌、生成測試以及透過 Tinker 執行程式碼。
此外，Boost 還允許 AI 智慧體訪問超過 17,000 條向量化的 Laravel 生態系統文件，並針對你安裝的包版本進行了定製。這意味著智慧體能夠提供針對你專案實際版本的具體指導。
Boost 還包含由 Laravel 官方維護的 AI 指南，幫助智慧體遵循框架約定、編寫適當的測試，並在生成 Laravel 程式碼時避免常見陷阱。
安裝 Laravel Boost
Boost 可安裝在執行 PHP 8.1 或更高版本的 Laravel 10、11、12 和 13 應用程式中。若要開始，請將 Boost 安裝為開發依賴：
1composer require laravel/boost --dev安裝完成後，執行互動式安裝程式：
1php artisan boost:install安裝程式將自動檢測你的 IDE 和 AI 智慧體，讓你能夠按需啟用功能。Boost 尊重現有的專案約定，預設情況下不會強制使用主觀的風格規則。
想了解更多關於 Boost 的資訊，請訪問 GitHub 上的 Laravel Boost 倉庫。
新增自定義 AI 指南
要透過你自己的自定義 AI 指南來增強 Laravel Boost，請將 .blade.php 或 .md 檔案新增到應用程式的 .ai/guidelines/* 目錄中。執行 boost:install 時，這些檔案將自動包含在 Laravel Boost 的指南中。
後續步驟
現在你已經建立了 Laravel 應用程式，你可能想知道接下來該學習什麼。首先，我們強烈建議你閱讀以下文件，以熟悉 Laravel 的工作原理：
你想要如何使用 Laravel 也將決定你後續的學習路徑。Laravel 有多種使用方式，下面我們探討該框架的兩種主要應用場景。
Laravel 全棧框架
Laravel 可以作為全棧框架使用。所謂“全棧”框架，是指你將使用 Laravel 來路由請求，並透過 Blade 模板 或像 Inertia 這樣的單頁應用混合技術來渲染前端。這是使用 Laravel 框架最常見的方式，也是我們認為最高效的方式。
如果這就是你的計劃，你可能想檢視我們關於 前端開發、路由、檢視 或 Eloquent ORM 的文件。此外，你可能還會對 Livewire 和 Inertia 等社群包感興趣。這些包允許你在享受單頁 JavaScript 應用帶來的 UI 優勢的同時，將 Laravel 作為全棧框架使用。
如果你正在將 Laravel 用作全棧框架，我們也強烈建議你學習如何使用 Vite 來編譯應用程式的 CSS 和 JavaScript。
如果你想在構建應用程式時快人一步，請檢視我們官方的 應用程式入門套件。
Laravel API 後端
Laravel 也可以作為 JavaScript 單頁應用或移動應用的 API 後端。例如，你可能會將 Laravel 用作 Next.js 應用程式的 API 後端。在這種場景下，你可以使用 Laravel 提供 身份驗證 以及資料儲存/檢索功能，同時利用 Laravel 強大的服務，如佇列、郵件、通知等。
如果這是你的計劃，你可能想檢視我們關於 路由、Laravel Sanctum 和 Eloquent ORM 的文件。