# Knowledge of Laravel: Simplified Chinese

## Simplified Chinese

- [Simplified Chinese / 我的包 (142 pages)](https://kawax.biz/_llms/zh-hans/tab.md): Documentation for Simplified Chinese / 我的包.

### 教程

#### 入门

- [什么是 Laravel](https://kawax.biz/zh-CN/introduction.md): 介绍 Laravel 的概况与特性，并阐述为什么应该选择 Laravel。
- [开始学习 Laravel 前需要具备的知识](https://kawax.biz/zh-CN/true-tutorial.md): 整理学习 Laravel 前必须掌握的四大领域，指引你先掌握相关基础知识。
- [安装](https://kawax.biz/zh-CN/installation.md): 介绍 Laravel 的安装步骤以及 PHP 环境的搭建方法。
- [目录结构](https://kawax.biz/zh-CN/directory-structure.md): 介绍 Laravel 项目主要目录与文件的作用。
- [配置](https://kawax.biz/zh-CN/configuration.md): 介绍 Laravel 的配置文件、环境变量（.env）、配置值的读取方式、缓存、调试模式以及维护模式。

#### 基础

- [路由](https://kawax.biz/zh-CN/routing.md): 介绍 Laravel 中定义路由的方式、路由参数、命名路由等基础知识。
- [视图](https://kawax.biz/zh-CN/views.md): 介绍如何在 Laravel 中创建视图并从路由或控制器中返回，以及如何向视图传递数据。
- [Blade 模板](https://kawax.biz/zh-CN/blade.md): 介绍 Laravel 内置模板引擎「Blade」的基本语法、条件分支、循环与布局继承。
- [URL 生成](https://kawax.biz/zh-CN/urls.md): 介绍 Laravel 的 url() 辅助函数、命名路由 URL、签名 URL、控制器动作 URL 的生成方式。

#### 请求处理

- [控制器](https://kawax.biz/zh-CN/controllers.md): 介绍 Laravel 中如何创建控制器以及如何与路由配合。
- [中间件](https://kawax.biz/zh-CN/middleware.md): 介绍如何使用 Laravel 中间件对 HTTP 请求进行过滤与预处理。
- [HTTP 请求](https://kawax.biz/zh-CN/requests.md): 介绍如何通过 Laravel 的 Illuminate\Http\Request 对象来获取 HTTP 请求中的数据。
- [校验](https://kawax.biz/zh-CN/validation.md): 介绍如何使用 Laravel 的校验功能来验证表单输入数据。
- [响应](https://kawax.biz/zh-CN/responses.md): 介绍 Laravel 中的各种响应类型，以及如何在控制器中返回合适的响应。
- [Session](https://kawax.biz/zh-CN/session.md): 如何使用 Laravel 的 HTTP Session 在多次请求之间保存数据。

#### 数据库

- [数据库迁移](https://kawax.biz/zh-CN/migrations.md): 介绍如何使用 Laravel 的迁移功能对数据库结构进行版本管理。
- [数据库填充（Seeding）](https://kawax.biz/zh-CN/seeding.md): 介绍如何使用 Laravel 的填充功能向数据库中写入用于开发和测试的示例数据。
- [Eloquent 入门](https://kawax.biz/zh-CN/eloquent.md): 介绍如何使用 Laravel 的 ORM「Eloquent」操作数据库数据。
- [Eloquent 关联入门](https://kawax.biz/zh-CN/eloquent-relationships.md): 介绍如何使用 Eloquent 定义表之间的关联（一对一、一对多、多对多）以及高效获取关联数据。
- [Eloquent 工厂](https://kawax.biz/zh-CN/eloquent-factories.md): 介绍如何使用模型工厂高效生成测试与数据填充所需的假数据。

#### 认证

- [认证入门](https://kawax.biz/zh-CN/authentication.md): 介绍 Laravel 认证功能的基础知识。从使用启动套件搭建认证系统到获取已登录用户的方法都会讲到。
- [启动套件](https://kawax.biz/zh-CN/starter-kits.md): 使用 Laravel 启动套件快速搭建认证与 UI 的方法。
- [Laravel Socialite（社交登录）](https://kawax.biz/zh-CN/socialite.md): 介绍如何使用 Laravel Socialite 简洁地实现基于 OAuth 2.0 的社交登录（GitHub、Google、Facebook 等）。

#### 辅助函数与外部通信

- [辅助函数](https://kawax.biz/zh-CN/helpers.md): 介绍 Laravel 提供的全局辅助函数以及 Arr、Number 类，并附上实用示例。
- [字符串操作（Str 类）](https://kawax.biz/zh-CN/strings.md): 介绍 Laravel Str 类以及 Stringable（Fluent Strings）的用法，附实用示例。
- [集合](https://kawax.biz/zh-CN/collections.md): 介绍如何使用 Laravel 的 Collection 类高效地操作数据。
- [HTTP 客户端](https://kawax.biz/zh-CN/http-client.md): 介绍如何使用 Laravel 的 HTTP 客户端向外部 API 发起请求。涵盖鉴权、超时、重试与测试。

#### 测试与部署

- [测试入门](https://kawax.biz/zh-CN/testing.md): 使用 Pest 与 PHPUnit 编写 Laravel 应用测试的方法。
- [HTTP 测试](https://kawax.biz/zh-CN/http-tests.md): 介绍如何使用 Laravel 的 HTTP 测试能力模拟请求、编写断言、进行认证测试和文件上传测试。
- [数据库测试](https://kawax.biz/zh-CN/database-testing.md): 使用 RefreshDatabase、Seeder、Factory 及专用断言高效编写 Laravel 数据库测试的方法。
- [Mock](https://kawax.biz/zh-CN/mocking.md): 使用 Laravel 的 Mock / 测试替身功能，将测试作为独立单元来执行的方法。
- [控制台测试](https://kawax.biz/zh-CN/console-tests.md): 学习如何在 Laravel 中测试 Artisan 命令（输入 / 输出期望值、退出码校验、控制台事件校验）。
- [部署](https://kawax.biz/zh-CN/deployment.md): 将 Laravel 应用部署到生产环境的配置、优化与运维指南。

#### AI 开发辅助

- [Laravel 与 AI 开发](https://kawax.biz/zh-CN/ai.md): Laravel 是最适合 AI 辅助开发的框架之一。通过 Laravel Boost 的 MCP 服务器集成、AI 指南与文档搜索 API，充分发挥 AI 编码代理的能力。

### 指南

#### 架构

- [请求生命周期](https://kawax.biz/zh-CN/lifecycle.md): 介绍 Laravel 应用如何处理 HTTP 请求以及 Console 命令。
- [服务容器](https://kawax.biz/zh-CN/service-container.md): 介绍如何使用 Laravel 的服务容器进行依赖注入，以及绑定的基础知识。
- [服务提供者](https://kawax.biz/zh-CN/service-providers.md): 介绍如何使用 Laravel 服务提供者注册与启动应用中的服务。
- [门面](https://kawax.biz/zh-CN/facades.md): 介绍 Laravel 门面（Facades）的机制与用法、实时门面、测试方式，以及与依赖注入的选择。
- [Contracts（契约）](https://kawax.biz/zh-CN/contracts.md): 介绍 Laravel Contracts 的作用、与门面的区别、通过类型提示注入的方式，以及自定义 Contract 的创建方法。

#### 数据库

- [数据库配置](https://kawax.biz/zh-CN/database.md): 介绍 Laravel 的数据库连接配置、读写分离、多连接、SQL 执行、查询监听以及事务的基础知识。
- [查询构建器](https://kawax.biz/zh-CN/query-builder.md): 介绍 Laravel `DB::table()` 查询构建器的基础与进阶用法，以及不使用 Eloquent 直接构建 SQL 的场景。
- [分页](https://kawax.biz/zh-CN/pagination.md): 介绍 Laravel 的分页功能。涵盖 paginate()、simplePaginate()、cursorPaginate() 的区别，Blade 中的展示、API 响应以及 URL 定制。
- [MongoDB](https://kawax.biz/zh-CN/mongodb.md): 在 Laravel 应用中使用 MongoDB。涵盖驱动安装、配置、Eloquent 模型、查询构造器，以及作为缓存和队列驱动的用法。
- [搜索](https://kawax.biz/zh-CN/search.md): Laravel 搜索能力全景介绍。教你如何根据不同场景选择全文检索、向量检索、重排序以及 Laravel Scout。

#### Eloquent

- [Eloquent API 资源](https://kawax.biz/zh-CN/eloquent-resources.md): 介绍如何将 Eloquent 模型转换为一致的 JSON API 响应。从资源类的创建到条件字段、分页配合的实践用法。
- [Eloquent 访问器、修改器与类型转换](https://kawax.biz/zh-CN/eloquent-mutators.md): 介绍在 Eloquent 模型属性读取和写入时进行值转换的机制，实践地讲解访问器、修改器的定义方式以及内置类型转换的用法。
- [Laravel Scout](https://kawax.biz/zh-CN/scout.md): 为 Eloquent 模型添加全文检索与语义检索能力的官方扩展包。支持 Meilisearch、Algolia、Typesense、Turbopuffer、database 引擎，并通过模型观察者自动同步索引。
- [Eloquent 序列化](https://kawax.biz/zh-CN/eloquent-serialization.md): 介绍如何将 Eloquent 模型转换为 JSON 与数组，如何控制属性的显示与隐藏、设置附加属性以及自定义日期格式。
- [Eloquent 集合](https://kawax.biz/zh-CN/eloquent-collections.md): 介绍 Illuminate\Database\Eloquent\Collection 的专用方法以及如何创建自定义集合。

#### 安全

- [授权（Gate 与 Policy）](https://kawax.biz/zh-CN/authorization.md): 介绍如何使用 Laravel 的 Gate 和 Policy 来管理用户的操作权限。
- [邮件验证（Email Verification）](https://kawax.biz/zh-CN/verification.md): 介绍如何在 Laravel 中实现邮件验证功能。你将学习模型准备、3 个路由的定义、verified 中间件、自定义以及事件。
- [CSRF 保护](https://kawax.biz/zh-CN/csrf.md): 介绍 CSRF 攻击的原理，以及 Laravel 13 通过 Origin 校验和令牌校验进行防御的方法。
- [Laravel Sanctum（API 令牌认证）](https://kawax.biz/zh-CN/sanctum.md): 介绍如何使用 Laravel Sanctum 实现 API 令牌认证与 SPA 认证。这是一款简洁轻量的认证包，从引入到实际用法都有涉及。
- [密码重置](https://kawax.biz/zh-CN/passwords.md): 在 Laravel 中实现密码重置功能的方法。
- [哈希（Hashing）](https://kawax.biz/zh-CN/hashing.md): 介绍如何使用 Laravel 的 Hash 门面进行安全的密码哈希与校验，涵盖 bcrypt 与 Argon2 算法的设置和用法。
- [加密（Encryption）](https://kawax.biz/zh-CN/encryption.md): 介绍如何使用 Laravel 的 Crypt 门面通过 AES-256-CBC 对数据进行加解密。涵盖 APP_KEY 的生成、模型转型（cast）、个人信息的安全存储等。
- [Precognition](https://kawax.biz/zh-CN/precognition.md): 在表单提交前实时执行服务端校验的 Laravel 功能。
- [Laravel Passport（OAuth2 服务器实现）](https://kawax.biz/zh-CN/passport.md): 介绍如何使用 Laravel Passport 实现 OAuth2 服务器。涵盖与 Sanctum 的区别、安装、客户端管理、Scope 与 Token 运维。

#### 事件

- [事件与监听器](https://kawax.biz/zh-CN/events.md): 学习使用 Laravel 事件系统让应用组件保持松耦合。

#### 邮件与通知

- [邮件发送](https://kawax.biz/zh-CN/mail.md): 介绍如何使用 Laravel Mailable 类发送邮件，从基础用法到 Markdown 邮件、队列发送。
- [通知（Notifications）](https://kawax.biz/zh-CN/notifications.md): 介绍如何使用 Laravel 的通知系统一次性向多个渠道（邮件、数据库、Slack 等）发送通知。

#### 支付

- [Laravel Cashier (Stripe)](https://kawax.biz/zh-CN/cashier.md): 使用 Laravel Cashier (Stripe) 实现订阅计费、单次支付、发票和 Webhook 的基本流程。

#### 异步处理

- [队列与任务](https://kawax.biz/zh-CN/queues.md): 介绍如何使用 Laravel 的队列（Queue）与任务（Job）来异步执行邮件发送、图片处理等耗时操作。
- [Laravel Horizon](https://kawax.biz/zh-CN/horizon.md): 介绍如何使用 Laravel Horizon 可视化管理与监控 Redis 队列。涵盖仪表板、平衡策略、Supervisor 配置以及通知。
- [并发处理](https://kawax.biz/zh-CN/concurrency.md): 介绍如何使用 Laravel 13 的 Concurrency Facade 同时执行多个任务，从而提升应用的性能。

#### 实时通信

- [广播](https://kawax.biz/zh-CN/broadcasting.md): 介绍如何使用 Laravel 广播与 Laravel Reverb 实现基于 WebSocket 的实时通信。
- [Laravel Reverb](https://kawax.biz/zh-CN/reverb.md): 为 Laravel 应用提供实时 WebSocket 通信的官方服务器包。

#### 调度

- [任务调度](https://kawax.biz/zh-CN/scheduling.md): 了解如何使用 Laravel 调度器优雅地管理定时任务。

#### 缓存与优化

- [缓存](https://kawax.biz/zh-CN/cache.md): 学习如何使用 Laravel 缓存系统提升应用性能。
- [Redis](https://kawax.biz/zh-CN/redis.md): Laravel 应用中使用 Redis 进行缓存、会话、队列和 Pub/Sub 的配置与操作方法。

#### 国际化

- [本地化](https://kawax.biz/zh-CN/localization.md): 介绍如何使用 Laravel 的多语言功能，通过 PHP 文件和 JSON 文件管理翻译字符串。

#### 文件与存储

- [文件存储](https://kawax.biz/zh-CN/filesystem.md): 介绍如何使用 Laravel 集成的 Flysystem 进行文件读写、上传以及对接云存储。
- [图像处理](https://kawax.biz/zh-CN/images.md): 介绍如何使用 Laravel 的 Image 门面对图像进行调整大小、裁剪、转换与保存。

#### 调试与监控

- [Context（上下文）](https://kawax.biz/zh-CN/context.md): 介绍如何使用 Laravel Context 功能在请求、任务、命令之间共享信息，并自动附加到日志中。
- [错误处理](https://kawax.biz/zh-CN/error-handling.md): 学习 Laravel 的异常处理机制。全面讲解异常的报告、渲染、自定义错误页面以及 HTTP 错误响应的生成。
- [日志记录](https://kawax.biz/zh-CN/logging.md): 学习如何使用 Laravel 的日志系统，将应用的运行情况记录到文件、Slack 或外部服务。
- [Laravel Pulse](https://kawax.biz/zh-CN/pulse.md): 介绍 Laravel Pulse 应用监控仪表盘的安装与配置。涵盖记录器、采样以及自定义卡片的实现。
- [Laravel Pennant](https://kawax.biz/zh-CN/pennant.md): 介绍如何使用 Laravel Pennant 管理功能开关（Feature Flags），涵盖功能定义、判断、作用域设置以及测试等内容。
- [Laravel Telescope](https://kawax.biz/zh-CN/telescope.md): 介绍如何引入 Laravel Telescope，包括本地专用安装、监视器（Watcher）配置等。

#### 控制台与 CLI

- [Artisan 控制台](https://kawax.biz/zh-CN/artisan.md): 介绍如何使用 Laravel 的 Artisan 控制台创建自定义 CLI 命令。
- [Laravel Prompts](https://kawax.biz/zh-CN/prompts.md): 介绍如何使用 laravel/prompts 扩展包为 Artisan 命令添加美观的交互式 UI。涵盖文本输入、选择、搜索、autocomplete、任务日志、流式输出等多种函数。
- [进程](https://kawax.biz/zh-CN/processes.md): 介绍如何使用 Laravel 的 Process Facade 执行外部 shell 命令，并简洁地处理同步、异步与并发调用。
- [Laravel Pint](https://kawax.biz/zh-CN/pint.md): 基于 PHP CS Fixer 构建的代码风格自动修复工具。介绍如何在团队中保持一致的编码风格。
- [浏览器测试（Dusk）](https://kawax.biz/zh-CN/dusk.md): 介绍如何使用 Laravel Dusk 通过 ChromeDriver 运行浏览器 E2E 测试。

#### 性能

- [Laravel Octane](https://kawax.biz/zh-CN/octane.md): 使用 FrankenPHP、Swoole、RoadRunner 大幅提升 Laravel 应用性能。

#### 前端

- [前端](https://kawax.biz/zh-CN/frontend.md): 帮助你判断 Laravel 13 中 Blade、Livewire、Inertia、React、Vue、Svelte、SPA、Vite 该如何组合的入门指南。
- [使用 Vite 打包资源](https://kawax.biz/zh-CN/vite.md): 介绍在 Laravel 项目中使用 Vite 打包 JavaScript 与 CSS，并借助热重载构建舒适开发环境的方法。
- [Laravel Folio](https://kawax.biz/zh-CN/folio.md): 介绍如何使用 Laravel Folio 实现基于文件的路由，从安装到路由模型绑定一应俱全。
- [Laravel Head](https://kawax.biz/zh-CN/head.md): 了解如何在 Blade、Livewire、Inertia 中使用 Laravel Head 管理文档 <head>。通过流畅的 API 配置 title、meta、Open Graph、canonical URL、robots、性能提示和结构化数据。

#### AI 开发

- [Laravel Boost](https://kawax.biz/zh-CN/boost.md): Laravel Boost 是一款加速 AI 辅助开发的包。它通过 MCP 服务器、AI 指南与 Agent Skills，让 AI 编码代理能够深入理解你的 Laravel 应用。
- [Laravel MCP](https://kawax.biz/zh-CN/mcp.md): 了解如何在 Laravel 应用中嵌入 Model Context Protocol (MCP) 服务器，为 AI 编码代理定义工具、资源与提示，让它们与你的应用对话。
- [Laravel AI SDK](https://kawax.biz/zh-CN/ai-sdk.md): Laravel AI SDK 完整指南：通过统一接口使用 OpenAI、Anthropic、Gemini 等多个 AI 提供商。涵盖智能体、图像生成、音频、嵌入以及测试。

#### 开发环境

- [Laravel Sail](https://kawax.biz/zh-CN/sail.md): 介绍如何使用 Laravel Sail 零配置搭建基于 Docker 的本地开发环境。
- [Envoy](https://kawax.biz/zh-CN/envoy.md): 介绍如何使用 Laravel Envoy 通过 Blade 语法在远程服务器上定义并执行部署任务与 Artisan 命令。

### 进阶主题

#### AI 开发

- [用 Laravel 构建 MCP 服务器](https://kawax.biz/zh-CN/advanced/mcp-server.md): 使用 laravel/mcp 包构建可用于生产环境的 MCP 服务器。涵盖工具、资源、提示的实现，以及认证、测试与部署等实战知识。
- [创建 Boost 的自定义 Agent](https://kawax.biz/zh-CN/advanced/boost-custom-agent.md): 深入 Laravel Boost 的扩展架构，讲解如何实现 SupportsGuidelines、SupportsMcp、SupportsSkills 契约的自定义 Agent。
- [创建 AI SDK 的自定义 Provider](https://kawax.biz/zh-CN/advanced/ai-sdk-custom-provider.md): 解读 Laravel AI SDK 的源码，讲解如何为标准未提供的 AI 服务实现自定义 Provider。

#### 设计模式

- [Pipeline 模式](https://kawax.biz/zh-CN/advanced/pipeline.md): 讲解 Illuminate
ipeline
ipeline 类的原理，以及将多个处理步骤以链式组合的 Pipeline 模式。
- [Fluent 类](https://kawax.biz/zh-CN/advanced/fluent.md): 讲解如何使用 Illuminate\Support\Fluent 类将数组数据当作对象来处理。这是 Laravel 早期就存在的隐藏便利类。
- [Macroable trait](https://kawax.biz/zh-CN/advanced/macroable.md): 讲解如何使用 Illuminate\Support\Traits\Macroable trait 向既有 Laravel 类添加自定义方法。
- [Conditionable trait](https://kawax.biz/zh-CN/advanced/conditionable.md): 讲解 when()/unless() 方法的内部实现与实践模式
- [InteractsWithTime trait](https://kawax.biz/zh-CN/advanced/interacts-with-time.md): 讲解队列、缓存、调度中都会用到的时间计算工具 trait，及其在实际项目中的用法
- [ForwardsCalls trait](https://kawax.biz/zh-CN/advanced/forwards-calls.md): 讲解如何使用 Illuminate\Support\Traits\ForwardsCalls 安全地在 Proxy/Decorator 类中转发方法调用。
- [tap() 辅助函数与 Tappable trait](https://kawax.biz/zh-CN/advanced/tap.md): 讲解 Laravel 的 tap() 辅助函数与 Illuminate\Support\Traits\Tappable trait 的用法与实现模式。
- [once() 辅助函数的内部实现 — Once、Onceable 与 PreventsCircularRecursion](https://kawax.biz/zh-CN/advanced/once-helper.md): 从 Illuminate\Support\Once 类与 Onceable 类的角度剖析全局函数 once() 的内部实现，并介绍其在 Eloquent 防循环引用 trait PreventsCircularRecursion 中的应用。
- [Dumpable trait](https://kawax.biz/zh-CN/advanced/dumpable.md): 讲解如何用 Illuminate\Support\Traits\Dumpable 为任意类添加 dump() / dd()，在不中断链式调用的情况下进行调试。
- [Support Contracts（Arrayable / Jsonable / Htmlable / Responsable）](https://kawax.biz/zh-CN/advanced/support-contracts.md): 基于 Laravel 13 官方源码，讲解 Illuminate\Contracts\Support 中 4 个主要契约。
- [Lottery 类](https://kawax.biz/zh-CN/advanced/lottery.md): 讲解如何使用 Illuminate\Support\Lottery 优雅地实现概率性操作。同时介绍在包开发中的用法与测试时的结果固定方法。
- [集合的高阶消息](https://kawax.biz/zh-CN/advanced/higher-order-messages.md): 集合的高阶消息（Higher-order Messages）的机制与实用用法
- [Collection Deep Dive](https://kawax.biz/zh-CN/advanced/collection-deep-dive.md): 从历史、类结构、PHPDoc Generics、阅读路径等多角度解析 Laravel Collection 的实现。
- [Illuminate\Support\Manager — 驱动系统剖析](https://kawax.biz/zh-CN/advanced/manager.md): 自 Laravel 4.0 沿用至今的驱动系统核心类。从自定义驱动的注册到 MultipleInstanceManager 的完整讲解。
- [PHP Reflection API](https://kawax.biz/zh-CN/advanced/php-reflection.md): 讲解 PHP Reflection API 的机制，及其在 Laravel IoC 容器与包开发中的应用。
- [PHP FFI](https://kawax.biz/zh-CN/advanced/ffi.md): 讲解 PHP FFI 的基础、可用环境，以及以 VOICEVOX Core for PHP 为例的实战包装模式。
- [PHP AST](https://kawax.biz/zh-CN/advanced/php-ast.md): 讲解 PHP AST（抽象语法树）的基础、PHP 内部 AST 的定位，以及基于 nikic/PHP-Parser 的实用代码解析与转换模式。

#### 包开发

- [Laravel 包开发](https://kawax.biz/zh-CN/advanced/package-development.md): 以服务提供者为核心，全面介绍 Laravel 包的开发方法，涵盖配置、视图、迁移、门面的发布，以及自动发现和延迟加载。
- [包自动发现的内部结构](https://kawax.biz/zh-CN/advanced/package-discovery.md): 深入解读 PackageManifest 类的内部实现，讲解 composer.json 中的 extra.laravel 如何被缓存并作为 bootstrap/cache/packages.php 加载。
- [InteractsWithData trait](https://kawax.biz/zh-CN/advanced/interacts-with-data.md): 讲解 Illuminate\Support\Traits\InteractsWithData 的设计，以及在包开发中为自定义类实现数据访问 API 的方法。
- [延迟 Service Provider](https://kawax.biz/zh-CN/advanced/deferred-provider.md): 讲解如何通过实现 DeferrableProvider 接口延迟加载服务。这是与包性能优化直接相关、看似朴素但十分重要的功能。
- [包的版本兼容性管理](https://kawax.biz/zh-CN/advanced/package-versioning.md): 从 composer.json 更新到 GitHub Actions 测试矩阵配置，实用地讲解应对 Laravel 与 PHP 主版本升级的包维护策略。
- [GitHub Actions 的固定与安全](https://kawax.biz/zh-CN/advanced/github-actions-pinning.md): 作为对包供应链攻击的防护措施，讲解将 GitHub Actions 依赖从版本号固定到 SHA 哈希的方法，包括 Dependabot 的自动更新策略。
- [包的 CHANGELOG 与发布管理](https://kawax.biz/zh-CN/advanced/package-changelog.md): 从 Laravel 包变更历史管理到 GitHub Release 自动化，讲解长期维护所需的发布管理实践。
- [使用 Orchestra Testbench 测试 Laravel 包](https://kawax.biz/zh-CN/advanced/package-testing.md): 讲解如何用 Orchestra Testbench 搭建 Laravel 包的测试环境，验证 Service Provider、Facade、配置以及数据库。
- [使用 Testbench Workbench 进行包开发](https://kawax.biz/zh-CN/advanced/package-workbench.md): 讲解如何使用 Orchestra Testbench Workbench 在包中打造包含路由、迁移、服务启动等接近真实应用的验证环境。
- [GeneratorCommand — 实现自定义 make: 命令](https://kawax.biz/zh-CN/advanced/generator-command.md): 讲解如何继承 Illuminate\Console\GeneratorCommand 为你的包实现独立的 make: 命令。实用地介绍从 stub 文件创建到命名空间控制的完整流程。
- [如何创建 Laravel Starter Kit](https://kawax.biz/zh-CN/advanced/starter-kit-creation.md): 讲解创建 Laravel Starter Kit、发布到 Packagist，并持续适配 Laravel 与前端版本升级的实操流程。
- [包的静态分析（PHPStan / Larastan）](https://kawax.biz/zh-CN/advanced/package-static-analysis.md): 使用 PHPStan 与 Larastan 提升 Laravel 包类型安全与可维护性的安装、配置、类型注解与 CI 自动化。

#### 应用结构

- [Laravel 11 之后的应用结构](https://kawax.biz/zh-CN/advanced/app-structure.md): 详细讲解 Laravel 11 引入的 Slim Application Skeleton 的全貌，以及从 Application::configure() 到 ApplicationBuilder 的内部实现。
- [旧结构到新结构的迁移指南](https://kawax.biz/zh-CN/advanced/app-structure-migration.md): 讲解将 Laravel 10 旧应用结构迁移到 Laravel 11 之后 Slim Application Skeleton 的完整步骤。
- [Laravel 11 之后新应用结构 FAQ](https://kawax.biz/zh-CN/advanced/app-structure-faq.md): 汇总迁移到 Laravel 11 之后 Slim Application Skeleton 时的常见疑问与解答。适合中途加入仍保留旧结构升级项目的开发者，或依据旧版书籍、教程学习的开发者。

#### Laravel 13 新特性

- [PHP 属性](https://kawax.biz/zh-CN/advanced/php-attributes.md): 讲解如何使用 Laravel 13 引入并强化的 PHP 属性，以更声明式的方式配置 Job 与 Model。
- [控制器的 PHP 属性](https://kawax.biz/zh-CN/advanced/controller-attributes.md): 介绍如何使用 Laravel 13 新增的 #[Middleware]、#[WithoutMiddleware]、#[Authorize] 属性，以声明式方式为控制器配置中间件与授权。

#### Eloquent 深入

- [Eloquent Observer 与模型事件](https://kawax.biz/zh-CN/advanced/eloquent-observers.md): 讲解 Eloquent 模型触发事件的机制，以及通过 Observer 类集中管理事件的方法。包含 `#[ObservedBy]` 属性等 Laravel 13 的最新特性。
- [Eloquent 作用域](https://kawax.biz/zh-CN/advanced/eloquent-scopes.md): 讲解本地作用域与全局作用域的机制。结合 SoftDeletingScope 等框架内部实现的解读，介绍多租户、公开/非公开筛选等实战用例。
- [Eloquent 自定义类型转换](https://kawax.biz/zh-CN/advanced/eloquent-casts.md): 讲解如何通过实现 CastsAttributes 接口创建自定义 Cast。同时介绍 Value Object 模式、入站 Cast、Castables 等进阶模式。
- [Eloquent Bootable Traits](https://kawax.biz/zh-CN/advanced/eloquent-bootable-traits.md): 深入解析 Eloquent 模型的 trait 自动启动机制。学习 bootXxx() 和 initializeXxx() 的命名规约，以及如何通过 PHP Attribute 显式指定 —— 这是包开发中常用的模式。
- [自定义 Pivot 模型与 chaperone](https://kawax.biz/zh-CN/advanced/eloquent-custom-pivot.md): 讲解如何把 belongsToMany 的中间表当作自定义 Pivot 模型使用，以及 Laravel 13 新增的 chaperone 自动预加载。

#### 验证扩展

- [自定义验证规则](https://kawax.biz/zh-CN/advanced/custom-validation-rules.md): 深入到框架内部实现，讲解如何通过规则对象或闭包扩展 Laravel 的验证功能。

#### 认证扩展

- [实现自定义认证 Guard](https://kawax.biz/zh-CN/advanced/custom-auth-guard.md): 深入了解 Laravel 认证系统的内部结构，并从框架源码层面讲解如何通过实现 Guard、StatefulGuard 接口来创建自定义认证 Guard。
- [Laravel Fortify 与 Starter Kit](https://kawax.biz/zh-CN/advanced/fortify.md): 讲解与前端解耦的认证后端 Laravel Fortify 的内部设计。涵盖当前 Starter Kit 为何采用 Fortify、FortifyServiceProvider 的配置、2FA、Passkey 的启用等。

#### 安全

- [限流的自定义](https://kawax.biz/zh-CN/advanced/rate-limiting.md): 深入 Laravel 的 RateLimiter Facade，讲解按用户、套餐、IP 地址实现自定义限流，以及基于 Redis 的高可用配置。

#### 队列

- [队列任务的执行控制](https://kawax.biz/zh-CN/advanced/queue-job-control.md): 介绍如何使用 ShouldBeUnique、ShouldBeUniqueUntilProcessing 和 DebounceFor 控制队列任务的重复执行与连续派发。

#### 测试

- [使用 Pest 进行进阶测试](https://kawax.biz/zh-CN/advanced/testing-pest.md): 系统讲解 Laravel 11 及以后默认的 Pest 的进阶用法，涵盖 Expectation API、数据集、Fake、Mockery。

#### 实时通信

- [Mercure 广播驱动内部机制](https://kawax.biz/zh-CN/advanced/mercure-broadcasting.md): 基于源码解读 Laravel framework 新增的 Mercure 广播驱动：与 Reverb、Pusher 不同的 HTTP/SSE 架构、授权 Cookie，以及端到端加密频道。

### 博客

#### Changelog

- [2026 年 8 月 Laravel 更新](https://kawax.biz/zh-CN/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-CN/blog/changelog/202607.md): 2026 年 7 月 Laravel 13 与 Laravel Cloud 的官方更新。汇总图像处理、条件容器绑定、队列管理、月度日志以及 Laracon US 2026 的发布内容。
- [2026 年 6 月 Laravel 更新](https://kawax.biz/zh-CN/blog/changelog/202606.md): 2026 年 6 月的 Laravel 生态更新。Bus::bulk()、Postgres 事务池支持、MCP 客户端/服务器、artisan dev 命令、路由元数据等。
- [2026 年 5 月 Laravel 更新](https://kawax.biz/zh-CN/blog/changelog/202605.md): 2026 年 5 月的 Laravel 生态更新。@fonts Blade 指令、Interruptible 作业、子智能体支持、Cloud Scale-to-Zero 等。
- [2026 年 4 月 Laravel 更新](https://kawax.biz/zh-CN/blog/changelog/202604.md): 2026 年 4 月的 Laravel 生态更新。Passkeys(无密码认证)、Debounceable Jobs、MCP UI App、Redis Cluster 支持等。
- [2026 年 3 月 Laravel 更新](https://kawax.biz/zh-CN/blog/changelog/202603.md): 2026 年 3 月的 Laravel 生态更新。Laravel 13 发布、AI SDK、JSON:API、Inertia v3 等大型更新汇总。

#### Laravel 13

- [Laravel 13 新功能汇总](https://kawax.biz/zh-CN/blog/laravel-13-new-features.md): 解析 2026 年 3 月发布的 Laravel 13 的主要新功能与改进点。

#### 产品

- [Laravel Cloud — Laravel 专用 PaaS 全貌](https://kawax.biz/zh-CN/blog/laravel-cloud.md): 2025 年登场的 Laravel Cloud。解析它与 Forge 的区别、擅长与不擅长的地方,以及实际使用的收益。
- [Laravel Cloud Hibernation(自动休眠)](https://kawax.biz/zh-CN/blog/laravel-cloud-hibernation.md): 解析 Laravel Cloud 自动休眠功能的原理、启用方法、限制,以及通过 Path Blocking 防止不必要唤醒。
- [Laravel Nightwatch 入门](https://kawax.biz/zh-CN/blog/nightwatch-introduction.md): 介绍 Laravel 官方托管的 SaaS 应用监控平台 Nightwatch 的概览、与 Telescope / Pulse 的差异、安装方法,以及在免费额度下也能实用起来的配置。
- [Laravel Cloud CLI —— 在终端里操作 Laravel Cloud](https://kawax.biz/zh-CN/blog/laravel-cloud-cli.md): 介绍如何使用 laravel/cloud-cli 在终端中管理 Laravel Cloud 上的应用、环境、数据库、域名等资源。
- [AI 智能体从写「正确」代码转向写「Laravel 风格」代码 —— Boost Benchmarks 的下一步](https://kawax.biz/zh-CN/blog/boost-benchmarks-idiomatic-laravel.md): 基于 Laravel 官方博客《AI agents pass tests. Can they write idiomatic Laravel?》，介绍 Boost Benchmarks 如何从「测试通过」转向衡量「每 token 的正确性」与「Laravel 风格」。
- [Laravel AI 智能体支持 MCP 服务器](https://kawax.biz/zh-CN/blog/ai-sdk-mcp-client.md): 介绍 Laravel AI SDK 和 Laravel MCP 中新增的 MCP 客户端功能。现在可以直接将 MCP 服务器的工具整合进智能体的 tools()。

#### 包介绍

- [⚡ Livewire 4 入门 —— 无需 JavaScript 也能做出响应式 UI](https://kawax.biz/zh-CN/blog/livewire-introduction.md): 通过 Laravel 的官方包 Livewire 4,不写 JavaScript 也能构建交互式 UI。从安装到实战代码逐步讲解。
- [使用 Inertia.js 构建 SPA](https://kawax.biz/zh-CN/blog/inertia-introduction.md): 介绍连接 Laravel 后端与 Vue/React/Svelte 前端的 Inertia.js v3。从无需 API 就能实现 SPA 的原理,到页面组件、共享数据、表单处理进行实战解析。
- [用 Pest PHP 开始 Laravel 测试](https://kawax.biz/zh-CN/blog/pest-introduction.md): 以资深工程师视角介绍从 Laravel 11 起成为默认的 Pest PHP。从与 PHPUnit 的差异、迁移成本,到 `arch()` 测试的用法,面向实际项目落地地进行讲解。
- [Laravel Pennant 实战用例](https://kawax.biz/zh-CN/blog/laravel-pennant.md): 介绍超出基础用法的 Laravel Pennant 实战模式。团队范围、紧急 kill switch、暗发布、管理命令等,分享官方文档不会告诉你的实践经验。
- [Laravel Telescope 实战技巧](https://kawax.biz/zh-CN/blog/telescope-introduction.md): 介绍在本地开发中充分利用 Telescope 的实战模式。涵盖 N+1 检测、通过标签追踪、自定义 watcher、Dump watcher 的活用等官方文档没有讲到的经验。
- [Laravel Wayfinder 介绍](https://kawax.biz/zh-CN/blog/wayfinder-introduction.md): 解析从 Ziggy 演进、在 Inertia 启动套件中被采用的 Laravel Wayfinder。从 Laravel 后端与 TypeScript 前端类型安全对接的机制、与 Ziggy 的差异、安装与基本用法,到在 next 分支中演进的下一代能力都做详细介绍。
- [Blaze 包介绍](https://kawax.biz/zh-CN/blog/blaze-introduction.md): 介绍如何使用 Livewire 官方的 Blaze 包加速 Blade 组件渲染。涵盖 compile / memo / fold 的选择标准、引入方法、限制事项以及内部工作原理。

#### 新仓库探索

- [Laravel Multiplex — 集中管理本地开发进程的 TUI](https://kawax.biz/zh-CN/blog/multiplex-introduction.md): laravel/multiplex 的初步调研。介绍 Laravel 13 的 php artisan dev 所使用的，支持多进程标签页显示、搜索与自动重启的终端 UI。
- [Laravel Maestro — 启动套件开发的编排器](https://kawax.biz/zh-CN/blog/maestro-introduction.md): 调查 Laravel 官方的新仓库 Maestro。解析这个用一个 monorepo 管理多个启动套件变体、以提升贡献效率的编排器的工作机制。
- [laravel/agent-skills — Laravel 官方 AI 智能体技能集](https://kawax.biz/zh-CN/blog/agent-skills-introduction.md): 介绍 Laravel 官方维护的 AI 智能体技能仓库 laravel/agent-skills。以 Claude Code、Cursor 插件形式提供的技能概览、安装方法以及各技能的详细说明。
- [Laravel 新代码分析生态 — surveyor / ranger / roster](https://kawax.biz/zh-CN/blog/laravel-ecosystem-analysis.md): 介绍构成 Laravel 官方静态分析生态的 3 个包(surveyor、ranger、roster)。从 PHP 代码分析到包检测,解析包开发者与工具作者应当了解的这套新工具。
- [Laravel Sentinel — 路由保护中间件调查](https://kawax.biz/zh-CN/blog/sentinel-introduction.md): 解读 laravel/sentinel 包的源代码。作为基于驱动的路由保护中间件,它是如何守护 Telescope、Horizon、Pulse 等管理工具的?本文进行解析。
- [Laravel Passkeys 初步调查(passkeys-server + @laravel/passkeys)](https://kawax.biz/zh-CN/blog/passkeys-introduction.md): 对 laravel/passkeys-server(PHP)与 @laravel/passkeys(npm)进行初步调查。整理安装、User 模型集成、路由、配置、事件、前端 API、带类型的错误以及 SSR 支持。
- [Laravel Agent Detector — AI 智能体检测包](https://kawax.biz/zh-CN/blog/agent-detector-introduction.md): 介绍 laravel/agent-detector 的使用方法。这是一个用于检测 Claude、Copilot、Cursor 等主流 AI 智能体运行环境的 Laravel 官方包。
- [Laravel PAO — 面向 AI 智能体的输出优化工具](https://kawax.biz/zh-CN/blog/pao-introduction.md): 介绍 laravel/pao。这是一个 Laravel 官方包,在 AI 智能体环境下把 PHPUnit、Pest、PHPStan、Artisan 的输出压缩为 JSON,最多可减少 99.8% 的 token 消耗。
- [Laravel Chisel — 启动套件的安装后脚本库](https://kawax.biz/zh-CN/blog/chisel-introduction.md): 介绍 laravel/chisel。这是一个为启动套件提供"安装后脚本"原语,用于删除启动套件中不需要功能的包。v0.1 于 2026 年 5 月发布。
- [Laravel LSP — 基于 Language Server Protocol 的 IDE 功能扩展](https://kawax.biz/zh-CN/blog/laravel-lsp-introduction.md): Laravel 官方的 Language Server Protocol 实现。为编辑器提供框架感知的补全与悬停功能。
- [laravel/symfony-on-cloud — 在 Laravel Cloud 上运行 Symfony 应用](https://kawax.biz/zh-CN/blog/symfony-on-cloud-introduction.md): 对 Laravel 官方新仓库的调查。介绍这个可以让 Symfony Messenger 的托管队列在 Laravel Cloud 上运行的官方 Symfony bundle。
- [Laravel Package Skeleton — 官方包开发用启动模板](https://kawax.biz/zh-CN/blog/package-skeleton-introduction.md): laravel/package-skeleton 的初步调查。这是一个汇集 Laravel 包开发最佳实践的官方启动模板。包含 Pest、Larastan、Pint、Workbench、GitHub Actions CI 的全套配置。
- [Laravel Doctor — 应用程序诊断工具](https://kawax.biz/zh-CN/blog/laravel-doctor-introduction.md): 介绍 laravel/doctor。这是一款诊断配置、环境、基础设施常见问题，并对安全项进行自动修复的 Laravel 官方包。通过 php artisan doctor 命令执行。2026 年 7 月 28 日发布。
- [cpx 2.0 — Composer Package Executor 全面重写](https://kawax.biz/zh-CN/blog/cpx-introduction.md): 介绍 laravel/cpx。这是一款像 npx 一样、无需安装即可执行 Composer 包的工具。在 v2.0 中被重写为自包含 PHAR，并加入了本地二进制优先执行、Gist 执行、别名功能等。

#### 升级指南

- [Laravel 12 升级到 13 指南](https://kawax.biz/zh-CN/blog/upgrade-12-to-13.md): Laravel 12 到 13 的升级步骤、破坏性变更、废弃功能以及新功能亮点解析。
- [Laravel 11 升级到 12 指南](https://kawax.biz/zh-CN/blog/upgrade-11-to-12.md): Laravel 11 到 12 的升级步骤与主要变更点解析。
- [Laravel 10 升级到 11](https://kawax.biz/zh-CN/blog/upgrade-10-to-11.md): Laravel 10 到 11 的升级步骤与主要变更点解析。
- [Laravel 9 升级到 10](https://kawax.biz/zh-CN/blog/upgrade-9-to-10.md): Laravel 9.x 到 10.x 的升级步骤与主要变更点解析。
- [Laravel 8 升级到 9](https://kawax.biz/zh-CN/blog/upgrade-8-to-9.md): Laravel 8.x 到 9.x 的升级步骤与主要变更点解析。

#### 认证

- [从 laravel/ui 迁移到 Fortify 的指南](https://kawax.biz/zh-CN/blog/ui-to-fortify.md): 面向使用 laravel/ui 认证脚手架的既有项目,只把认证后端迁移到 Fortify 的操作步骤。

#### 前端

- [Vue.js 入门 —— 与 Inertia × Laravel 搭配使用的基础](https://kawax.biz/zh-CN/blog/vue-introduction.md): 介绍对 Laravel 用户来说最熟悉的 JS 框架 Vue.js。从 Options API / Composition API 概览,到 Inertia v3 × Vue 3 中的页面组件、useForm、共享数据都会做实战讲解。
- [React 入门 —— 与 Inertia × Laravel 搭配使用的基础](https://kawax.biz/zh-CN/blog/react-introduction.md): 在 Laravel + Inertia.js 中使用 React 的入门指南。从 laravel/ui 到当前启动套件的历史沿革,再到 useForm、usePage 等 Inertia React hook 的实战讲解。
- [Svelte 入门 —— 与 Inertia × Laravel 搭配使用的基础](https://kawax.biz/zh-CN/blog/svelte-introduction.md): 在 Laravel + Inertia.js 中使用 Svelte 的入门指南。从编译器思路和 Svelte 5 的 runes 语法,到 useForm、usePage 等 Inertia Svelte hook,面向实战讲解。

#### 环境搭建

- [用 Homebrew 安装 PHP、Composer 和 Node.js(macOS)](https://kawax.biz/zh-CN/blog/mac-setup.md): 在 macOS 上用 Homebrew 安装 PHP、Composer、Node.js,搭建 Laravel 开发环境的分步指南。
- [用 WSL 安装 PHP、Composer 和 Node.js(Windows)](https://kawax.biz/zh-CN/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)