> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# 进阶主题

> 面向包开发者与需要深入框架代码的高阶指南。涵盖设计模式、内部实现解析以及包开发所需的知识。

## 概述

本章节涵盖官方文档中不易了解的 Laravel 内部实现，以及聚焦于包开发的进阶主题。我们将结合源码解读，讲解实用的设计模式与扩展方法。

## 包开发

<CardGroup cols={2}>
  <Card title="Laravel 包开发" icon="package" href="/zh-CN/advanced/package-development">
    从以服务提供者为核心的包开发基础，到发布配置、视图、迁移文件的完整流程。
  </Card>

  <Card title="使用 Orchestra Testbench 测试 Laravel 包" icon="flask" href="/zh-CN/advanced/package-testing">
    使用 Orchestra Testbench 搭建包的测试环境，验证服务提供者、Facade 与数据库。
  </Card>

  <Card title="使用 Testbench Workbench 进行包开发" icon="wrench" href="/zh-CN/advanced/package-workbench">
    搭建接近真实应用的验证环境，构建包含路由、迁移、服务启动的开发流程。
  </Card>

  <Card title="包的版本兼容性管理" icon="code-branch" href="/zh-CN/advanced/package-versioning">
    应对 Laravel 与 PHP 版本升级的包维护策略，以及 GitHub Actions 测试矩阵配置。
  </Card>

  <Card title="GeneratorCommand — 实现自定义 make: 命令" icon="terminal" href="/zh-CN/advanced/generator-command">
    通过继承 GeneratorCommand 实现包专属的 `make:` 命令。
  </Card>
</CardGroup>

## 框架内部

<CardGroup cols={2}>
  <Card title="Laravel 11 之后的应用结构" icon="sitemap" href="/zh-CN/advanced/app-structure">
    全面解析 Slim Application Skeleton，以及从 Application::configure() 到 ApplicationBuilder 的内部实现。
  </Card>

  <Card title="Macroable trait" icon="puzzle-piece" href="/zh-CN/advanced/macroable">
    向现有 Laravel 类添加自定义方法的 Macroable trait 的机制与实践模式。
  </Card>

  <Card title="Conditionable trait" icon="git-branch" href="/zh-CN/advanced/conditionable">
    when()/unless() 方法的内部实现，以及用于设计流畅 API 的实践模式。
  </Card>

  <Card title="Illuminate\\Support\\Manager — 驱动系统剖析" icon="layers" href="/zh-CN/advanced/manager">
    自 Laravel 4.0 沿用至今的驱动系统核心类。从自定义驱动的注册到 MultipleInstanceManager。
  </Card>

  <Card title="Pipeline 模式" icon="arrow-right-arrow-left" href="/zh-CN/advanced/pipeline">
    Illuminate\Pipeline\Pipeline 类的原理，以及将多个处理步骤链式组合的模式。
  </Card>

  <Card title="InteractsWithData trait" icon="database" href="/zh-CN/advanced/interacts-with-data">
    在包开发中为自定义类实现数据访问 API 的 trait 设计详解。
  </Card>

  <Card title="tap() 辅助函数与 Tappable trait" icon="hand-point-right" href="/zh-CN/advanced/tap">
    Laravel tap() 辅助函数与 Tappable trait 的使用方式与实现模式。
  </Card>

  <Card title="PHP 属性" icon="tag" href="/zh-CN/advanced/php-attributes">
    使用 Laravel 13 引入并强化的 PHP 属性，以声明式方式配置 Job 与 Model。
  </Card>
</CardGroup>

## Eloquent 深入

<CardGroup cols={2}>
  <Card title="Eloquent 自定义类型转换" icon="arrows-rotate" href="/zh-CN/advanced/eloquent-casts">
    实现 CastsAttributes 接口的自定义 Cast。介绍 Value Object 模式、入站 Cast 与 Castables。
  </Card>

  <Card title="Eloquent Observer 与模型事件" icon="eye" href="/zh-CN/advanced/eloquent-observers">
    Eloquent 模型触发事件的机制，以及通过 Observer 类集中管理事件。
  </Card>

  <Card title="Eloquent 作用域" icon="filter" href="/zh-CN/advanced/eloquent-scopes">
    本地作用域与全局作用域的机制。从 SoftDeletingScope 等内部实现到实用场景。
  </Card>

  <Card title="Collection Deep Dive" icon="layer-group" href="/zh-CN/advanced/collection-deep-dive">
    从历史、类结构、PHPDoc Generics、阅读路径等多角度解析 Laravel Collection 的实现。
  </Card>

  <Card title="集合的高阶消息" icon="message" href="/zh-CN/advanced/higher-order-messages">
    集合的高阶消息（Higher-order Messages）的机制与实用用法。
  </Card>
</CardGroup>

## MCP 与 AI

<CardGroup cols={2}>
  <Card title="用 Laravel 构建 MCP 服务器" icon="server" href="/zh-CN/advanced/mcp-server">
    使用 laravel/mcp 包构建可用于生产环境的 MCP 服务器。涵盖 Tool、Resource、Prompt 的实现以及认证。
  </Card>

  <Card title="创建 AI SDK 的自定义 Provider" icon="robot" href="/zh-CN/advanced/ai-sdk-custom-provider">
    阅读 Laravel AI SDK 的源码，为标准未提供的 AI 服务实现自定义 Provider。
  </Card>

  <Card title="创建 Boost 的自定义 Agent" icon="wand-magic-sparkles" href="/zh-CN/advanced/boost-custom-agent">
    深入 Laravel Boost 的扩展架构，讲解如何创建自定义 Agent。
  </Card>
</CardGroup>

## 认证、验证及其他

<CardGroup cols={2}>
  <Card title="实现自定义认证 Guard" icon="shield" href="/zh-CN/advanced/custom-auth-guard">
    从源码层面讲解通过实现 Guard、StatefulGuard 接口来创建自定义认证 Guard 的方法。
  </Card>

  <Card title="自定义验证规则" icon="check-circle" href="/zh-CN/advanced/custom-validation-rules">
    深入内部实现，讲解如何通过规则对象或闭包扩展验证功能。
  </Card>

  <Card title="限流的自定义" icon="gauge" href="/zh-CN/advanced/rate-limiting">
    深入 RateLimiter Facade，按用户、套餐、IP 地址等实现自定义限流。
  </Card>

  <Card title="使用 Pest 进行进阶测试" icon="vial" href="/zh-CN/advanced/testing-pest">
    系统讲解 Pest 的进阶用法，涵盖 Expectation API、数据集、Fake 与 Mockery。
  </Card>
</CardGroup>


## Related topics

- [使用 Pest 进行进阶测试](/zh-CN/advanced/testing-pest.md)
- [GeneratorCommand — 实现自定义 make: 命令](/zh-CN/advanced/generator-command.md)
- [Welcome](/index.md)
- [用 Laravel 构建 MCP 服务器](/zh-CN/advanced/mcp-server.md)
- [Eloquent Observer 与模型事件](/zh-CN/advanced/eloquent-observers.md)
