環境要求
在開始使用 Laravel 之前，你需要以下環境：- PHP 8.3 及以上
- Composer（PHP 的包管理器）
- Laravel Installer（可選，但推薦）
編譯前端資源時還需要 Node.js/npm 或 Bun。
安裝 PHP 與 Laravel Installer
同時安裝 PHP、Composer 與 Laravel Installer 最簡單的方式，是根據你的作業系統執行以下命令。建立新的 Laravel 應用
準備好 PHP、Composer 與 Laravel Installer 後，就可以建立新的 Laravel 應用了。 安裝器會引導你選擇測試框架、資料庫以及啟動套件。dev Composer 指令碼啟動開發伺服器。
使用啟動套件時，會自動生成包含認證功能的專案腳手架。Laravel 13 提供 React、Vue、Svelte、Livewire 四種選擇。
啟動套件的選項
執行laravel new 命令時，你可以從以下啟動套件中選擇一種。
Vue
Vue
基於 Inertia 的 Vue 前端啟動套件。採用 Vue Composition API、TypeScript、Tailwind 與 shadcn-vue。
Svelte
Svelte
基於 Inertia 的 Svelte 前端啟動套件。採用 Svelte 5、TypeScript、Tailwind 與 shadcn-svelte。
Livewire
Livewire
基於 Laravel Livewire 的啟動套件。只用 PHP 就可以構建動態 UI，最適合以 Blade 模板為主的團隊。採用 Tailwind 與 Flux UI。
使用 Laravel Herd 安裝
Laravel Herd 是面向 macOS 與 Windows 的原生 Laravel / PHP 開發環境。 它可以一次性安裝 PHP、Nginx 與 Laravel CLI。macOS
- 從 Herd 官網下載安裝器。
- 執行安裝器後，PHP 會被自動配置。
~/Herd目錄會被設定為停靠目錄（parked directory）。
Windows
- 從 Herd 官網下載 Windows 安裝器。
- 安裝完成後啟動 Herd，並完成引導流程。
%USERPROFILE%\Herd會成為停靠目錄。
初始配置
環境配置
Laravel 中許多配置項會因環境不同而變化。 因此，你需要透過應用根目錄的.env 檔案來管理重要的配置。
資料庫配置
預設情況下，Laravel 使用 SQLite。 如果要使用 MySQL 或 PostgreSQL，請修改.env 檔案。
IDE 支援
VS Code / Cursor
VS Code / Cursor
安裝官方的 Laravel VS Code Extension 即可獲得語法高亮、程式碼片段、Artisan 命令整合、Eloquent 模型智慧補全等 Laravel 支援。
PhpStorm
PhpStorm
PhpStorm 對 Laravel 框架有內建支援，可對 Blade 模板、Eloquent 模型、路由、檢視與翻譯進行智慧補全。
下一步
目錄結構
瞭解 Laravel 專案的主要目錄與檔案。