Sync Serverには、同期データの保存後にイベントを受け取るプラグイン機構があります。詳細な公開仕様・開発ガイドは現在整備中です。

現在の仕組み

サーバーのplugins/<id>/plugin.phpに配置したPHPコードから、pack.stored、operations.stored、device.revokedのイベントを受け取れます。operations.storedには平文の操作データが含まれます。イベントは管理画面のメンテナンス操作、またはphp bin/maintenance.phpの実行時に配送されます。

配送は少なくとも1回で、同じeventIdが複数回届くことがあります。プラグインの例外で、保存済みのSyncPackは取り消されません。

セキュリティと公開予定

プラグインはサーバーのPHPプロセス内で動く信頼済みコードであり、隔離されたサンドボックスではありません。同期データを読み取れるため、信頼できるコードだけを設置してください。実運用プラグインや秘密情報は公開リポジトリに含めないでください。

イベントの引数や互換性など、開発者向けの正式な仕様は工事中です。