PHPackages friendsofhyperf/components - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. friendsofhyperf/components ActiveLibrary[Utility & Helpers](/categories/utility) friendsofhyperf/components ========================== The most popular components for Hyperf. v3.1.78(4mo ago)11613↓100%28[1 issues](https://github.com/friendsofhyperf/components/issues)[1 PRs](https://github.com/friendsofhyperf/components/pulls)MITPHPPHP >=8.1CI passing Since May 21Pushed 2mo ago4 watchersCompare [ Source](https://github.com/friendsofhyperf/components)[ Packagist](https://packagist.org/packages/friendsofhyperf/components)[ Fund](https://hdj.me/sponsors/)[ GitHub Sponsors](https://github.com/huangdijia)[ RSS](/packages/friendsofhyperf-components/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (97)Versions (394)Used By (0) FriendsOfHyperf Components ========================== [](#friendsofhyperf-components) [![Latest Test](https://github.com/friendsofhyperf/components/workflows/tests/badge.svg)](https://github.com/friendsofhyperf/components/actions)[![Latest Stable Version](https://camo.githubusercontent.com/80d0a1fd6781a8ac18a9dcb92502202b1ff2ab1a2669feb206f2d3f7156d941d/68747470733a2f2f706f7365722e707567782e6f72672f667269656e64736f666879706572662f636f6d706f6e656e74732f76)](https://packagist.org/packages/friendsofhyperf/components)[![License](https://camo.githubusercontent.com/7fb10db1b172500f0b60db9fed5fb8a4528400d5e306a338690fa9e06d9ba091/68747470733a2f2f706f7365722e707567782e6f72672f667269656e64736f666879706572662f636f6d706f6e656e74732f6c6963656e7365)](https://packagist.org/packages/friendsofhyperf/components)[![PHP Version Require](https://camo.githubusercontent.com/6349cc3c8ff5eea84c684b35b2a60c9839bf3f830b2e4147e7413b9b528fe3fa/68747470733a2f2f706f7365722e707567782e6f72672f667269656e64736f666879706572662f636f6d706f6e656e74732f726571756972652f706870)](https://packagist.org/packages/friendsofhyperf/components)[![Hyperf Version Require](https://camo.githubusercontent.com/4d7150d3f60116cf859eb26e2a6459528d97cf1fa64a93e0d38253d79ca05c36/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6879706572662d2533453d332e312e302d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/friendsofhyperf/components)[![Ask DeepWiki](https://camo.githubusercontent.com/0f5ae213ac378635adeb5d7f13cef055ad2f7d9a47b36de7b1c67dbe09f609ca/68747470733a2f2f6465657077696b692e636f6d2f62616467652e737667)](https://deepwiki.com/friendsofhyperf/components) [中文说明](README_CN.md) 🚀 The most popular and comprehensive collection of high-quality components for the [Hyperf](https://hyperf.io) framework, providing 50+ production-ready packages to accelerate your application development. 📖 About ------- [](#-about) This repository is a **monorepo** containing a collection of battle-tested, community-driven components that extend the Hyperf framework with additional features and integrations. Each component is independently usable and can be installed separately or as a complete suite. ✨ Features ---------- [](#-features) - 🎯 **50+ Components** - Comprehensive collection covering various development needs - 🔌 **Easy Integration** - Seamless integration with Hyperf 3.1+ - 📦 **Modular Design** - Install only what you need - 🛡️ **Production Ready** - Battle-tested in production environments - 📚 **Well Documented** - Comprehensive documentation in multiple languages - 🧪 **Fully Tested** - High test coverage with PHPUnit and Pest - 🌍 **Multi-language** - Documentation available in Chinese (Simplified, Traditional, HK) and English 📋 Requirements -------------- [](#-requirements) - PHP >= 8.1 - Hyperf >= 3.1.0 - Swoole or Swow extension 💾 Installation -------------- [](#-installation) ### Install All Components [](#install-all-components) ``` composer require friendsofhyperf/components ``` ### Install Individual Components [](#install-individual-components) You can install specific components as needed: ``` # Example: Install Telescope (Debug Assistant) composer require friendsofhyperf/telescope # Example: Install HTTP Client composer require friendsofhyperf/http-client # Example: Install Model Factory composer require friendsofhyperf/model-factory --dev ``` 🎯 Quick Start ------------- [](#-quick-start) After installing a component, most packages will automatically register with Hyperf through the `ConfigProvider`. Some components may require publishing configuration files: ``` php bin/hyperf.php vendor:publish friendsofhyperf/[component-name] ``` 📦 Available Components ---------------------- [](#-available-components) ### 🔧 Development & Debugging Tools [](#-development--debugging-tools) - **[telescope](src/telescope)** - Elegant debug assistant for Hyperf (requests, exceptions, SQL, Redis, etc.) - **[tinker](src/tinker)** - Powerful REPL for interactive debugging - **[web-tinker](src/web-tinker)** - Web-based Tinker interface - **[ide-helper](src/ide-helper)** - Enhanced IDE support and autocompletion - **[pretty-console](src/pretty-console)** - Beautiful console output formatting ### 💾 Database & Models [](#-database--models) - **[model-factory](src/model-factory)** - Database model factories for testing - **[model-observer](src/model-observer)** - Eloquent model observers - **[model-scope](src/model-scope)** - Global and local query scopes - **[model-hashids](src/model-hashids)** - Hashids integration for models - **[model-morph-addon](src/model-morph-addon)** - Polymorphic relationship enhancements - **[compoships](src/compoships)** - Multi-column relationships for Eloquent - **[fast-paginate](src/fast-paginate)** - High-performance pagination - **[mysql-grammar-addon](src/mysql-grammar-addon)** - MySQL grammar extensions - **[trigger](src/trigger)** - MySQL trigger support ### 🗄️ Caching & Storage [](#️-caching--storage) - **[cache](src/cache)** - Advanced caching with multiple drivers - **[lock](src/lock)** - Distributed locking mechanisms - **[redis-subscriber](src/redis-subscriber)** - Redis pub/sub subscriber ### 🌐 HTTP & API [](#-http--api) - **[http-client](src/http-client)** - Elegant HTTP client (Laravel-style) - **[oauth2-server](src/oauth2-server)** - OAuth2 server implementation ### 📨 Notifications & Communication [](#-notifications--communication) - **[notification](src/notification)** - Multi-channel notifications - **[notification-mail](src/notification-mail)** - Email notification channel - **[notification-easysms](src/notification-easysms)** - SMS notification via EasySMS - **[mail](src/mail)** - Email sending component - **[tcp-sender](src/tcp-sender)** - TCP message sender ### 🔍 Search & Data [](#-search--data) - **[elasticsearch](src/elasticsearch)** - Elasticsearch client integration - **[telescope-elasticsearch](src/telescope-elasticsearch)** - Elasticsearch storage for Telescope ### ⚙️ Configuration & Infrastructure [](#️-configuration--infrastructure) - **[confd](src/confd)** - Configuration management with confd - **[config-consul](src/config-consul)** - Consul configuration center ### 🛠️ Command & Console [](#️-command--console) - **[command-signals](src/command-signals)** - Signal handling for commands - **[command-validation](src/command-validation)** - Command input validation - **[command-benchmark](src/command-benchmark)** - Command performance benchmarking - **[console-spinner](src/console-spinner)** - Console loading spinners ### 🧩 Dependency Injection & Architecture [](#-dependency-injection--architecture) - **[facade](src/facade)** - Laravel-style facades for Hyperf - **[ipc-broadcaster](src/ipc-broadcaster)** - Inter-process communication broadcaster ### 🔐 Security & Validation [](#-security--validation) - **[encryption](src/encryption)** - Data encryption and decryption - **[purifier](src/purifier)** - HTML purification (XSS protection) - **[recaptcha](src/recaptcha)** - Google reCAPTCHA integration - **[validated-dto](src/validated-dto)** - Data Transfer Objects with validation - **[grpc-validation](src/grpc-validation)** - gRPC request validation ### 🎨 Utilities & Helpers [](#-utilities--helpers) - **[helpers](src/helpers)** - Useful helper functions - **[support](src/support)** - Support utilities and classes - **[macros](src/macros)** - Macro support for various classes ### 📊 Monitoring & Logging [](#-monitoring--logging) - **[sentry](src/sentry)** - Sentry error tracking integration ### 🚀 Queue & Jobs [](#-queue--jobs) - **[amqp-job](src/amqp-job)** - AMQP-based job queue ### 🧪 Testing [](#-testing) - **[co-phpunit](src/co-phpunit)** - Coroutine-compatible PHPUnit ### 🤖 AI & External Services [](#-ai--external-services) - **[openai-client](src/openai-client)** - OpenAI API client ### 📝 Others [](#-others) - **[exception-event](src/exception-event)** - Exception event handling 📚 Documentation --------------- [](#-documentation) For detailed documentation, visit the [official documentation website](https://docs.hdj.me/). ### Documentation by Language [](#documentation-by-language) - [简体中文 (Simplified Chinese)](https://docs.hdj.me/zh-cn/) - [繁體中文 (Traditional Chinese)](https://docs.hdj.me/zh-tw/) - [香港繁體 (Hong Kong Traditional)](https://docs.hdj.me/zh-hk/) - [English](https://docs.hdj.me/en/) 🔨 Development ------------- [](#-development) ### Clone the Repository [](#clone-the-repository) ``` git clone https://github.com/friendsofhyperf/components.git cd components ``` ### Install Dependencies [](#install-dependencies) ``` composer install ``` ### Running Tests [](#running-tests) ``` # Run all tests composer test # Run specific test suites composer test:unit # Unit tests composer test:lint # Code style checks composer test:types # Type coverage analysis ``` ### Code Quality [](#code-quality) ``` # Fix code style composer cs-fix # Run static analysis composer analyse ``` 🤝 Contributing -------------- [](#-contributing) We welcome contributions from the community! Please read our [Contributing Guidelines](CONTRIBUTE.md) before submitting pull requests. ### Development Workflow [](#development-workflow) 1. Fork the repository 2. Create a feature branch (`git checkout -b feature/amazing-feature`) 3. Make your changes 4. Run tests and code quality checks 5. Commit your changes (`git commit -m 'Add amazing feature'`) 6. Push to the branch (`git push origin feature/amazing-feature`) 7. Open a Pull Request 🌟 Support & Community ------------------------- [](#-support--community) - 📖 **Documentation**: [docs.hdj.me](https://docs.hdj.me/) - 💬 **Issues**: [GitHub Issues](https://github.com/friendsofhyperf/components/issues) - 🐦 **Twitter**: [@huangdijia](https://twitter.com/huangdijia) - 📧 **Email**: 🔗 Mirrors --------- [](#-mirrors) - [GitHub](https://github.com/friendsofhyperf/components) - [CNB](https://cnb.cool/friendsofhyperf/components) 👥 Contributors -------------- [](#-contributors) We are grateful to all the contributors who have helped make this project better! [![Contributors](https://camo.githubusercontent.com/7d00783f6f88a357fb727dbbe7378b28579cde76e8a6b80ec63749b6cb975ca0/68747470733a2f2f636f6e747269622e726f636b732f696d6167653f7265706f3d667269656e64736f666879706572662f636f6d706f6e656e7473)](https://github.com/friendsofhyperf/components/graphs/contributors) 📄 License --------- [](#-license) This project is open-sourced software licensed under the [MIT License](LICENSE). --- Made with ❤️ by [Deeka Wong](https://github.com/huangdijia) and [contributors](https://github.com/friendsofhyperf/components/graphs/contributors) ### Health Score 56 — FairBetter than 97% of packages Maintenance88 Actively maintained with recent releases Popularity24 Limited adoption so far Community25 Small or concentrated contributor base Maturity76 Established project with proven stability Bus Factor1 Top contributor holds 92.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Recently: every ~16 days Total 391 Last Release 87d ago Major Versions v2.0.25 → v3.0.0-rc.372022-12-09 v2.0.26 → v3.0.0-rc.442022-12-12 v2.0.27 → v3.0.0-rc.472022-12-26 v2.0.28 → v3.0.32023-01-18 2.0.x-dev → v3.0.572023-06-23 PHP version history (5 changes)v2.0.0-beta1PHP ^7.4|~8.0.0 v3.0.0-beta1PHP ^8.0.0 v2.0.25PHP ^7.3|~8.0.0 v3.1.0-beta.1PHP >=8.1 v3.2.0-alpha.1PHP >=8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/8337659?v=4)[Deeka Wong](/maintainers/huangdijia)[@huangdijia](https://github.com/huangdijia) --- Top Contributors [![huangdijia](https://avatars.githubusercontent.com/u/8337659?v=4)](https://github.com/huangdijia "huangdijia (1739 commits)")[![guandeng](https://avatars.githubusercontent.com/u/7838221?v=4)](https://github.com/guandeng "guandeng (44 commits)")[![xuanyanwow](https://avatars.githubusercontent.com/u/28777109?v=4)](https://github.com/xuanyanwow "xuanyanwow (30 commits)")[![zds-s](https://avatars.githubusercontent.com/u/49744633?v=4)](https://github.com/zds-s "zds-s (27 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (18 commits)")[![greezen](https://avatars.githubusercontent.com/u/6023468?v=4)](https://github.com/greezen "greezen (5 commits)")[![tw2066](https://avatars.githubusercontent.com/u/24579418?v=4)](https://github.com/tw2066 "tw2066 (4 commits)")[![szutoutou](https://avatars.githubusercontent.com/u/17758819?v=4)](https://github.com/szutoutou "szutoutou (4 commits)")[![li-linfeng](https://avatars.githubusercontent.com/u/19252111?v=4)](https://github.com/li-linfeng "li-linfeng (3 commits)")[![trigold1218](https://avatars.githubusercontent.com/u/34828416?v=4)](https://github.com/trigold1218 "trigold1218 (2 commits)")[![assert6](https://avatars.githubusercontent.com/u/28561563?v=4)](https://github.com/assert6 "assert6 (2 commits)")[![binaryfire](https://avatars.githubusercontent.com/u/5361908?v=4)](https://github.com/binaryfire "binaryfire (2 commits)")[![he426100](https://avatars.githubusercontent.com/u/9689137?v=4)](https://github.com/he426100 "he426100 (2 commits)")[![liuchenrang](https://avatars.githubusercontent.com/u/2784214?v=4)](https://github.com/liuchenrang "liuchenrang (1 commits)")[![andreluizmicro](https://avatars.githubusercontent.com/u/51085904?v=4)](https://github.com/andreluizmicro "andreluizmicro (1 commits)")[![alexsyvolap](https://avatars.githubusercontent.com/u/80973788?v=4)](https://github.com/alexsyvolap "alexsyvolap (1 commits)")[![PrintNow](https://avatars.githubusercontent.com/u/28396104?v=4)](https://github.com/PrintNow "PrintNow (1 commits)")[![qiqizjl](https://avatars.githubusercontent.com/u/7540584?v=4)](https://github.com/qiqizjl "qiqizjl (1 commits)")[![rookiexxk](https://avatars.githubusercontent.com/u/162444894?v=4)](https://github.com/rookiexxk "rookiexxk (1 commits)")[![summerKK](https://avatars.githubusercontent.com/u/19187969?v=4)](https://github.com/summerKK "summerKK (1 commits)") ### Code Quality TestsPest Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/friendsofhyperf-components/health.svg) ``` [![Health](https://phpackages.com/badges/friendsofhyperf-components/health.svg)](https://phpackages.com/packages/friendsofhyperf-components) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.6k509.9M16.9k](/packages/laravel-framework)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M385](/packages/shopware-core)[civicrm/civicrm-core Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 728272.9k17](/packages/civicrm-civicrm-core)[drupal/core-recommended Locked core dependencies; require this project INSTEAD OF drupal/core. 6939.5M340](/packages/drupal-core-recommended)[contao/core-bundle Contao Open Source CMS 1231.6M2.3k](/packages/contao-core-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)