入門

FriendsOfHyperf Components 是一組面向 Hyperf 3.2 的獨立元件，採用 monorepo 統一維護。 你可以安裝完整元件集，也可以只安裝應用需要的單個元件。

環境要求

• PHP 8.2 或更高版本
• Hyperf 3.2
• 根據 Hyperf 應用選擇 Swoole 或 Swow

安裝完整元件集

composer require friendsofhyperf/components

聚合包會替代所有獨立元件包，並註冊其中可用的 ConfigProvider。

安裝單個元件

composer require friendsofhyperf/cache

將 cache 替換為元件目錄中的包名。大多陣列件會透過 Hyperf 元件發現機制自動註冊；如果元件提供配置檔案，請按對應元件頁面的說明發布配置。

選擇元件

• 開發與診斷：Telescope、Tinker、Web Tinker、IDE Helper
• 資料庫與模型：Model Factory、Model Observer、Compoships、Fast Paginate
• 基礎設施：Cache、Lock、Config Consul、Redis Subscriber
• 安全與驗證：Encryption、Purifier、reCAPTCHA、Validated DTO
• 通訊與訊息：Mail、Notification、EasySms、AMQP Job、TCP Sender

完整分類請檢視元件目錄。

後續步驟

1. 開啟元件頁面，確認依賴和環境要求。
2. 安裝對應的獨立元件包。
3. 在元件要求時釋出配置。
4. 為應用中的整合行為新增有針對性的測試。