# Knowledge of Laravel: Traditional Chinese

## Traditional Chinese

- [Traditional Chinese / 我的套件 (142 pages)](https://kawax.biz/_llms/zh-hant/tab.md): Documentation for Traditional Chinese / 我的套件.

### 教學

#### 開始使用

- [什麼是 Laravel](https://kawax.biz/zh-TW/introduction.md): 介紹 Laravel 的概況與特性，並闡述為什麼應該選擇 Laravel。
- [開始學習 Laravel 前需要具備的知識](https://kawax.biz/zh-TW/true-tutorial.md): 整理學習 Laravel 前必須掌握的四大領域，指引你先掌握相關基礎知識。
- [安裝](https://kawax.biz/zh-TW/installation.md): 介紹 Laravel 的安裝步驟以及 PHP 環境的搭建方法。
- [目錄結構](https://kawax.biz/zh-TW/directory-structure.md): 說明 Laravel 專案主要目錄與檔案的角色。
- [設定](https://kawax.biz/zh-TW/configuration.md): 說明 Laravel 的設定檔、環境變數（.env）、設定值的存取方式、快取、除錯模式與維護模式。

#### 基礎

- [路由](https://kawax.biz/zh-TW/routing.md): 說明 Laravel 的路由定義方式、路由參數與具名路由的基本觀念。
- [View](https://kawax.biz/zh-TW/views.md): 說明如何建立 Laravel view 並從路由或 controller 回傳，以及傳遞資料的方式。
- [Blade 模板](https://kawax.biz/zh-TW/blade.md): 解說 Laravel 模板引擎「Blade」的基本語法、條件判斷、迴圈與版面繼承。
- [URL 生成](https://kawax.biz/zh-TW/urls.md): 說明 Laravel 的 url() helper、具名路由 URL、簽章 URL、controller action URL 的產生方法。

#### 請求處理

- [控制器](https://kawax.biz/zh-TW/controllers.md): 說明 Laravel 控制器的建立方式與其與路由的整合。
- [中介軟體](https://kawax.biz/zh-TW/middleware.md): 說明如何運用 Laravel 中介軟體對 HTTP 請求進行過濾與前處理。
- [HTTP Request](https://kawax.biz/zh-TW/requests.md): 說明如何使用 Laravel 的 Illuminate\Http\Request 物件取得 HTTP 請求資料。
- [驗證](https://kawax.biz/zh-TW/validation.md): 說明如何用 Laravel 的驗證功能檢查表單輸入資料。
- [回應（Response）](https://kawax.biz/zh-TW/responses.md): 說明 Laravel 的回應種類，以及如何從控制器回傳合適的回應。
- [Session](https://kawax.biz/zh-TW/session.md): 使用 Laravel HTTP session 在請求之間保留資料的方式

#### 資料庫

- [資料庫遷移（Migrations）](https://kawax.biz/zh-TW/migrations.md): 說明如何運用 Laravel 的 migration 功能為資料庫綱要進行版本控管。
- [資料庫 Seeding](https://kawax.biz/zh-TW/seeding.md): 說明如何使用 Laravel 的 seeding 功能將開發／測試用範例資料寫入資料庫。
- [Eloquent 入門](https://kawax.biz/zh-TW/eloquent.md): 說明如何運用 Laravel 的 ORM「Eloquent」操作資料庫。
- [Eloquent 關聯入門](https://kawax.biz/zh-TW/eloquent-relationships.md): 說明如何運用 Eloquent 定義資料表之間的關聯（一對一、一對多、多對多），並有效地取得關聯資料。
- [Eloquent Factories](https://kawax.biz/zh-TW/eloquent-factories.md): 說明如何運用模型工廠，為測試與 seeding 高效地產生假資料。

#### 認證

- [認證入門](https://kawax.biz/zh-TW/authentication.md): 解說 Laravel 認證功能的基礎知識。從使用啟動套件導入認證系統，到取得已認證使用者的方法皆有說明。
- [起始套件（Starter Kit）](https://kawax.biz/zh-TW/starter-kits.md): 使用 Laravel 的起始套件快速設定認證與 UI 的方式
- [Laravel Socialite（社群認證）](https://kawax.biz/zh-TW/socialite.md): 說明如何使用 Laravel Socialite 以簡潔的方式實作透過 OAuth 2.0 的社群登入（GitHub、Google、Facebook 等）。

#### 輔助工具與外部通訊

- [輔助函式](https://kawax.biz/zh-TW/helpers.md): 以實務範例說明 Laravel 提供的全域輔助函式，以及 Arr、Number 類別。
- [字串操作（Str 類別）](https://kawax.biz/zh-TW/strings.md): 以實用範例說明使用 Laravel Str 類別與 Stringable（Fluent Strings）進行字串操作。
- [集合](https://kawax.biz/zh-TW/collections.md): 說明如何運用 Laravel 的 Collection 類別高效地操作資料。
- [HTTP 用戶端](https://kawax.biz/zh-TW/http-client.md): 說明如何使用 Laravel 的 HTTP 用戶端向外部 API 發送請求，涵蓋認證、逾時、重試與測試。

#### 測試與部署

- [測試入門](https://kawax.biz/zh-TW/testing.md): 使用 Pest 與 PHPUnit 撰寫 Laravel 應用測試的方法
- [HTTP 測試](https://kawax.biz/zh-TW/http-tests.md): Laravel HTTP 測試功能：請求模擬、斷言、認證測試與檔案上傳測試
- [資料庫測試](https://kawax.biz/zh-TW/database-testing.md): 如何運用 RefreshDatabase、Seeder、Factory 與專屬斷言，有效率地撰寫 Laravel 的資料庫測試
- [Mock](https://kawax.biz/zh-TW/mocking.md): 使用 Laravel 的 mock 與 test double 功能，讓測試以獨立單位執行
- [主控台測試](https://kawax.biz/zh-TW/console-tests.md): 學習如何在 Laravel 中測試 Artisan 指令（輸入 / 輸出的期待值、離開代碼驗證、主控台事件驗證）。
- [部署](https://kawax.biz/zh-TW/deployment.md): 將 Laravel 應用程式部署至正式環境的設定、最佳化與維運指南

#### AI 開發輔助

- [Laravel 與 AI 開發](https://kawax.biz/zh-TW/ai.md): Laravel 是最適合 AI 輔助開發的框架。透過 Laravel Boost 的 MCP 伺服器整合、AI 指引、文件搜尋 API，發揮 AI 編碼 Agent 的最大能力。

### 指南

#### 架構

- [請求生命週期](https://kawax.biz/zh-TW/lifecycle.md): 介紹 Laravel 應用如何處理 HTTP 請求以及 Console 命令。
- [Service Container](https://kawax.biz/zh-TW/service-container.md): 說明使用 Laravel service container 進行依賴注入的機制與 binding 的基礎。
- [Service Provider](https://kawax.biz/zh-TW/service-providers.md): 說明如何使用 Laravel service provider 登記與啟動應用程式的服務。
- [Facade](https://kawax.biz/zh-TW/facades.md): 說明 Laravel Facade 的機制與用法、即時 Facade、測試方式，以及與依賴注入的取捨。
- [Contracts（契約）](https://kawax.biz/zh-TW/contracts.md): 說明 Laravel Contracts 的角色、與 Facade 的差異、透過型別提示注入的方式，以及建立自訂 Contract 的方法。

#### 資料庫

- [資料庫設定](https://kawax.biz/zh-TW/database.md): 說明 Laravel 的資料庫連線設定、read/write 分離、多重連線、SQL 執行、查詢監聽與 transaction 的基本概念。
- [查詢建構器](https://kawax.biz/zh-TW/query-builder.md): 從使用 Laravel 的 DB::table() 的查詢建構器基礎到進階應用完整解說。學習不用 Eloquent 直接組合 SQL 的方式與使用時機。
- [分頁](https://kawax.biz/zh-TW/pagination.md): 說明 Laravel 的分頁功能。涵蓋 paginate()、simplePaginate()、cursorPaginate() 的差異、Blade 顯示、API 回應以及 URL 自訂。
- [MongoDB](https://kawax.biz/zh-TW/mongodb.md): 在 Laravel 應用程式中使用 MongoDB。從驅動安裝與設定、Eloquent 模型、Query Builder，到作為快取 / 佇列驅動的用法皆有介紹。
- [搜尋](https://kawax.biz/zh-TW/search.md): Laravel 搜尋功能全景。說明如何依用途分別使用全文檢索、向量搜尋、rerank 與 Laravel Scout。

#### Eloquent

- [Eloquent API 資源](https://kawax.biz/zh-TW/eloquent-resources.md): 說明如何將 Eloquent 模型轉換為一致的 JSON API 回應。從建立資源類別到條件式欄位、與分頁的整合，實務性地介紹。
- [Eloquent 存取器、修改器與型別轉換（Casts）](https://kawax.biz/zh-TW/eloquent-mutators.md): 說明 Eloquent 模型在取得與儲存屬性值時進行轉換的機制，並實務性地介紹存取器 / 修改器的定義方式與內建轉換的使用方法。
- [Laravel Scout](https://kawax.biz/zh-TW/scout.md): 為 Eloquent model 加入全文搜尋與語意搜尋功能的官方套件。支援 Meilisearch、Algolia、Typesense、Turbopuffer 與資料庫引擎，透過 model observer 自動同步索引。
- [Eloquent 序列化](https://kawax.biz/zh-TW/eloquent-serialization.md): 說明如何將 Eloquent 模型轉為 JSON 或陣列，控制屬性顯示與隱藏、設定追加屬性以及自訂日期格式。
- [Eloquent 集合](https://kawax.biz/zh-TW/eloquent-collections.md): 說明 Illuminate\Database\Eloquent\Collection 的專屬方法，以及自訂集合類別的作法。

#### 安全性

- [授權（Gate 與 Policy）](https://kawax.biz/zh-TW/authorization.md): 解說如何使用 Laravel 的 Gate 與 Policy 管理使用者的動作權限。
- [電子郵件驗證（Email Verification）](https://kawax.biz/zh-TW/verification.md): 說明實作 Laravel 電子郵件驗證功能的步驟。可學習 model 準備、3 條路由定義、verified middleware、自訂與事件。
- [CSRF 保護](https://kawax.biz/zh-TW/csrf.md): 說明 CSRF 攻擊的原理，以及 Laravel 13 透過 Origin 驗證與 token 驗證進行防禦的方式。
- [Laravel Sanctum（API token 認證）](https://kawax.biz/zh-TW/sanctum.md): 說明使用 Laravel Sanctum 進行 API token 認證與 SPA 認證的實作方法。從簡潔輕量的認證套件導入到實務用法。
- [密碼重設](https://kawax.biz/zh-TW/passwords.md): 在 Laravel 中實作密碼重設功能的方法
- [雜湊（Hashing）](https://kawax.biz/zh-TW/hashing.md): 說明如何運用 Laravel 的 Hash Facade 安全地雜湊與驗證密碼，涵蓋 bcrypt 與 Argon2 演算法的設定與使用方式。
- [加密（Encryption）](https://kawax.biz/zh-TW/encryption.md): 說明如何使用 Laravel 的 Crypt Facade 進行 AES-256-CBC 的值加密與解密。內容涵蓋 APP_KEY 產生、模型 Cast，以及個資的安全儲存等。
- [Precognition](https://kawax.biz/zh-TW/precognition.md): 在表單送出前即時執行伺服器端驗證的 Laravel 功能
- [Laravel Passport（OAuth2 伺服器實作）](https://kawax.biz/zh-TW/passport.md): 說明如何以 Laravel Passport 實作 OAuth2 伺服器。涵蓋與 Sanctum 的分工、安裝、用戶端管理、Scope 與 token 運用。

#### 事件

- [事件與監聽器](https://kawax.biz/zh-TW/events.md): 學習如何運用 Laravel 的事件系統，讓應用程式的元件保持鬆散耦合。

#### 郵件與通知

- [郵件寄送](https://kawax.biz/zh-TW/mail.md): 從 Laravel Mailable 類別的基本，到 Markdown 郵件與佇列寄送。
- [通知（Notifications）](https://kawax.biz/zh-TW/notifications.md): 說明如何使用 Laravel 的通知系統，透過郵件、資料庫、Slack 等多種頻道進行一次性群發。

#### 付款

- [Laravel Cashier (Stripe)](https://kawax.biz/zh-TW/cashier.md): 說明如何使用 Laravel Cashier (Stripe) 實作訂閱扣款、一次性付款、發票與 Webhook 的基本流程。

#### 非同步處理

- [Queue 與 Job](https://kawax.biz/zh-TW/queues.md): 說明如何使用 Laravel 的 Queue 與 Job，將寄信、圖片處理等重負載處理以非同步方式執行。
- [Laravel Horizon](https://kawax.biz/zh-TW/horizon.md): 說明如何運用 Laravel Horizon 以視覺化方式管理與監控 Redis 佇列，涵蓋儀表板、平衡策略、Supervisor 設定與通知。
- [並行處理](https://kawax.biz/zh-TW/concurrency.md): 說明如何使用 Laravel 13 的 Concurrency Facade 同時執行多項處理，以提升應用程式效能。

#### 即時通訊

- [廣播](https://kawax.biz/zh-TW/broadcasting.md): 說明如何使用 Laravel 的廣播與 Laravel Reverb，透過 WebSocket 實作即時通訊。
- [Laravel Reverb](https://kawax.biz/zh-TW/reverb.md): 為 Laravel 應用程式提供即時 WebSocket 通訊的官方伺服器套件

#### 排程

- [任務排程](https://kawax.biz/zh-TW/scheduling.md): 學習如何用 Laravel 的排程器優雅地管理定期執行的任務。

#### 快取與最佳化

- [快取](https://kawax.biz/zh-TW/cache.md): 學習如何運用 Laravel 的快取系統來提升應用程式的效能。
- [Redis](https://kawax.biz/zh-TW/redis.md): 在 Laravel 應用程式中使用 Redis 進行快取、Session、Queue 與 Pub/Sub 的設定與操作方法

#### 國際化

- [在地化](https://kawax.biz/zh-TW/localization.md): 說明如何運用 Laravel 的多語言支援功能，以 PHP 檔案與 JSON 檔案管理翻譯字串。

#### 檔案與儲存

- [檔案儲存](https://kawax.biz/zh-TW/filesystem.md): 說明如何運用 Laravel 的 Flysystem 整合進行檔案讀寫、上傳，以及與雲端儲存的整合。
- [圖片加工](https://kawax.biz/zh-TW/images.md): 說明如何運用 Laravel 的 Image Facade 進行圖片的縮放、裁切、格式轉換與儲存。

#### 偵錯與監控

- [Context（脈絡）](https://kawax.biz/zh-TW/context.md): 說明如何使用 Laravel 的 Context 功能，在請求、Job 與指令之間共享資訊，並自動附加到日誌中。
- [錯誤處理](https://kawax.biz/zh-TW/error-handling.md): 了解 Laravel 的例外處理機制。完整涵蓋例外的回報、渲染、自訂錯誤頁面與 HTTP 錯誤回應的生成。
- [日誌](https://kawax.biz/zh-TW/logging.md): 學習如何運用 Laravel 的日誌系統，將應用程式行為記錄到檔案、Slack 或外部服務。
- [Laravel Pulse](https://kawax.biz/zh-TW/pulse.md): 說明使用 Laravel Pulse 導入應用程式監控儀表板的方法與設定。廣泛涵蓋 recorder、取樣、自訂卡片的建立。
- [Laravel Pennant](https://kawax.biz/zh-TW/pennant.md): 說明使用 Laravel Pennant 管理功能旗標（Feature Flags）的方法。廣泛涵蓋 Feature 定義、判斷、Scope 設定與測試。
- [Laravel Telescope](https://kawax.biz/zh-TW/telescope.md): 說明 Laravel Telescope 的導入。涵蓋本機專用安裝與 watcher 配置。

#### 主控台與 CLI

- [Artisan Console](https://kawax.biz/zh-TW/artisan.md): 說明如何使用 Laravel 的 Artisan Console 建立自訂 CLI 指令。
- [Laravel Prompts](https://kawax.biz/zh-TW/prompts.md): 說明如何使用 laravel/prompts 套件為 Artisan 指令加入精美的互動式 UI。介紹文字輸入、選擇、搜尋、autocomplete、任務日誌、串流輸出等多樣函式。
- [Process](https://kawax.biz/zh-TW/processes.md): 說明如何使用 Laravel 的 Process facade 執行外部 shell 指令，簡潔地處理同步、非同步與並行處理。
- [Laravel Pint](https://kawax.biz/zh-TW/pint.md): 建立於 PHP CS Fixer 之上的程式碼樣式自動修正工具。說明如何在團隊中維持一致的程式碼撰寫風格。
- [瀏覽器測試（Dusk）](https://kawax.biz/zh-TW/dusk.md): 如何使用 Laravel Dusk，透過 ChromeDriver 執行瀏覽器端對端測試

#### 效能

- [Laravel Octane](https://kawax.biz/zh-TW/octane.md): 使用 FrankenPHP、Swoole、RoadRunner 加速 Laravel 應用程式

#### 前端

- [前端](https://kawax.biz/zh-TW/frontend.md): 在 Laravel 13 中，如何搭配 Blade、Livewire、Inertia、React、Vue、Svelte、SPA、Vite 的入門指南。
- [以 Vite 進行 asset bundling](https://kawax.biz/zh-TW/vite.md): 說明如何在 Laravel 專案中用 Vite 打包 JavaScript／CSS，並以熱重載建構舒適的開發環境。
- [Laravel Folio](https://kawax.biz/zh-TW/folio.md): 說明如何以 Laravel Folio 實作以檔案為基礎的路由，涵蓋安裝到路由模型繫結。
- [Laravel Head](https://kawax.biz/zh-TW/head.md): 了解如何在 Blade、Livewire、Inertia 中使用 Laravel Head 管理文件 <head>。以流暢式 API 設定 title、meta、Open Graph、canonical URL、robots、效能提示與結構化資料。

#### AI 開發

- [Laravel Boost](https://kawax.biz/zh-TW/boost.md): Laravel Boost 是加速 AI 輔助開發的套件。透過 MCP 伺服器、AI 指南與 Agent Skills，讓 AI 編碼代理能深入理解你的 Laravel 應用程式。
- [Laravel MCP](https://kawax.biz/zh-TW/mcp.md): 學習如何在 Laravel 應用程式中內建 Model Context Protocol（MCP）伺服器。你可以定義 AI 編碼代理與應用程式互動所需的工具、資源與提示。
- [Laravel AI SDK](https://kawax.biz/zh-TW/ai-sdk.md): Laravel AI SDK 的完整指南，可以統一介面處理 OpenAI、Anthropic、Gemini 等多個 AI 供應商。涵蓋 Agent、圖片生成、語音、Embedding 及測試。

#### 開發環境

- [Laravel Sail](https://kawax.biz/zh-TW/sail.md): 說明如何使用 Laravel Sail 以零設定建立 Docker 為基礎的本機開發環境。
- [Envoy](https://kawax.biz/zh-TW/envoy.md): 說明如何以 Blade 語法運用 Laravel Envoy 定義並在遠端伺服器上執行部署任務或 Artisan 指令。

### 進階主題

#### AI 開發

- [用 Laravel 構建 MCP 伺服器](https://kawax.biz/zh-TW/advanced/mcp-server.md): 使用 laravel/mcp 包構建可用於生產環境的 MCP 伺服器。涵蓋工具、資源、提示的實現，以及認證、測試與部署等實戰知識。
- [建立 Boost 的自定義 Agent](https://kawax.biz/zh-TW/advanced/boost-custom-agent.md): 深入 Laravel Boost 的擴充套件架構，講解如何實現 SupportsGuidelines、SupportsMcp、SupportsSkills 契約的自定義 Agent。
- [建立 AI SDK 的自定義 Provider](https://kawax.biz/zh-TW/advanced/ai-sdk-custom-provider.md): 解讀 Laravel AI SDK 的原始碼，講解如何為標準未提供的 AI 服務實現自定義 Provider。

#### 設計模式

- [Pipeline 模式](https://kawax.biz/zh-TW/advanced/pipeline.md): 說明 Illuminate\Pipeline\Pipeline 類別的機制，以及以鏈式構成多個處理步驟的 Pipeline 模式。
- [Fluent 類別](https://kawax.biz/zh-TW/advanced/fluent.md): 說明如何使用 Illuminate\Support\Fluent 類別將陣列資料以物件方式處理。這是自 Laravel 初期就存在的隱藏便利類別。
- [Macroable trait](https://kawax.biz/zh-TW/advanced/macroable.md): 說明如何使用 Illuminate\Support\Traits\Macroable trait 為既有的 Laravel 類別新增自訂方法。
- [Conditionable trait](https://kawax.biz/zh-TW/advanced/conditionable.md): 解說 when() / unless() 方法的內部實作與活用模式。
- [InteractsWithTime trait](https://kawax.biz/zh-TW/advanced/interacts-with-time.md): 說明用於 Queue、Cache、Scheduling 的時間計算工具 trait 及其活用方式。
- [ForwardsCalls trait](https://kawax.biz/zh-TW/advanced/forwards-calls.md): 說明如何使用 Illuminate\Support\Traits\ForwardsCalls，安全地實作 Proxy/Decorator 類別的方法轉發。
- [tap() helper 與 Tappable trait](https://kawax.biz/zh-TW/advanced/tap.md): 說明 Laravel 的 tap() helper 與 Illuminate\Support\Traits\Tappable trait 的用法及實作模式。
- [once() helper 的內部實作 — Once、Onceable、PreventsCircularRecursion](https://kawax.biz/zh-TW/advanced/once-helper.md): 從 Illuminate\Support\Once 與 Onceable 兩個類別，解說全域函式 once() 的內部實作；並介紹其在 Eloquent 循環參照防護 trait PreventsCircularRecursion 上的應用。
- [Dumpable trait](https://kawax.biz/zh-TW/advanced/dumpable.md): 解說如何以 Illuminate\Support\Traits\Dumpable 為任意類別新增 dump() / dd()，在不中斷鏈的情況下進行除錯。
- [Support Contracts（Arrayable / Jsonable / Htmlable / Responsable）](https://kawax.biz/zh-TW/advanced/support-contracts.md): 基於 Laravel 13 官方原始碼，說明 Illuminate\Contracts\Support 中的 4 種主要 Contract。
- [Lottery 類別](https://kawax.biz/zh-TW/advanced/lottery.md): 說明如何使用 Illuminate\Support\Lottery 優雅地實作機率式操作。同時介紹套件開發中的使用情境與測試時的固定化。
- [Collection 的 Higher Order Messages](https://kawax.biz/zh-TW/advanced/higher-order-messages.md): Collection 之 Higher-order Messages 的機制與實務用法。
- [Collection Deep Dive](https://kawax.biz/zh-TW/advanced/collection-deep-dive.md): 從歷史沿革、類別結構、PHPDoc Generics 與閱讀方式的觀點，解說 Laravel Collection 的實作。
- [Illuminate\Support\Manager — Driver 系統解剖](https://kawax.biz/zh-TW/advanced/manager.md): 自 Laravel 4.0 延續至今的 Driver 系統核心類別。從自訂 Driver 的註冊方式到 MultipleInstanceManager 一併說明。
- [PHP Reflection API](https://kawax.biz/zh-TW/advanced/php-reflection.md): 說明 PHP Reflection API 的機制，以及在 Laravel 的 IoC 容器與套件開發中的活用方式。
- [PHP FFI](https://kawax.biz/zh-TW/advanced/ffi.md): 解說 PHP FFI 的基本、可用環境，並以 VOICEVOX Core for PHP 為題材說明實用的封裝模式。
- [PHP AST](https://kawax.biz/zh-TW/advanced/php-ast.md): 說明 PHP AST（抽象語法樹）的基本、PHP 內部 AST 的定位，並解說使用 nikic/PHP-Parser 進行實務程式碼解析與轉換的模式。

#### 套件開發

- [Laravel 套件開發](https://kawax.biz/zh-TW/advanced/package-development.md): 以服務提供者為核心，涵蓋 Laravel 套件開發的方式，包含設定、View、Migration、Facade 的公開，以及自動偵測、延遲載入。
- [套件自動偵測的內部結構](https://kawax.biz/zh-TW/advanced/package-discovery.md): 解讀 PackageManifest 類別的內部實作，說明 composer.json 的 extra.laravel 如何被快取，並以 bootstrap/cache/packages.php 的形式讀取。
- [InteractsWithData trait](https://kawax.biz/zh-TW/advanced/interacts-with-data.md): 說明 Illuminate\Support\Traits\InteractsWithData 的設計，以及在套件開發中為自訂類別實作資料存取 API 的方法。
- [延遲服務提供者](https://kawax.biz/zh-TW/advanced/deferred-provider.md): 解說如何實作 DeferrableProvider 介面來延遲載入服務。這是套件效能最佳化中不起眼但相當重要的功能。
- [套件的版本相容性管理](https://kawax.biz/zh-TW/advanced/package-versioning.md): 從 composer.json 的更新到 GitHub Actions 的測試 matrix 設定，實務地說明因應 Laravel 與 PHP 主版本更新時的套件維護策略。
- [GitHub Actions 的 Pinning 與安全性](https://kawax.biz/zh-TW/advanced/github-actions-pinning.md): 作為套件供應鏈攻擊的對策，說明如何將 GitHub Actions 相依項目由版本改為 SHA hash 進行 pinning，並包含 Dependabot 的自動更新策略。
- [套件的 CHANGELOG 與發布管理](https://kawax.biz/zh-TW/advanced/package-changelog.md): 從 Laravel 套件的變更歷史管理到 GitHub Release 的自動化，說明長期維護所需的發布管理實務。
- [以 Orchestra Testbench 測試 Laravel 套件](https://kawax.biz/zh-TW/advanced/package-testing.md): 說明使用 Orchestra Testbench 建置 Laravel 套件的測試環境，並驗證服務提供者、Facade、設定與 DB 的步驟。
- [以 Testbench Workbench 推進套件開發](https://kawax.biz/zh-TW/advanced/package-workbench.md): 說明如何使用 Orchestra Testbench Workbench，建立具備路由、Migration、服務啟動並接近實際應用程式的驗證環境。
- [GeneratorCommand — 自訂 make: 指令的實作](https://kawax.biz/zh-TW/advanced/generator-command.md): 說明如何繼承 Illuminate\Console\GeneratorCommand，建立套件專屬的 make: 指令。從 stub 檔案的建立到命名空間的控制，實務地介紹。
- [Laravel 啟動套件的建立方式](https://kawax.biz/zh-TW/advanced/starter-kit-creation.md): 說明如何建立 Laravel 啟動套件、發布至 Packagist，並持續因應 Laravel 與前端版本升級的實務流程。
- [套件的靜態分析（PHPStan / Larastan）](https://kawax.biz/zh-TW/advanced/package-static-analysis.md): 說明使用 PHPStan 與 Larastan 提升 Laravel 套件的型別安全性與可維護性所需的設定、型別註解、以及 CI 自動執行。

#### 應用程式結構

- [Laravel 11 以後的應用程式結構](https://kawax.biz/zh-TW/advanced/app-structure.md): 解說 Laravel 11 導入的 Slim Application Skeleton 全貌，以及 Application::configure() 到 ApplicationBuilder 的內部實作。
- [從舊結構到新結構的遷移指南](https://kawax.biz/zh-TW/advanced/app-structure-migration.md): 說明從 Laravel 10 舊應用程式結構遷移至 Laravel 11 以後 Slim Application Skeleton 的步驟。
- [Laravel 11 以後的新應用程式結構 FAQ](https://kawax.biz/zh-TW/advanced/app-structure-faq.md): 整理了遷移到 Laravel 11 以後 Slim Application Skeleton 時常見的疑問與解答。適合中途加入仍維持舊結構升級的專案，或以舊書籍與教學學習的讀者。

#### Laravel 13 新功能

- [PHP Attributes](https://kawax.biz/zh-TW/advanced/php-attributes.md): 說明如何使用 Laravel 13 導入與強化的 PHP Attributes，以更宣告式的方式撰寫 Job 或 Model 的設定。
- [Controller 的 PHP Attributes](https://kawax.biz/zh-TW/advanced/controller-attributes.md): 解說如何使用 Laravel 13 新增的 #[Middleware]、#[WithoutMiddleware]、#[Authorize] attributes，以宣告式方式為 Controller 設定中介層與授權。

#### Eloquent 深入探索

- [Eloquent Observer 與模型事件](https://kawax.biz/zh-TW/advanced/eloquent-observers.md): 解說 Eloquent 模型觸發事件的機制，以及使用 Observer 類別統一管理事件的方法。也包含 `#[ObservedBy]` attribute 等 Laravel 13 的最新功能。
- [Eloquent 的 Scope](https://kawax.biz/zh-TW/advanced/eloquent-scopes.md): 解說本地 Scope 與 Global Scope 的機制。透過解讀 SoftDeletingScope 等框架內部實作，介紹多租戶、公開/非公開篩選等實用範例。
- [Eloquent 的自訂 Cast](https://kawax.biz/zh-TW/advanced/eloquent-casts.md): 解說如何實作 CastsAttributes 介面來建立自訂 cast。同時介紹 Value Object 模式、Inbound Cast、Castables 等進階模式。
- [Eloquent Bootable Traits](https://kawax.biz/zh-TW/advanced/eloquent-bootable-traits.md): 解說 Eloquent 模型自動啟動 trait 的機制。學習 `bootXxx()`、`initializeXxx()` 方法的命名慣例，以及以 PHP Attribute 明確指定的方式。這是套件開發中常用的模式。
- [自訂 Pivot Model 與 chaperone](https://kawax.biz/zh-TW/advanced/eloquent-custom-pivot.md): 說明如何將 belongsToMany 的中介資料表當作自訂 Pivot Model 處理，以及 Laravel 13 新增的 chaperone 自動 Eager Loading。

#### 驗證擴充

- [自訂驗證規則](https://kawax.biz/zh-TW/advanced/custom-validation-rules.md): 從框架內部實作層面說明如何以規則物件或 closure 擴充 Laravel 的驗證功能。

#### 認證擴充

- [自訂驗證 Guard 的實作](https://kawax.biz/zh-TW/advanced/custom-auth-guard.md): 理解 Laravel 驗證系統的內部結構，並從框架原始碼層面解說如何實作 Guard、StatefulGuard 介面以建立自訂驗證 Guard。
- [Laravel Fortify 與啟動套件](https://kawax.biz/zh-TW/advanced/fortify.md): 說明前端無關的驗證後端 Laravel Fortify 的內部設計。涵蓋現行啟動套件為何使用 Fortify、FortifyServiceProvider 的設定，以及 2FA、Passkey 的啟用。

#### 安全性

- [速率限制的自訂](https://kawax.biz/zh-TW/advanced/rate-limiting.md): 深入探討 Laravel 的 RateLimiter Facade，從依使用者、方案、IP 位址進行的自訂速率限制實作，到使用 Redis 的高可用設定。

#### 佇列

- [Queue Job 的執行控制](https://kawax.biz/zh-TW/advanced/queue-job-control.md): 說明如何使用 ShouldBeUnique、ShouldBeUniqueUntilProcessing、DebounceFor 控制 Queue Job 的重複執行與連續 dispatch。

#### 測試

- [使用 Pest 進行進階測試](https://kawax.biz/zh-TW/advanced/testing-pest.md): 系統性地說明自 Laravel 11 以後成為預設的 Pest 的進階用法，涵蓋 Expectation API、Dataset、Fake、Mockery。

#### 即時通訊

- [Mercure 廣播驅動的內部結構](https://kawax.biz/zh-TW/advanced/mercure-broadcasting.md): 以原始碼為基礎，解說 Laravel framework 新增的 Mercure 廣播驅動的運作方式。內容涵蓋與 Reverb、Pusher 不同的 HTTP/SSE 架構、授權 Cookie，以及端對端加密頻道。

### 部落格

#### 更新日誌

- [2026 年 8 月 Laravel 更新](https://kawax.biz/zh-TW/blog/changelog/202608.md): 2026 年 8 月的 Laravel 13、Laravel Cloud、Laravel Forge 官方更新。彙整 read-through 檔案系統、Scout 的 Turbopuffer 與語意搜尋、Cloud facade 及 MariaDB 向量搜尋支援。
- [2026 年 7 月 Laravel 更新](https://kawax.biz/zh-TW/blog/changelog/202607.md): 2026 年 7 月的 Laravel 13 與 Laravel Cloud 官方更新。彙整影像處理、條件式容器繫結、佇列管理、月度日誌、Laracon US 2026 的發表。
- [2026 年 6 月 Laravel 更新](https://kawax.biz/zh-TW/blog/changelog/202606.md): 2026 年 6 月 Laravel 生態系更新。Bus::bulk()、Postgres 交易 pooler 支援、MCP 用戶端／伺服器、artisan dev 指令、路由中繼資料等。
- [2026 年 5 月 Laravel 更新](https://kawax.biz/zh-TW/blog/changelog/202605.md): 2026 年 5 月 Laravel 生態系更新。@fonts Blade 指令、Interruptible Job、Subagent 支援、Cloud 的 Scale-to-Zero 等。
- [2026 年 4 月 Laravel 更新](https://kawax.biz/zh-TW/blog/changelog/202604.md): 2026 年 4 月 Laravel 生態系更新。Passkeys（無密碼認證）、Debounceable Jobs、MCP UI App、Redis Cluster 支援等。
- [2026 年 3 月 Laravel 更新](https://kawax.biz/zh-TW/blog/changelog/202603.md): 2026 年 3 月 Laravel 生態系更新。Laravel 13 發佈、AI SDK、JSON:API、Inertia v3 等大型更新總整理。

#### Laravel 13

- [Laravel 13 新功能彙總](https://kawax.biz/zh-TW/blog/laravel-13-new-features.md): 解析 2026 年 3 月釋出的 Laravel 13 的主要新功能與改進點。

#### 產品

- [Laravel Cloud — Laravel 專用 PaaS 全貌](https://kawax.biz/zh-TW/blog/laravel-cloud.md): 2025 年登場的 Laravel Cloud。解說與 Forge 的差異、擅長與不擅長的事，以及實際使用的好處。
- [Laravel Cloud Hibernation（自動休眠）](https://kawax.biz/zh-TW/blog/laravel-cloud-hibernation.md): 解說 Laravel Cloud 自動休眠功能的機制、啟用方式、限制事項，以及以 Path Blocking 避免不必要喚醒的做法。
- [Laravel Nightwatch 入門](https://kawax.biz/zh-TW/blog/nightwatch-introduction.md): 介紹 Laravel 託管 SaaS 型應用監控平台「Nightwatch」的概觀、與 Telescope／Pulse 的差異、安裝方式，以及在免費方案下實用地使用它所需的設定。
- [Laravel Cloud CLI — 從終端機操作 Laravel Cloud](https://kawax.biz/zh-TW/blog/laravel-cloud-cli.md): 使用 laravel/cloud-cli 從終端機管理 Laravel Cloud 的應用、環境、資料庫、網域等的方法。
- [AI Agent 從「正確」的程式碼邁向「有 Laravel 風格」的程式碼 - Boost Benchmarks 的下一步](https://kawax.biz/zh-TW/blog/boost-benchmarks-idiomatic-laravel.md): 根據 Laravel 官方部落格「AI agents pass tests. Can they write idiomatic Laravel?」，說明 Boost Benchmarks 從「測試通過」轉向衡量「每個 token 的正確性」與「Laravel 風格」的來龍去脈。
- [Laravel AI Agent 支援 MCP 伺服器](https://kawax.biz/zh-TW/blog/ai-sdk-mcp-client.md): 解說 Laravel AI SDK 與 Laravel MCP 新增的 MCP 用戶端功能。現在可將 MCP 伺服器的 tool 原封不動地整合到 Agent 的 tools() 內。

#### 套件介紹

- [⚡ Livewire 4 入門 — 不需要 JavaScript 就能打造響應式 UI](https://kawax.biz/zh-TW/blog/livewire-introduction.md): 使用 Laravel First-party 套件 Livewire 4，不需寫 JavaScript 就能建構互動式 UI 的方式。從安裝到實務程式碼皆有解說。
- [用 Inertia.js 建構 SPA](https://kawax.biz/zh-TW/blog/inertia-introduction.md): 介紹連結 Laravel 後端與 Vue／React／Svelte 前端的 Inertia.js v3。從無需 API 就能實現 SPA 的機制，到頁面元件、共用資料與表單處理，皆有實務性的解說。
- [用 Pest PHP 開始 Laravel 測試](https://kawax.biz/zh-TW/blog/pest-introduction.md): 以資深工程師觀點介紹自 Laravel 11 起成為預設的 Pest PHP。以實務導入為前提，解說與 PHPUnit 的差異、遷移成本以及 `arch()` 測試的活用。
- [Laravel Pennant 實務案例](https://kawax.biz/zh-TW/blog/laravel-pennant.md): 解說超越基本的 Laravel Pennant 實務模式。介紹以團隊為單位的 scope、緊急 kill switch、Dark Launch、管理指令等，官方文件未提及的技巧。
- [Laravel Telescope 實戰技巧](https://kawax.biz/zh-TW/blog/telescope-introduction.md): 介紹在本機開發中最大化 Telescope 效益的實用模式。N+1 檢測、使用 tag 追蹤、自訂 watcher、Dump watcher 的活用等，彙整了官方文件沒有的實用知識。
- [Laravel Wayfinder 介紹](https://kawax.biz/zh-TW/blog/wayfinder-introduction.md): 介紹在 Inertia starter kit 中取代 Ziggy 而被採用的套件 Laravel Wayfinder。從以型別安全連接 Laravel 後端與 TypeScript 前端的機制、與 Ziggy 的差異、安裝與基本用法，到 next 分支中演進的下一代功能，一次深入介紹。
- [Blaze 套件介紹](https://kawax.biz/zh-TW/blog/blaze-introduction.md): 解說如何用 Livewire 官方的 Blaze 加速 Blade 元件繪製。整理 compile / memo / fold 的選擇基準、安裝方式、限制事項與內部機制。

#### 新版存放庫調查

- [Laravel Multiplex — 統一管理本地開發程序的 TUI](https://kawax.biz/zh-TW/blog/multiplex-introduction.md): laravel/multiplex 的初期調查。解說 Laravel 13 的 php artisan dev 所使用、支援多程序 tab 顯示、搜尋與自動重啟的終端機 UI。
- [Laravel Maestro — 啟動套件開發的協調器](https://kawax.biz/zh-TW/blog/maestro-introduction.md): 調查 Laravel 官方新儲存庫「Maestro」。解說如何在一個 monorepo 內管理多個啟動套件變體，並有效率地接受貢獻的協調器機制。
- [laravel/agent-skills — Laravel 官方 AI Agent 技能集](https://kawax.biz/zh-TW/blog/agent-skills-introduction.md): 介紹 Laravel 官方維護的 AI Agent 技能儲存庫「laravel/agent-skills」。解說作為 Claude Code、Cursor 外掛提供的技能概觀、安裝方式與各技能細節。
- [Laravel 新程式碼分析生態系 — surveyor / ranger / roster](https://kawax.biz/zh-TW/blog/laravel-ecosystem-analysis.md): 介紹構成 Laravel 公開的靜態分析生態系的三個套件（surveyor、ranger、roster）。從 PHP 程式碼分析到套件偵測，解說套件開發者與工具作者應了解的新工具群。
- [Laravel Sentinel — 路由保護 Middleware 調查](https://kawax.biz/zh-TW/blog/sentinel-introduction.md): 解讀 laravel/sentinel 套件的原始碼。作為 driver 導向的路由保護 middleware，解說如何守護 Telescope、Horizon、Pulse 等管理工具。
- [Laravel Passkeys 初步調查（passkeys-server + @laravel/passkeys）](https://kawax.biz/zh-TW/blog/passkeys-introduction.md): 初步調查 laravel/passkeys-server（PHP）與 @laravel/passkeys（npm）。整理安裝、User Model 整合、路由、設定、事件、前端 API、型別化錯誤與 SSR 對應。
- [Laravel Agent Detector — AI Agent 偵測套件](https://kawax.biz/zh-TW/blog/agent-detector-introduction.md): laravel/agent-detector 的使用方式。解說偵測 Claude、Copilot、Cursor 等主要 AI Agent 執行環境的 Laravel 官方套件。
- [Laravel PAO — 針對 AI Agent 的輸出最佳化工具](https://kawax.biz/zh-TW/blog/pao-introduction.md): 介紹 laravel/pao。將 PHPUnit、Pest、PHPStan、Artisan 的輸出於 AI Agent 環境下壓縮為 JSON，最多可減少 99.8% token 消耗的 Laravel 官方套件。
- [Laravel Chisel — 啟動套件的安裝後腳本函式庫](https://kawax.biz/zh-TW/blog/chisel-introduction.md): 介紹 laravel/chisel。此套件提供用來從啟動套件移除不需要功能的安裝後腳本原語。v0.1 於 2026 年 5 月公開。
- [Laravel LSP — 以 Language Server Protocol 擴充 IDE 功能](https://kawax.biz/zh-TW/blog/laravel-lsp-introduction.md): Laravel 官方的 Language Server Protocol 實作。為編輯器提供框架感知的補完與 hover 功能。
- [laravel/symfony-on-cloud — 在 Laravel Cloud 上執行 Symfony 應用](https://kawax.biz/zh-TW/blog/symfony-on-cloud-introduction.md): Laravel 官方新 repository 調查。解說可讓 Symfony Messenger 的託管佇列在 Laravel Cloud 上使用的官方 Symfony bundle。
- [Laravel Package Skeleton — 官方套件用起始模板](https://kawax.biz/zh-TW/blog/package-skeleton-introduction.md): 初步調查 laravel/package-skeleton。彙整 Laravel 套件開發最佳實踐的官方起始模板。內建 Pest、Larastan、Pint、Workbench、GitHub Actions CI 的完整組合。
- [Laravel Doctor — 應用診斷工具](https://kawax.biz/zh-TW/blog/laravel-doctor-introduction.md): 介紹 laravel/doctor。診斷設定、環境、基礎架構常見問題並自動修復安全項目的 Laravel 官方套件。以 php artisan doctor 指令執行，2026 年 7 月 28 日發佈。
- [cpx 2.0 — Composer Package Executor 全面重寫](https://kawax.biz/zh-TW/blog/cpx-introduction.md): 介紹 laravel/cpx。像 npx 一樣不需安裝就能執行 Composer 套件的工具。v2.0 全面重寫為自足式 PHAR，並新增本地執行檔優先執行、Gist 執行、別名等功能。

#### 升級指南

- [從 Laravel 12 升級到 13 指南](https://kawax.biz/zh-TW/blog/upgrade-12-to-13.md): 說明從 Laravel 12 升級至 Laravel 13 的步驟、破壞性變更、棄用功能與新功能亮點。
- [從 Laravel 11 升級到 12 指南](https://kawax.biz/zh-TW/blog/upgrade-11-to-12.md): 說明從 Laravel 11 升級至 12 的步驟與主要變更點
- [從 Laravel 10 升級到 11](https://kawax.biz/zh-TW/blog/upgrade-10-to-11.md): 說明從 Laravel 10 升級至 11 的步驟與主要變更點
- [從 Laravel 9 升級到 10](https://kawax.biz/zh-TW/blog/upgrade-9-to-10.md): 說明從 Laravel 9.x 升級到 10.x 的步驟與主要變更點
- [從 Laravel 8 升級到 9](https://kawax.biz/zh-TW/blog/upgrade-8-to-9.md): 說明從 Laravel 8.x 升級到 9.x 的步驟與主要變更點

#### 認證

- [從 laravel/ui 遷移到 Fortify 的指南](https://kawax.biz/zh-TW/blog/ui-to-fortify.md): 針對使用 laravel/ui 認證 scaffold 的既有專案，說明僅將認證後端遷移到 Fortify 的步驟。

#### 前端

- [Vue.js 入門 — 搭配 Inertia × Laravel 使用的基礎知識](https://kawax.biz/zh-TW/blog/vue-introduction.md): 介紹 Laravel 使用者最熟悉的 JS 框架 Vue.js。從 Options API / Composition API 的概觀，到 Inertia v3 × Vue 3 的頁面元件、useForm、共享資料，實用地一次講解。
- [React 入門 — 搭配 Inertia × Laravel 使用的基礎知識](https://kawax.biz/zh-TW/blog/react-introduction.md): Laravel + Inertia.js 使用 React 的入門指南。介紹自 laravel/ui 到目前啟動套件的歷史脈絡，並實務性地解說 useForm、usePage 等 Inertia React hook。
- [Svelte 入門 — 搭配 Inertia × Laravel 使用的基礎知識](https://kawax.biz/zh-TW/blog/svelte-introduction.md): Laravel + Inertia.js 中使用 Svelte 的入門指南。從編譯器導向的設計思路、Svelte 5 的 Runes 語法，到 useForm、usePage 等 Inertia Svelte hooks，實用地一次講解。

#### 環境建置

- [使用 Homebrew 安裝 PHP、Composer、Node.js（macOS）](https://kawax.biz/zh-TW/blog/mac-setup.md): 在 macOS 使用 Homebrew 安裝 PHP、Composer、Node.js，並建立 Laravel 開發環境的逐步指南。
- [在 WSL 中安裝 PHP、Composer 與 Node.js（Windows）](https://kawax.biz/zh-TW/blog/windows-setup.md): 在 Windows 10/11 上使用 WSL 2 安裝 PHP、Composer、Node.js，並建置 Laravel 開發環境的逐步指南。

## OpenAPI Specs

- [laravel-openapi](https://raw.githubusercontent.com/invokable/laravel-voicevox/refs/heads/main/docs/en/laravel-openapi.json)