PHPackages                             hejunjie/tools - 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. hejunjie/tools

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

hejunjie/tools
==============

A PHP utility library that encapsulates commonly used operations for strings, arrays, files, network requests, image processing, and various helper functions (such as phone carrier lookup and ID-based address resolution) frequently encountered in daily development. More features are being continuously added...

v2.2.1(1y ago)42.0k↓33.3%2MITPHP ^8.1

Since Oct 17Pushed 6mo ago1 watchersCompare

[ Source](https://github.com/zxc7563598/php-tools)[ Packagist](https://packagist.org/packages/hejunjie/tools)[ RSS](/packages/hejunjie-tools/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (9)Versions (16)Used By (0)

hejunjie/tools
==============

[](#hejunjietools)

 [English](./README.md)｜[简体中文](./README.zh-CN.md)---

🚀 A PHP utility library that encapsulates commonly used operations for strings, arrays, files, network requests, image processing, and various helper functions (such as phone carrier lookup and ID-based address resolution) frequently encountered in daily development. More features are being continuously added...

> 🧨 Starting from `v2.0.0`, this package has undergone a major structural overhaul. It has been split into multiple standalone packages, allowing for more flexible combinations and a lighter usage experience!

---

🧱 Split Explanation
-------------------

[](#-split-explanation)

Originally, all features were bundled in a single repository, which made it convenient to use but not ideal for modular maintenance and independent feature reuse.

Therefore, I’ve split them into the following 9 standalone Composer packages:

packagesdescribe[`hejunjie/utils`](https://github.com/zxc7563598/php-utils)A lightweight and practical PHP utility library that offers a collection of commonly used helper functions for files, strings, arrays, and HTTP requests—designed to streamline development and support everyday PHP projects.[`hejunjie/cache`](https://github.com/zxc7563598/php-cache)A layered caching system built with the decorator pattern. Supports combining memory, file, local, and remote caches to improve hit rates and simplify cache logic.[`hejunjie/china-division`](https://github.com/zxc7563598/php-china-division)Regularly updated dataset of China's administrative divisions with ID-card address parsing. Distributed via Composer and versioned for use in forms, validation, and address-related features[`hejunjie/error-log`](https://github.com/zxc7563598/php-error-log)An error logging component using the Chain of Responsibility pattern. Supports multiple output channels like local files, remote APIs, and console logs—ideal for flexible and scalable logging strategies.[`hejunjie/mobile-locator`](https://github.com/zxc7563598/php-mobile-locator)A mobile number lookup library based on Chinese carrier rules. Identifies carriers and regions, suitable for registration checks, user profiling, and data archiving.[`hejunjie/address-parser`](https://github.com/zxc7563598/php-address-parser)An intelligent address parser that extracts name, phone number, ID number, region, and detailed address from unstructured text—perfect for e-commerce, logistics, and CRM systems.[`hejunjie/url-signer`](https://github.com/zxc7563598/php-url-signer)A PHP library for generating URLs with encryption and signature protection—useful for secure resource access and tamper-proof links.[`hejunjie/google-authenticator`](https://github.com/zxc7563598/php-google-authenticator)A PHP library for generating and verifying Time-Based One-Time Passwords (TOTP). Compatible with Google Authenticator and similar apps, with features like secret generation, QR code creation, and OTP verification.[`hejunjie/simple-rule-engine`](https://github.com/zxc7563598/php-simple-rule-engine)A lightweight and flexible PHP rule engine supporting complex conditions and dynamic rule execution—ideal for business logic evaluation and data validation.---

💡 Why split it this way?
------------------------

[](#-why-split-it-this-way)

The main goal is to separate feature modules more clearly, while allowing users to:

- **Import only the packages they need, reducing bloat**
- **Maintain only the components they use, with clearer dependencies**
- **Provide each module with independent documentation, versioning, and update plans**
- **Reduce coupling to better support future feature evolution**

---

📦 Installation
--------------

[](#-installation)

If you want to `get all features at once`, simply continue using this package:

```
composer require hejunjie/tools
```

Installing it will automatically include all the sub-packages mentioned above, with no extra configuration needed.

Of course, you can also choose to install any individual package as needed:

```
composer require hejunjie/cache
composer require hejunjie/error-log
```

🧪 PHP Version Requirement
-------------------------

[](#-php-version-requirement)

This suite of tools requires PHP &gt;= 8.1.

❤️ About Me
-----------

[](#️-about-me)

This integrated package is a collection of tools I’ve refined through multiple real-world projects.

It has now been gradually split into several smaller packages, and I may continue to maintain, simplify, and optimize it over time.

You're very welcome to use it — and feel free to open an issue or submit a PR 🚀.

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance59

Moderate activity, may be stable

Popularity25

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~14 days

Total

15

Last Release

378d ago

Major Versions

v1.1.0 → v2.0.02025-04-12

PHP version history (4 changes)v1.0.0PHP &gt;=7.1

v1.0.1PHP ^7.1 || ^8.0

v1.0.2PHP ^8.0

v2.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/5b65d4b40ae456172fb38f63f84bf737ac88031484b1f228b1cc8d71baa80adf?d=identicon)[苏青安](/maintainers/%E8%8B%8F%E9%9D%92%E5%AE%89)

---

Top Contributors

[![zxc7563598](https://avatars.githubusercontent.com/u/46590942?v=4)](https://github.com/zxc7563598 "zxc7563598 (42 commits)")

---

Tags

composermeta-packagepackage-bundlerphpphp-packagephp-toolsphp8phptoolsutilities

### Embed Badge

![Health badge](/badges/hejunjie-tools/health.svg)

```
[![Health](https://phpackages.com/badges/hejunjie-tools/health.svg)](https://phpackages.com/packages/hejunjie-tools)
```

###  Alternatives

[ilya/belt

A handful of tools for PHP developers.

71020.8k1](/packages/ilya-belt)

PHPackages © 2026

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