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 &amp; Helpers](/categories/utility)
4. /
5. friendsofhyperf/components

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

friendsofhyperf/components
==========================

The most popular components for Hyperf.

v3.1.78(3mo ago)11613↓100%28[1 issues](https://github.com/friendsofhyperf/components/issues)[1 PRs](https://github.com/friendsofhyperf/components/pulls)MITPHPPHP &gt;=8.1CI passing

Since May 21Pushed 2w 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 today

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 &gt;= 8.1
- Hyperf &gt;= 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 &amp; 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 &amp; 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 &amp; 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 &amp; API

[](#-http--api)

- **[http-client](src/http-client)** - Elegant HTTP client (Laravel-style)
- **[oauth2-server](src/oauth2-server)** - OAuth2 server implementation

### 📨 Notifications &amp; 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 &amp; Data

[](#-search--data)

- **[elasticsearch](src/elasticsearch)** - Elasticsearch client integration
- **[telescope-elasticsearch](src/telescope-elasticsearch)** - Elasticsearch storage for Telescope

### ⚙️ Configuration &amp; Infrastructure

[](#️-configuration--infrastructure)

- **[confd](src/confd)** - Configuration management with confd
- **[config-consul](src/config-consul)** - Consul configuration center

### 🛠️ Command &amp; 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 &amp; Architecture

[](#-dependency-injection--architecture)

- **[facade](src/facade)** - Laravel-style facades for Hyperf
- **[ipc-broadcaster](src/ipc-broadcaster)** - Inter-process communication broadcaster

### 🔐 Security &amp; 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 &amp; 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 &amp; Logging

[](#-monitoring--logging)

- **[sentry](src/sentry)** - Sentry error tracking integration

### 🚀 Queue &amp; Jobs

[](#-queue--jobs)

- **[amqp-job](src/amqp-job)** - AMQP-based job queue

### 🧪 Testing

[](#-testing)

- **[co-phpunit](src/co-phpunit)** - Coroutine-compatible PHPUnit

### 🤖 AI &amp; 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 &amp; 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 98% of packages

Maintenance90

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

42d 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 &gt;=8.1

v3.2.0-alpha.1PHP &gt;=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.6k500.1M15.2k](/packages/laravel-framework)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

718267.0k11](/packages/civicrm-civicrm-core)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.0M341](/packages/shopware-core)[fisharebest/webtrees

webtrees online genealogy

72910.3k6](/packages/fisharebest-webtrees)[alleyinteractive/mantle-framework

A framework for powerful WordPress development

27224.8k2](/packages/alleyinteractive-mantle-framework)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
