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.2.2(3w ago)1151628MITPHPPHP &gt;=8.2CI failing

Since May 21Pushed 3w 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 1w ago

READMEChangelog (10)Dependencies (291)Versions (400)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/09da06415f9b898f1286dca54f8ac4358c8a3fce495596692f64646f708c5e2a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6879706572662d253345253344332e322e302d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/friendsofhyperf/components)[![OpenSSF Scorecard](https://camo.githubusercontent.com/44e391d25252ce65d7d307a63e7c7c42b19799cbd82072106c95867bf322dc84/68747470733a2f2f6170692e73636f7265636172642e6465762f70726f6a656374732f6769746875622e636f6d2f667269656e64736f666879706572662f636f6d706f6e656e74732f6261646765)](https://scorecard.dev/viewer/?uri=github.com/friendsofhyperf/components)[![Ask DeepWiki](https://camo.githubusercontent.com/0f5ae213ac378635adeb5d7f13cef055ad2f7d9a47b36de7b1c67dbe09f609ca/68747470733a2f2f6465657077696b692e636f6d2f62616467652e737667)](https://deepwiki.com/friendsofhyperf/components)

[中文说明](README_CN.md)

A monorepo of 49 independently installable components for [Hyperf](https://hyperf.io) 3.2 and later.

Requirements
------------

[](#requirements)

- PHP 8.2 or later
- Hyperf 3.2 or later
- Swoole or Swow, when required by the application or component

Each component declares its exact dependencies in `src//composer.json`.

Installation
------------

[](#installation)

Install the complete collection:

```
composer require friendsofhyperf/components
```

Or install only the components your application needs:

```
composer require friendsofhyperf/telescope
composer require friendsofhyperf/http-client
composer require friendsofhyperf/model-factory --dev
```

Most framework-integrated packages are discovered through their `ConfigProvider`. Some components also publish configuration or resources:

```
php bin/hyperf.php vendor:publish friendsofhyperf/
```

Consult the component README and documentation before publishing files; not every component provides publishable resources.

Components
----------

[](#components)

### Development and Debugging

[](#development-and-debugging)

- [telescope](src/telescope) - request, exception, SQL, Redis, and runtime inspection
- [tinker](src/tinker) - interactive REPL
- [web-tinker](src/web-tinker) - browser-based Tinker interface
- [ide-helper](src/ide-helper) - IDE metadata generation
- [pretty-console](src/pretty-console) - improved console presentation

### Database and Models

[](#database-and-models)

- [model-factory](src/model-factory), [model-observer](src/model-observer), [model-scope](src/model-scope), [model-hashids](src/model-hashids), and [model-morph-addon](src/model-morph-addon)
- [compoships](src/compoships), [fast-paginate](src/fast-paginate), [mysql-grammar-addon](src/mysql-grammar-addon), and [trigger](src/trigger)

### Infrastructure and Integrations

[](#infrastructure-and-integrations)

- Cache and coordination: [cache](src/cache), [lock](src/lock), and [redis-subscriber](src/redis-subscriber)
- HTTP and APIs: [http-client](src/http-client) and [oauth2-server](src/oauth2-server)
- Messaging: [notification](src/notification), [notification-mail](src/notification-mail), [notification-easysms](src/notification-easysms), [mail](src/mail), and [tcp-sender](src/tcp-sender)
- External services and observability: [elasticsearch](src/elasticsearch), [telescope-elasticsearch](src/telescope-elasticsearch), [openai-client](src/openai-client), [recaptcha](src/recaptcha), and [sentry](src/sentry)
- Configuration: [confd](src/confd) and [config-consul](src/config-consul)

### Framework Extensions

[](#framework-extensions)

- Commands: [command-benchmark](src/command-benchmark), [command-signals](src/command-signals), [command-validation](src/command-validation), and [console-spinner](src/console-spinner)
- Architecture: [facade](src/facade), [ipc-broadcaster](src/ipc-broadcaster), and [exception-event](src/exception-event)
- Security and validation: [encryption](src/encryption), [purifier](src/purifier), [rate-limit](src/rate-limit), [validated-dto](src/validated-dto), and [grpc-validation](src/grpc-validation)
- Shared utilities: [helpers](src/helpers), [support](src/support), and [macros](src/macros)
- Queue and testing: [amqp-job](src/amqp-job) and [co-phpunit](src/co-phpunit)

Every component directory contains its own package metadata and README. The complete list is available under [`src/`](src).

Documentation
-------------

[](#documentation)

The documentation site is available in four languages:

- [Simplified Chinese](https://docs.hdj.me/zh-cn/)
- [Traditional Chinese](https://docs.hdj.me/zh-tw/)
- [Hong Kong Traditional Chinese](https://docs.hdj.me/zh-hk/)
- [English](https://docs.hdj.me/en/)

Component documentation is maintained under `docs//components/`. Component READMEs and documentation pages are separate sources, so behavior changes may require updates to both.

Repository Layout
-----------------

[](#repository-layout)

```
src//        independently installable component packages
tests//      shared Pest test suite
docs//          VitePress documentation in four languages
types/                  PHP stubs checked at PHPStan max level
bin/                    repository maintenance, split, and release scripts

```

The root package aggregates all components. Most components integrate with Hyperf through a `ConfigProvider`; a small number are framework-independent libraries.

Development
-----------

[](#development)

Install dependencies from the repository root:

```
composer install
```

Run the standard local checks:

```
composer test          # code style, Pest tests, and type coverage
composer analyse       # PHPStan analysis
composer analyse:types # PHPStan max-level analysis for types/
```

Run focused checks while developing a component:

```
vendor/bin/pest --group cache
vendor/bin/pest tests/CoPhpunit
composer analyse src/cache
composer cs-fix -- src/cache
```

Pest groups are defined in [`tests/Pest.php`](tests/Pest.php). Not every component has a group, so use a test directory or file when necessary. `composer test` does not run PHPStan; run `composer analyse` separately before submitting code changes.

For documentation changes:

```
npm install
npm run docs:check
```

Simplified Chinese is the translation source. Keep the page set and heading structure synchronized across `en`, `zh-cn`, `zh-hk`, and `zh-tw`, then review generated translations before submission. `npm run docs:translate` modifies translated files and requires translation service configuration; run it only when intentionally regenerating translations.

Contributing
------------

[](#contributing)

Read [CONTRIBUTE.md](CONTRIBUTE.md) and [AGENTS.md](AGENTS.md) before making changes.

- Treat component source and tests as the authority for documented behavior.
- Update tests when public behavior changes.
- Update the component README and documentation snippets when they are affected.
- Keep changes scoped; do not edit generated or unrelated files without a reason.
- Run targeted checks first, followed by the relevant repository-level checks.
- Use Conventional Commits, scoped to a component when possible.

Release Model
-------------

[](#release-model)

This monorepo is the source of truth. Maintenance workflows split `src/` into individual `friendsofhyperf/` repositories, and releases apply a shared version tag across the monorepo and component repositories.

The split and release scripts force-push or tag remote repositories. They are maintainer-only operations and should not be run during normal development.

Community
---------

[](#community)

- [Documentation](https://docs.hdj.me/)
- [GitHub Issues](https://github.com/friendsofhyperf/components/issues)
- [CNB Mirror](https://cnb.cool/friendsofhyperf/components)
- [Contributors](https://github.com/friendsofhyperf/components/graphs/contributors)

License
-------

[](#license)

FriendsOfHyperf Components is open-sourced software licensed under the [MIT License](LICENSE).

###  Health Score

59

—

FairBetter than 98% of packages

Maintenance95

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community25

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 92.2% 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 ~4 days

Total

397

Last Release

23d 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 (1750 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 (29 commits)")[![zds-s](https://avatars.githubusercontent.com/u/49744633?v=4)](https://github.com/zds-s "zds-s (26 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (17 commits)")[![tw2066](https://avatars.githubusercontent.com/u/24579418?v=4)](https://github.com/tw2066 "tw2066 (5 commits)")[![greezen](https://avatars.githubusercontent.com/u/6023468?v=4)](https://github.com/greezen "greezen (5 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)")[![he426100](https://avatars.githubusercontent.com/u/9689137?v=4)](https://github.com/he426100 "he426100 (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)")[![trigold1218](https://avatars.githubusercontent.com/u/34828416?v=4)](https://github.com/trigold1218 "trigold1218 (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.9k556.2M21.0k](/packages/laravel-framework)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M647](/packages/shopware-core)[shopware/platform

The Shopware e-commerce core

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

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

758297.9k49](/packages/civicrm-civicrm-core)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6943.5M442](/packages/drupal-core-recommended)[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.9M530](/packages/pimcore-pimcore)

PHPackages © 2026

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