AcelleMail を購入 — $80

コアを fork せずに、なんでも作る。

AcelleMail はコールバックを大きく超える拡張表面を備えた Laravel 11+ のメールマーケティングプラットフォームです。送信ドライバー、決済ゲートウェイ、AI エージェント、カスタム管理ページ、ページレベルの UI スロット、REST エンドポイント、ライフサイクルリスナー — そのいずれもが、自前の名前空間下に self-contained なプラグインとして出荷できます。本書は完全リファレンスです。storage/app/plugins/、App\Library\HookManager、app/Model/Plugin.php の標準コードパスに対してソース根拠付きで書かれた、11 個のディープダイブ。

基礎から始める ↓ 5 分で Hello World
拡張表面
14
Hook パターン
4
ディープダイブページ
11
読了時間
約 3 時間
ソース根拠
100%

本ドキュメントの読み方

新規であれば順番に読み進めてください — 各ページは前のページの上に積み上がります。必要なものが既に分かっている場合は、検索から直接 1 ページに着地して問題ありません。各ディープダイブは独自のパンくず、固定 TOC、prev/next ナビゲーションを備え、単独で完結します。

各ページの各主張は、プラットフォームのプラグインドキュメントツリー (docs/plugin/、docs/sending-server-polymorphism/、docs/payment-order-plan-subscription-saas/) または稼働中の storage/app/plugins/Aurius/ 実装にあるソースファイルへ遡れます。引用できない主張は削除し、言い換えはしません。

エンドツーエンドの読了時間: 約 3 時間。実プラグインを出荷するには 1 日の半分を見込んでください — Hello World サンプルはスキャフォルドに 5 分、最長の実例 (Postal MTA の送信ドライバー) は plugin:init から統合テスト通過まで約 1 時間です。

01 — 基礎

まず頭の中のモデルを作る。

「Composer、ServiceProvider、ってなに?」の状態から、最初の Hook::add(...) を自信を持って書けるところまで導く 3 ページ。順番にお読みください。残りのドキュメントは、このロードフローと 4 パターンのフック分類を前提とします。

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 される理由、4 つのライフサイクル状態、2 つの注入レイヤー。

読了 18 分 読む →
hook-system 公開中

Hook システム — 4 つのパターン

REGISTRY (add/collect)、EVENT (on/fire)、BEHAVIOR (set/perform)、FILTER (modify/filter) — 仕組み、コア内の実呼び出し箇所、パターンごとのコンフリクト挙動、args-bag 規約、6 つのアンチパターン、4 問の意思決定ツリー。

読了 21 分 読む →
02 — 構築

実際の機能を出荷する。

最もよく聞かれる 4 パターンの実例: 新しい送信ドライバー (Postal MTA)、地域決済ゲートウェイ (Paddle)、カスタム管理 UI 表面 (Aurius チャットボックス)、プラグイン分離データベーステーブル。

sending-drivers 公開中

送信ドライバー — フルプラグインパターン

コアを fork せずに新しい MTA バックエンドを出荷する。register_sending_server_driver 契約、ドライバークラス + 9 つの capability マーカー、バリデーションパイプライン、接続 Blade、Webhook コントローラ、Identity / Warmup。Postal MTA プラグインの静的レビューに対してエンドツーエンドで解説。

読了 19 分 読む →
payment-gateways 公開中

決済ゲートウェイ — Cashier 契約

プルモデル、Webhook なし。BillingManager レジストリ、4 つの capability Interface、Paddle を題材とした実例、PaymentIntent ステートマシン、TBANK の通貨デフォルトの教訓に基づくベンダー境界規律 5 ルール。

読了 17 分 読む →
ui-injection 公開中

UI 注入 — レイアウト、サイドバー、ページスロット

3 つのレイアウト REGISTRY フック (layout.head.assets、layout.body.before_close、admin.sidebar.groups) と page.{controller}.{action}.{slot} 契約。Aurius のチャットボックスバブルパターンをエンドツーエンドで、リダイレクト用 FILTER バリアントと 6 つのアンチパターンも。

読了 16 分 読む →
database-models 公開中

データベース & モデル — プラグイン分離

<plugin>/database/migrations/ 配下のマイグレーション、ベンダー接頭辞付きテーブル名、activate-runs / delete-rolls-back ライフサイクル、コアテーブルへの外部キー、$keepData フラグ、14 マイグレーションの Aurius ショーケース。

読了 13 分 読む →
03 — 品質

本番グレードに仕上げる。

翻訳は間接方式 (マスターファイル → ランタイムダンプ)。register、activate、disable、delete の状態別ライフサイクル。コアの phpunit.xml 経由で登録された Pest テストと、CI 実行ごとの activate → test → delete サイクル。

translations 公開中

翻訳

マスターファイル → storage/app/data/plugins/... 配下のランタイムダンプ → 管理者編集可能。add_translation_file REGISTRY フック、二重ロードのトラップ、18 ロケール規約、translation:upgrade による非破壊マージ。

読了 13 分 読む →
lifecycle 公開中

プラグインライフサイクル

状態別ウォークスルー: register (5 ステップ)、activate (4 ステップ)、disable (ステータスフリップのみ — autoload + フックは生存)、delete (ロールバック + マスターファイルクリーンアップ)。ステート図、壊れた状態からの復旧、plugin:* コンソール表面。

読了 13 分 読む →
testing 公開中

テスト

ホスト phpunit.xml へのプラグイン testsuite 登録、active 行シード + リクエスト毎の gate-cache リセットを備えた PluginTestCase ベースクラス、REGISTRY / EVENT / BEHAVIOR / FILTER 用の hooks-under-test パターン、activate-test-delete ライフサイクル統合レシピ、プラグイン別 CI マトリクス。

読了 13 分 読む →
04 — リファレンス

実際の本番コードを読む。

最も深い学びは Hello World ではなく実プラグインから得られます。Aurius は標準的な複雑プラグイン — 8 モデル、12 マイグレーション、18 ロケール。上記すべての概念を 1 つの出荷コードベースにマッピングするためにショーケースを活用してください。

showcase 公開中

プラグインショーケース — Aurius

標準的な複雑プラグインをエンドツーエンドで解説 — 8 モデル、14 マイグレーション、18 ロケール、すべてのフック表面 (REGISTRY コントリビューション 6 件 + EVENT リスナー 2 件 + BEHAVIOR 上書き 1 件)、チャットボックス UI、テストインフラ、4 ステップの学習レシピ。

読了 14 分 読む →
/api 公開中

REST API リファレンス

トークン認証、8 つのリソース (Lists、Subscribers、Campaigns、Automations、Sending servers、Customers、Subscriptions、Plans)、6 つのライフサイクル Webhook イベント、受信者ごとの 3 種類のトラッキング ping、エラー形状 — プラグインが使う API と外部クライアントが使う API は同じものです。

エンドポイントカタログ 読む →
/kb 公開中

ナレッジベース

運用側のリファレンス: サーバー要件、supervisor 設定、キューワーカー、配送性チューニング、DKIM/SPF/DMARC のセットアップ、マイグレーションプレイブック。質問が「AcelleMail をどう運用するか」のときに読んでください。「どう拡張するか」ではありません。

運用ハブ 開く →

設計思想

コアが拡張点を宣言する。プラグインがそれに反応する。
コアはあなたのプラグインの存在を知ることがない。

依存関係の反転

コアコードがプラグインから import されることはなく、プラグインがコアから import されることもありません。Hook システムだけが両者の間に置かれる唯一の契約です。コアをアップグレードしてもプラグインは動作し続けます — フック名とシグネチャが安定している限り。これらにはバージョンスタンプが付与されます。

4 パターンのみ

REGISTRY、EVENT、BEHAVIOR、FILTER — Hook システムが話す唯一の動詞です。コンフリクト挙動はパターンごとに明示的です: REGISTRY はマージ、EVENT は全件発火、FILTER はチェイン、BEHAVIOR は排他的 (2 呼び出しは即時に throw、暗黙の上書きはしません)。

あなたの名前空間は永続

プラグインは MyVendor\MyPlugin\ 配下に存在し、コアプラットフォームの名前空間からは完全に分離されています。組み立て、販売、ホワイトラベル、fork — プラグインはあなたのものです。Extended ライセンスは商用再配布を許諾します。

真実の源: コード

本書ツリーの各ページには、その内容を辿った標準ファイルパスがリンクされています。ドキュメントとコードが食い違っていた場合、コードが勝ちます — issue を立ててドキュメントを更新します。逆ではありません。レガシーのコピペや構想段階の API はありません。

ソースを開く。プラットフォームを拡張する。

完全な非暗号化 PHP。生涯アップデート。Hook システム。学べる実プラグイン群。買い切りライセンス — サブスクリプションなし、受信者単位の課金なし、名前空間の独占なし。

Extended ライセンスを購入 — $199 開発者ランディングに戻る

あなたのサーバーで、あなたのルールで Email マーケティングを運営

フルソースコード、定期課金なし、無制限送信で Email マーケティングを掌握した何千もの企業に加わりませんか。一度の $80 ライセンス、永続アップデート。

AcelleMail を購入 — $80 買い切り

Get the AcelleMail newsletter

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