遇見 Laravel (Meet Laravel)
Laravel 是一個具有表達力、優雅語法的 Web 應用程式框架。Web 框架為建立應用程式提供了結構和起點，讓您可以專注於創造令人驚豔的事物，而我們則為您處理細節。
Laravel 致力於提供令人驚豔的開發者體驗，同時提供強大的功能，例如徹底的 Dependency Injection (依賴注入)、表達力豐富的資料庫抽象層、Queue (佇列) 和排程 Job (工作)、單元和整合測試等等。
無論您是 PHP Web 框架的新手還是擁有多年經驗，Laravel 都是一個可以與您一起成長的框架。我們將幫助您邁出作為 Web 開發者的第一步，或者在您將專業知識提升到新水平時助您一臂之力。我們迫不及待地想看看您建立了什麼。
為什麼選擇 Laravel？ (Why Laravel)
在建立 Web 應用程式時，有各種工具和框架可供您使用。然而，我們相信 Laravel 是建立現代、全端 Web 應用程式的最佳選擇。
漸進式框架 (A Progressive Framework)
我們喜歡稱 Laravel 為「漸進式」框架。這意味著 Laravel 會隨著您一起成長。如果您剛開始涉足 Web 開發，Laravel 龐大的文件庫、指南和 影片教學 將幫助您學習基礎知識，而不會感到不知所措。
如果您是資深開發者，Laravel 為您提供了強大的工具，用於 Dependency Injection、單元測試、Queues、即時 Events 等等。Laravel 專為建立專業的 Web 應用程式而微調，並準備好處理企業級的工作負載。
可擴展的框架 (A Scalable Framework)
Laravel 具有令人難以置信的可擴展性。感謝 PHP 的擴展友善特性以及 Laravel 對 Redis 等快速、分散式快取系統的內建支援，使用 Laravel 進行水平擴展輕而易舉。事實上，Laravel 應用程式已經可以輕鬆擴展以處理每月數億次的請求。
需要極致的擴展性嗎？像 Laravel Cloud 這樣的平台允許您以幾乎無限的規模運行您的 Laravel 應用程式。
社群框架 (A Community Framework)
Laravel 結合了 PHP 生態系中最好的套件，提供最強大且對開發者友善的框架。此外，來自世界各地的數千名才華橫溢的開發者已經 為框架做出了貢獻。誰知道呢，也許您甚至會成為 Laravel 的貢獻者。
建立 Laravel 專案 (Creating A Laravel Project)
安裝 PHP 與 Laravel Installer (Installing Php)
在建立您的第一個 Laravel 應用程式之前，請確保您的本機電腦已安裝 PHP、Composer 和 Laravel installer。此外，您應該安裝 Node 和 NPM 或 Bun，以便您可以編譯應用程式的前端資源。
如果您本機電腦上沒有安裝 PHP 和 Composer，以下指令將在 macOS、Windows 或 Linux 上安裝 PHP、Composer 和 Laravel installer：
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"# Run as administrator...
Set-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'))/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"執行上述其中一個指令後，您應該重新啟動終端機工作階段。若要在透過 php.new 安裝後更新 PHP、Composer 和 Laravel installer，您可以重新執行終端機中的指令。
如果您已經安裝了 PHP 和 Composer，您可以透過 Composer 安裝 Laravel installer：
composer global require laravel/installer[!NOTE] 如需功能齊全的圖形化 PHP 安裝和管理體驗，請查看 Laravel Herd。
建立應用程式 (Creating An Application)
安裝 PHP、Composer 和 Laravel installer 後，您就可以建立一個新的 Laravel 應用程式了。Laravel installer 會提示您選擇偏好的測試框架、資料庫和 Starter Kit：
laravel new example-app應用程式建立後，您可以使用 dev Composer script 啟動 Laravel 的本機開發伺服器、Queue worker 和 Vite 開發伺服器：
cd example-app
npm install && npm run build
composer run dev啟動開發伺服器後，您可以在網頁瀏覽器中透過 http://localhost:8000 存取您的應用程式。接下來，您準備好 開始邁入 Laravel 生態系的下一步。當然，您可能也想 設定資料庫。
[!NOTE] 如果您想在開發 Laravel 應用程式時搶得先機，請考慮使用我們的 Starter Kits 之一。Laravel 的 Starter Kits 為您的新 Laravel 應用程式提供了後端和前端驗證的鷹架。
初始設定 (Initial Configuration)
Laravel 框架的所有設定檔都儲存在 config 目錄中。每個選項都有文件說明，因此請隨意瀏覽這些檔案並熟悉可用的選項。
Laravel 開箱即用，幾乎不需要額外的設定。您可以自由地開始開發！但是，您可能希望查看 config/app.php 檔案及其文件。它包含幾個選項，例如 url 和 locale，您可能希望根據您的應用程式進行更改。
基於環境的設定 (Environment Based Configuration)
由於 Laravel 的許多設定選項值可能會根據您的應用程式是在本機電腦上還是在正式環境 Web 伺服器上運行而有所不同，因此許多重要的設定值是使用應用程式根目錄下的 .env 檔案定義的。
您的 .env 檔案不應提交到應用程式的原始碼控制中，因為使用您的應用程式的每個開發者 / 伺服器可能需要不同的環境設定。此外，如果入侵者獲得了您的原始碼控制儲存庫的存取權限，這將是一個安全風險，因為任何敏感憑證都會被暴露。
[!NOTE] 有關
.env檔案和基於環境的設定的更多資訊，請查看完整的 設定文件。
資料庫與 Migration (Databases And Migrations)
現在您已經建立了 Laravel 應用程式，您可能希望將一些資料儲存在資料庫中。預設情況下，應用程式的 .env 設定檔指定 Laravel 將與 SQLite 資料庫互動。
在建立應用程式期間，Laravel 為您建立了一個 database/database.sqlite 檔案，並執行了必要的 Migration 以建立應用程式的資料庫資料表。
如果您更喜歡使用其他資料庫驅動程式，例如 MySQL 或 PostgreSQL，您可以更新 .env 設定檔以使用適當的資料庫。例如，如果您希望使用 MySQL，請像這樣更新 .env 設定檔的 DB_* 變數：
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
如果您選擇使用 SQLite 以外的資料庫，您將需要建立資料庫並執行應用程式的 資料庫 Migrations：
php artisan migrate[!NOTE] 如果您在 macOS 或 Windows 上開發，並且需要在本機安裝 MySQL、PostgreSQL 或 Redis，請考慮使用 Herd Pro 或 DBngin。
目錄設定 (Directory Configuration)
Laravel 應始終由為您的 Web 伺服器設定的「Web 目錄」的根目錄提供服務。您不應嘗試從「Web 目錄」的子目錄提供 Laravel 應用程式。嘗試這樣做可能會暴露應用程式中存在的敏感檔案。
使用 Herd 安裝 (Installation Using Herd)
Laravel Herd 是一個適用於 macOS 和 Windows 的極速、原生 Laravel 和 PHP 開發環境。Herd 包含了您開始 Laravel 開發所需的一切，包括 PHP 和 Nginx。
安裝 Herd 後，您就可以開始使用 Laravel 進行開發了。Herd 包含了 php、composer、laravel、expose、node、npm 和 nvm 的命令列工具。
[!NOTE] > Herd Pro 透過額外的強大功能增強了 Herd，例如建立和管理本機 MySQL、Postgres 和 Redis 資料庫的能力，以及本機郵件檢視和日誌監控。
macOS 上的 Herd (Herd On Macos)
如果您在 macOS 上開發，您可以從 Herd 網站 下載 Herd 安裝程式。安裝程式會自動下載最新版本的 PHP 並設定您的 Mac 始終在背景執行 Nginx。
macOS 版的 Herd 使用 dnsmasq 來支援「停放 (parked)」目錄。停放目錄中的任何 Laravel 應用程式都將由 Herd 自動提供服務。預設情況下，Herd 會在 ~/Herd 建立一個停放目錄，您可以使用目錄名稱在 .test 網域上存取此目錄中的任何 Laravel 應用程式。
安裝 Herd 後，建立新 Laravel 應用程式的最快方法是使用 Laravel CLI，它與 Herd 捆綁在一起：
cd ~/Herd
laravel new my-app
cd my-app
herd open當然，您隨時可以透過 Herd 的 UI 管理您的停放目錄和其他 PHP 設定，該 UI 可以從系統匣中的 Herd 選單開啟。
您可以透過查看 Herd 文件 了解更多關於 Herd 的資訊。
Windows 上的 Herd (Herd On Windows)
您可以從 Herd 網站 下載 Herd 的 Windows 安裝程式。安裝完成後，您可以啟動 Herd 以完成入門流程並首次存取 Herd UI。
透過左鍵點擊 Herd 的系統匣圖示即可存取 Herd UI。右鍵點擊會開啟快速選單，可存取您日常所需的所有工具。
在安裝過程中，Herd 會在您的家目錄 %USERPROFILE%\Herd 建立一個「停放 (parked)」目錄。停放目錄中的任何 Laravel 應用程式都將由 Herd 自動提供服務，您可以使用目錄名稱在 .test 網域上存取此目錄中的任何 Laravel 應用程式。
安裝 Herd 後，建立新 Laravel 應用程式的最快方法是使用 Laravel CLI，它與 Herd 捆綁在一起。要開始使用，請開啟 Powershell 並執行以下指令：
cd ~\Herd
laravel new my-app
cd my-app
herd open您可以透過查看 Windows 版 Herd 文件 了解更多關於 Herd 的資訊。
IDE 支援 (Ide Support)
您可以自由使用任何您希望的程式碼編輯器來開發 Laravel 應用程式。如果您正在尋找輕量且可擴充的編輯器，VS Code 或 Cursor 結合官方的 Laravel VS Code Extension 提供了出色的 Laravel 支援，包括語法高亮、程式碼片段、Artisan 指令整合，以及對 Eloquent Model、Route、Middleware、Asset、Config 和 Inertia.js 的智慧自動完成。
如需 Laravel 的廣泛且強大的支援，請看看 PhpStorm，這是一個 JetBrains IDE。搭配 Laravel Idea plugin，它為 Laravel 及其生態系提供了精確的支援，包括 Laravel Pint、Pest、Larastan 等等。Laravel Idea 的框架支援包括 Blade 樣板、Eloquent Model、Route、View、翻譯和 Component 的智慧自動完成，以及跨 Laravel 專案的強大程式碼生成和導航。
對於尋求雲端開發體驗的人來說，Firebase Studio 提供了直接在瀏覽器中建立 Laravel 的即時存取。無需任何設定，Firebase Studio 讓您可以輕鬆地從任何裝置開始建立 Laravel 應用程式。
Laravel 與 AI (Laravel And Ai)
Laravel Boost 是一個強大的工具，它橋接了 AI coding agents 和 Laravel 應用程式之間的鴻溝。Boost 為 AI agents 提供 Laravel 特定的上下文、工具和指南，以便它們可以生成更準確、特定於版本的程式碼，並遵循 Laravel 慣例。
當您在 Laravel 應用程式中安裝 Boost 時，AI agents 將獲得超過 15 種專用工具的存取權限，包括了解您正在使用哪些套件、查詢資料庫、搜尋 Laravel 文件、讀取瀏覽器日誌、生成測試以及透過 Tinker 執行程式碼的能力。
此外，Boost 還讓 AI agents 能夠存取超過 17,000 份向量化的 Laravel 生態系文件，這些文件特定於您安裝的套件版本。這意味著 agents 可以提供針對您專案所使用的確切版本的指導。
Boost 還包括 Laravel 維護的 AI 指南，幫助 agents 遵循框架慣例、編寫適當的測試，並避免在生成 Laravel 程式碼時出現常見的陷阱。
安裝 Laravel Boost (Installing Laravel Boost)
Boost 可以安裝在執行 PHP 8.1 或更高版本的 Laravel 10、11 和 12 應用程式中。要開始使用，請將 Boost 安裝為開發依賴項目：
composer require laravel/boost --dev安裝後，執行互動式安裝程式：
php artisan boost:install安裝程式將自動偵測您的 IDE 和 AI agents，允許您選擇對您的專案有意義的功能。Boost 尊重現有的專案慣例，預設情況下不會強制執行主觀的樣式規則。
[!NOTE] 要了解有關 Boost 的更多資訊，請查看 GitHub 上的 Laravel Boost repository。
下一步 (Next Steps)
現在您已經建立了 Laravel 應用程式，您可能想知道接下來要學什麼。首先，我們強烈建議透過閱讀以下文件來熟悉 Laravel 的運作方式：
您想要如何使用 Laravel 也將決定您旅程的下一步。使用 Laravel 的方式有很多種，我們將在下面探討框架的兩個主要使用案例。
Laravel 作為全端框架 (Laravel The Fullstack Framework)
Laravel 可以作為全端框架。所謂「全端」框架，是指您將使用 Laravel 來將請求路由到您的應用程式，並透過 Blade 樣板 或像 Inertia 這樣的單頁應用程式混合技術來渲染您的前端。這是使用 Laravel 框架最常見的方式，在我們看來，也是使用 Laravel 最具生產力的方式。
如果這是您計劃使用 Laravel 的方式，您可能想要查看我們關於 前端開發、Routing、Views 或 Eloquent ORM 的文件。此外，您可能對學習像 Livewire 和 Inertia 這樣的社群套件感興趣。這些套件允許您將 Laravel 作為全端框架使用，同時享受單頁 JavaScript 應用程式提供的許多 UI 優勢。
如果您將 Laravel 作為全端框架使用，我們也強烈建議您學習如何使用 Vite 編譯應用程式的 CSS 和 JavaScript。
[!NOTE] 如果您想在建立應用程式時搶得先機，請查看我們官方的 應用程式 Starter Kits 之一。
Laravel 作為 API 後端 (Laravel The Api Backend)
Laravel 也可以作為 JavaScript 單頁應用程式或行動應用程式的 API 後端。例如，您可以使用 Laravel 作為 Next.js 應用程式的 API 後端。在這種情況下，您可以使用 Laravel 為您的應用程式提供 驗證 和資料儲存 / 檢索，同時利用 Laravel 的強大服務，如 Queues、電子郵件、通知等等。
如果這是您計劃使用 Laravel 的方式，您可能想要查看我們關於 Routing、Laravel Sanctum 和 Eloquent ORM 的文件。