安裝
初識 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 的 UI 管理你的駐留目錄及其他 PHP 設定，該 UI 可從系統托盤的 Herd 選單中開啟。
你可以檢視 Herd 文件瞭解更多資訊。
Windows 上的 Herd
你可以從 Herd 網站下載 Windows 版安裝程式。安裝完成後，啟動 Herd 即可完成初始化流程並首次訪問 Herd UI。
左鍵單擊 Herd 的系統托盤圖示即可訪問 Herd UI。右鍵單擊則會開啟快速選單，方便訪問日常所需的各種工具。
安裝期間，Herd 會在你的使用者主目錄下建立一個“駐留”目錄：%USERPROFILE%\Herd。任何駐留目錄下的 Laravel 應用程式都會自動由 Herd 提供服務，你可以透過 .test 域名並在該目錄中透過專案資料夾名稱訪問任何 Laravel 應用程式。
安裝 Herd 後，建立新 Laravel 應用程式的最快方法是使用 Herd 捆綁的 Laravel CLI。要開始使用，請開啟 Powershell 並執行以下命令：
1cd ~\Herd2laravel new my-app3cd my-app4herd open你可以檢視 Windows 版 Herd 文件瞭解更多資訊。
IDE 支援
開發 Laravel 應用程式時，你可以自由選擇任何程式碼編輯器。如果你在尋找輕量級且可擴充套件的編輯器，VS Code 或 Cursor 配合官方的 Laravel VS Code Extension 提供了出色的支援，包括語法高亮、程式碼片段、Artisan 命令整合，以及針對 Eloquent 模型、路由、中介軟體、資源、配置和 Inertia.js 的智慧補全功能。
若需要全面且健壯的 Laravel 支援，請檢視 JetBrains 的 IDE —— PhpStorm。PhpStorm 內建的 Laravel 框架支援涵蓋了 Blade 模板、Eloquent 模型、路由、檢視、翻譯和元件的智慧補全，以及強大的程式碼生成和跨專案導航功能。
對於追求雲端開發體驗的使用者，Firebase Studio 提供了直接在瀏覽器中進行 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 最常見的方式，也是我們認為最高效的方式。
如果你計劃這樣使用 Laravel，你可能需要檢視我們關於 前端開發、路由、檢視或 Eloquent ORM 的文件。此外，你可能還會對社群包如 Livewire 和 Inertia 感興趣。這些包讓你能夠在使用 Laravel 作為全棧框架的同時，享受單頁 JavaScript 應用帶來的許多 UI 優勢。
如果你將 Laravel 用作全棧框架，我們也強烈建議你學習如何使用 Vite 編譯應用程式的 CSS 和 JavaScript。
如果你想在構建應用程式時快人一步，請檢視我們的官方應用程式入門套件。
作為 API 後端的 Laravel
Laravel 也可以作為 JavaScript 單頁應用或移動應用的 API 後端。例如，你可能會將 Laravel 用作 Next.js 應用的 API 後端。在這種場景下，你可以利用 Laravel 提供身份驗證以及資料儲存/檢索功能，同時還可以充分利用 Laravel 強大的服務，如佇列、郵件、通知等。
如果你計劃這樣使用 Laravel，你可能需要檢視我們關於 路由、Laravel Sanctum 以及 Eloquent ORM 的文件。