本文內容
發行公告
原子化 Lua 執行、原生成員去重、結構化進度遙測，以及嚴謹的相依性注入。了解 Sukarix 如何在不讓框架臃腫的前提下提供企業級能力，以及它如何驅動我們的 BigBlueButton Analytics 即時管線。
在打造關鍵任務的後端系統與即時串流管線時，每一毫秒、每一 MB 的記憶體都很重要。現代 PHP 已發展成兼具型別與速度的強大語言，但許多熱門的 PHP 框架卻反其道而行：累積了深層的繼承樹、沉重的反射開銷、臃腫的相依關係圖，以及動輒數 MB 的啟動負擔，讓長時間執行的 CLI worker 喘不過氣。
在 RIADVICE，我們為虛擬教室平台、即時分析引擎與高可用性負載平衡器打造高並行架構。我們需要一個框架，既有微框架的速度與簡潔，又具備複雜企業應用程式所需的企業級結構。
這個框架就是 Sukarix。今天，我們很榮幸宣布推出 Sukarix 0.4.0，帶來一套以 Redis 為基礎、專為多階段管線工作負載設計的穩健佇列引擎。
為什麼是 Sukarix？誕生於真實正式環境的挑戰
Sukarix 並不是一場學術練習。它是多年來在高流量正式環境中千錘百鍊的工程成果：處理數百萬筆 WebRTC 遙測事件、執行持續不斷的資料庫遷移，以及透過高負載反向代理轉送 API 呼叫。
Sukarix 建構在極速的 Fat-Free Framework（F3） 核心之上，保留了 F3 快如閃電的路由與極小的記憶體占用，同時加上現代企業必備的功能：
- 現代 PHP 8.4+ 與 8.5+ 架構： 完整的型別安全、嚴格型別，以及清晰的物件導向設計。
- 零臃腫的相依性注入（DI）與控制反轉（IoC）： 以 trait 為基礎動態初始化處理器，不受反射效能瓶頸拖累。
- 整合的正式環境工具： 一級支援 Monolog 整合、Tracy 除錯、Phinx 資料庫遷移，以及 Statera 測試工具組。
- 穩定優先，不追求頻繁變動： 升級只需極少的修改，讓正式環境的工作負載免受破壞性 API 重新設計的影響。
| 功能／指標 | Sukarix 0.4.0 | 重量級框架（Laravel／Symfony） | 一般微框架 |
|---|---|---|---|
| 記憶體占用（CLI／Web） | 極低（約 2 至 4 MB） | 沉重（約 15 至 35 MB） | 極低（約 2 至 3 MB） |
| 啟動與路由速度 | 不到一毫秒 | 開銷較高（複雜的中介軟體堆疊） | 不到一毫秒 |
| 管線佇列引擎 | 原生原子化 Lua 加上去重 | 通用佇列抽象層（開銷高） | 無（需自行實作） |
| 企業級工具（遷移、DI、日誌） | 內建並已預先設定 | 內建 | 缺乏，需自行零散組裝 |
| 相依關係圖複雜度 | 精簡，精選的 PSR 套件 | 數十個深層相依套件 | 極少 |
Sukarix 0.4.0 新功能：佇列更新
Sukarix 0.4.0 推出 Sukarix\Queue 命名空間：一套專門打造的高吞吐量 Redis FIFO 佇列架構，針對多階段非同步處理管線最佳化。
原子化 Lua 執行與自動去重
標準的 Redis 清單佇列在 worker 發生故障時，容易出現競爭條件或重複項目。Sukarix 的解法是將 Redis FIFO 清單與用來追蹤成員的配套集合搭配使用，並透過 原子化的 Redis Lua 指令碼 執行。推送一個已在佇列中的項目，會自動成為不執行任何動作的操作；而在操作途中被終止的 worker，也絕不會讓狀態陷入不一致的分裂。
逐項追蹤嘗試次數，不強加既定立場
Sukarix 不在佇列引擎內部強制套用僵化、帶有既定立場的重試或死信（dead-letter）上限，而是以 Redis hash 提供逐項的嘗試次數計數器。您的業務領域保有完全的自由，自行決定失敗的工作應該立即重試、延後執行、暫存待審查，還是轉入死信。
具備快速失敗初始化的 HasQueue trait
需要佇列功能的服務，只要使用 HasQueue 行為 trait 就能輕鬆注入。如果佇列服務沒有在注入器中註冊，Sukarix 會在啟動時拋出明確的 \LogicException，避免在正式環境執行期間發生難以追查的空指標當機。
結構化的 QueueProgressLogger 與 CLI 主控台日誌
Sukarix 0.4.0 為佇列生命週期事件（開始、批次進度、吞吐量與完成）新增結構化、機器可解析的日誌。酬載會經過清理（例如記錄為 array[3]），確保不會有任何敏感的客戶資料洩漏到日誌系統中。此外，LogWriter 現在也提供選用的彩色主控台日誌，方便即時監控 CLI worker。
程式碼範例：實際運作中的 worker 管線
// Worker implementation with HasQueue trait
namespace App\Workers;
use Sukarix\Behaviours\HasQueue;
use Sukarix\Behaviours\LogWriter;
use Sukarix\Core\Processor;
class EventIngestionWorker
{
use HasQueue, LogWriter;
public function __construct()
{
Processor::instance()->initialize($this);
}
public function consume(): void
{
while (null !== ($payload = $this->queueService->popFromQueue('queue.events.pending'))) {
try {
$this->processEvent($payload);
$this->queueService->clearAttempts('queue.events.failed', $payload);
} catch (\Throwable $e) {
$attempts = $this->queueService->incrementAttempts('queue.events.failed', $payload);
$this->logger->error('Failed processing item', ['attempts' => $attempts, 'error' => $e->getMessage()]);
}
}
}
}正式環境實績：驅動 BigBlueButton Analytics 即時管線
Sukarix 0.4.0 在真實的企業負載下表現如何？看看 RIADVICE 的 BigBlueButton Analytics 平台 就知道了，這是我們為 BigBlueButton 打造的即時分析引擎。
大規模的虛擬教室基礎架構，會在數百萬個同時發生的事件中產生龐大的細粒度事件數據：WebRTC 音訊與視訊串流、與會者的加入與離開、聊天訊息、投票互動、白板繪圖路徑、投影片切換等。要可靠地擷取這些數據，又不落後於進行中的課程，需要一條堅若磐石的串流管線。
在幕後，Sukarix 0.4.0 的 Redis 佇列負責協調，將龐大的原始事件串流轉換為結構化資料集，儲存在時間序列資料庫中，並透過 Apache Superset 呈現儀表板。這條管線直接受益於：
- 零重複擷取： 成員去重機制可避免伺服器推送多餘的同步脈衝時，指標被重複計算。
- worker 即時復原： 原子化的 Redis 交易確保 worker 重新啟動或節點擴展時，絕不會破壞佇列索引或遺失會議事件。
- 大幅提升資源效率： Sukarix 的 CLI worker 所消耗的記憶體只有其他框架的一小部分，因此數十個並行的佇列 worker 能在精簡的虛擬機器上從容運作。
- 高負載下的可觀測性： 結構化的
QueueProgressLogger能直接在日誌收集器中，即時呈現 worker 的吞吐量、批次完成情形與錯誤診斷資訊。
與 RIADVICE 一起擴展您的 BigBlueButton 基礎架構
無論您需要為大學或組織導入即用型的 BigBlueButton Analytics 即時儀表板、客製化的高效能資料處理管線，還是針對大規模 BigBlueButton 叢集的架構顧問諮詢，RIADVICE 都能為您提供協助。
升級至 Sukarix 0.4.0
Sukarix 0.4.0 完全是新增功能，不會為既有應用程式帶來任何破壞性變更。如果您在 PHP 8.4+ 上執行 Sukarix 0.3.x，可以立即透過 Composer 升級：
composer update sukarix/sukarix
完整的發行說明，請參閱 Sukarix GitHub Discussions。
標籤： Sukarix、PHP 8.5、PHP 框架、Redis 佇列、非同步處理、BigBlueButton、學習分析、教育科技、即時資料管線、RIADVICE、高效能 PHP、開源。
