获取 AcelleMail — $80

构建任何功能。无需 fork 核心代码。

AcelleMail 是一个基于 Laravel 11+ 的邮件营销平台，其扩展能力远不止于回调。发送驱动、支付网关、AI 代理、自定义管理员页面、页面级 UI 槽、REST 端点、生命周期监听器 — 每一项都以自包含插件的形式发布在您自己的命名空间下。这是完整的参考文档：11 篇深度文章，全部基于 storage/app/plugins/、App\Library\HookManager 与 app/Model/Plugin.php 中的规范代码路径。

从基础开始 ↓ 5 分钟 Hello World
扩展点
14
Hook 模式
4
深度文章
11
阅读时间
约 3 小时
源代码可溯
100%

如何使用本文档

如果您是从头开始，请按顺序阅读 — 每一页都建立在前一页基础上。如果您已经清楚自己需要什么，可以通过搜索直接进入某一页：每篇深度文章都是独立的，配有自己的面包屑、固定目录与上一篇/下一篇导航。

每篇文章中的每一个论断都可追溯到平台插件文档树下的源文件（docs/plugin/、docs/sending-server-polymorphism/、docs/payment-order-plan-subscription-saas/）或线上 storage/app/plugins/Aurius/ 实现。无法被引用的论断会被删除，而不是改写。

端到端阅读时间：约 3 小时。如果要发布一个真实插件，请预留半天 — Hello World 示例只需 5 分钟搭建脚手架，最长的实操示例（基于 Postal MTA 的发送驱动）从 plugin:init 到通过集成测试大约需要 1 小时。

01 — 基础

先建立心智模型。

三篇文章带您从「Composer、ServiceProvider，到底是什么？」走到自信写出第一个 Hook::add(...)。请按顺序阅读。其余文档默认您已掌握加载流程与四模式 Hook 分类法。

getting-started 已发布

快速入门

前置条件、php artisan plugin:init、脚手架生成的 8 个文件、composer.json 契约、激活生命周期，以及最常见的 7 个第一天错误 — 命名校验器、命名空间不匹配、缺失 autoload.psr-4、register() 与 boot() 的陷阱。

阅读 16 分钟 阅读 →
plugin-architecture 已发布

插件架构

启动时的加载流程：AppServiceProvider::boot → Plugin::autoloadWithoutDbQuery → storage/app/plugins/index.json。register() 与 boot() 的时机。为什么未激活插件依然会被 autoload，以及四种生命周期状态与两层注入。

阅读 18 分钟 阅读 →
hook-system 已发布

Hook 系统 — 四种模式

REGISTRY（add/collect）、EVENT（on/fire）、BEHAVIOR（set/perform）、FILTER（modify/filter） — 机制、核心代码的真实调用点、冲突语义、args-bag 约定、六个反模式以及四问决策树。

阅读 21 分钟 阅读 →
02 — 构建

发布一个真实功能。

针对最常被问及的四种模式的实操示例：新发送驱动（Postal MTA）、地区支付网关（Paddle）、自定义管理员 UI 界面（Aurius 聊天框）以及插件隔离的数据库表。

sending-drivers 已发布

发送驱动 — 完整插件模式

在不 fork 核心的前提下发布一个新的 MTA 后端。register_sending_server_driver 契约、驱动类 + 9 个能力标记、校验流水线、连接 blade、webhook 控制器、身份/预热。基于 Postal MTA 插件静态评审完整演示端到端。

阅读 19 分钟 阅读 →
payment-gateways 已发布

支付网关 — Cashier 契约

拉取模式，无 webhook。BillingManager 注册中心、四种能力接口、以 Paddle 为示例的实操、PaymentIntent 状态机，以及从 TBANK 默认货币教训中提炼的 5 条厂商边界纪律。

阅读 17 分钟 阅读 →
ui-injection 已发布

UI 注入 — 布局、侧边栏、页面槽

三个布局 REGISTRY 钩子（layout.head.assets、layout.body.before_close、admin.sidebar.groups）加上 page.{controller}.{action}.{slot} 契约。Aurius 的端到端聊天气泡模式、用于重定向的 FILTER 变体以及六个反模式。

阅读 16 分钟 阅读 →
database-models 已发布

数据库 & 模型 — 插件隔离

<plugin>/database/migrations/ 下的迁移、厂商前缀的表名、激活时执行 / 删除时回滚的生命周期、指向核心表的外键、$keepData 标志，以及 Aurius 14 个迁移的展示。

阅读 13 分钟 阅读 →
03 — 质量

做到生产级。

间接方式的翻译（主文件 → 运行时 dump）。register、activate、disable、delete 各状态的生命周期。通过核心 phpunit.xml 注册的 Pest 测试，每次 CI 都执行一次全新的 activate→test→delete 周期。

translations 已发布

翻译

主文件 → 运行时 dump 至 storage/app/data/plugins/... → 管理员可编辑。add_translation_file REGISTRY 钩子、双加载陷阱、十八语言约定，以及 translation:upgrade 的非破坏性合并。

阅读 13 分钟 阅读 →
lifecycle 已发布

插件生命周期

逐状态详解：register（5 步）、activate（4 步）、disable（仅状态翻转 — autoload + hooks 保留）、delete（回滚 + 主文件清理）。状态图、从异常状态的恢复，以及 plugin:* 控制台界面。

阅读 13 分钟 阅读 →
testing 已发布

测试

在宿主 phpunit.xml 中注册插件测试套件、带活跃行播种 + 每次请求 gate-cache 重置的 PluginTestCase 基类、面向 REGISTRY / EVENT / BEHAVIOR / FILTER 的 hooks-under-test 模式、activate-test-delete 生命周期集成配方，以及按插件的 CI 矩阵。

阅读 13 分钟 阅读 →
04 — 参考

阅读真实的生产代码。

最深入的学习发生在真实插件上，而不是 Hello World。Aurius 是规范的复杂插件 — 八个模型、十二个迁移、十八种语言。借助 showcase 把上面的每一个概念映射到一个正在发布的代码库上。

showcase 已发布

插件 showcase — Aurius

端到端走读这个规范的复杂插件 — 八个模型、十四个迁移、十八种语言、所有 hook 界面（六个 REGISTRY 贡献 + 两个 EVENT 监听器 + 一个 BEHAVIOR 覆盖）、聊天框 UI、测试基础设施，以及四步学习配方。

阅读 14 分钟 阅读 →
/api 已发布

REST API 参考

Token 认证、八种资源（Lists、Subscribers、Campaigns、Automations、Sending servers、Customers、Subscriptions、Plans）、六个生命周期 webhook 事件、三种按收件人的跟踪 ping 以及错误结构 — 插件使用的 API 与外部客户端使用的 API 完全一致。

端点目录 阅读 →
/kb 已发布

知识库

运维侧参考：服务器要求、supervisor 配置、queue worker、送达率调优、DKIM/SPF/DMARC 设置、迁移手册。当问题是「我如何运行 AcelleMail」而不是「我如何扩展它」时，请阅读这里。

运维中心 打开 →

设计哲学

核心声明扩展点。插件作出响应。
核心永远不知道您的插件存在。

依赖倒置

核心代码永远不会被插件导入，插件也永远不会被核心导入。Hook 系统位于两者之间，是唯一的契约。升级核心，您的插件依然工作 — 只要 hook 名称与签名保持稳定，我们都会进行版本标注。

只有四种模式

REGISTRY、EVENT、BEHAVIOR、FILTER — Hook 系统仅支持这四种动词。冲突语义按模式明确规定：REGISTRY 合并、EVENT 全触发、FILTER 链式、BEHAVIOR 独占（两个调用方会立刻抛错，绝不静默覆盖）。

您的命名空间，永远是您的

插件位于 MyVendor\MyPlugin\ 下，与核心平台命名空间完全隔离。组合、销售、白标、fork — 您的插件归您所有。Extended License 授予商业再分发权利。

事实来源：代码

本文档树中的每一页都链接其追溯的规范文件路径。如果文档与代码不一致，以代码为准 — 请提交 issue，我们更新文档，而非反之。没有遗留的复制粘贴，没有空想的 API。

打开源代码。扩展平台。

完整未加密 PHP。终身更新。Hook 系统。可学习的真实生产插件。一次性授权 — 无订阅、无按订阅者收费、无命名空间侵占。

购买 Extended License — $199 返回开发者首页

在您自己的服务器上,按您自己的方式运营邮件营销

加入数千家企业的行列,以完整源代码、零订阅费用、无限发送量掌控自己的邮件营销。$80 一次性授权,终身更新。

获取 AcelleMail — $80 一次性付款

Get the AcelleMail newsletter

Monthly issue with new releases, deliverability tips, and self-hosting playbooks. No spam.