Download the PHP package hejunjie/china-division without Composer
On this page you can find all versions of the php package hejunjie/china-division. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hejunjie/china-division
More information about hejunjie/china-division
Files in hejunjie/china-division
Package china-division
Short Description 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
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package china-division
hejunjie/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
This is a nationwide provincial, city, and district division data repository that I maintain, containing the latest administrative division data, as well as historical records and address changes. It's mainly to make it easier to access this data in projects without having to manually search and organize it every time.
The data is synchronized and updated periodically, supports installation via Composer, and can also be processed by directly referencing the JSON file.
If you don't want to deploy it and just want to use it, you can 👉 click here to use it.
It also supports bulk queries.
Installation
Install via Composer:
Included Data Files
data.json: The currently valid nationwide provincial, city, and district data.
history.json: Historical regional data (including areas that have been revoked, merged, or renamed).
diff.json: Records of administrative division changes (such as what changed from and to what).
You can directly import the JSON files for processing. The structure is clear and ready to use.
Usage
I wrote a simple helper class called Division to facilitate data retrieval and common processing:
It also provides some commonly used methods that you can directly use. However, if you have performance requirements, I strongly recommend caching the data and implementing it yourself.
Update Notes
The data source comes from public channels such as the National Bureau of Statistics and will be updated periodically. If there is new data, feel free to submit a PR or issue to let me know.
Purpose & Motivation
This set of data is mainly for my own project. Often, I need to handle tasks like address matching, province-city-district linkage, and historical data comparison. After searching around, I found that either the data was incomplete or the updates were slow, so I decided to create my own dataset, and also manage versions for easier reference.
If you happen to be working on something similar, I hope this repository can be of help to you 🙌.
🔧 Additional Toolkits (Can be used independently or installed together)
This project was originally extracted from hejunjie/tools. To install all features in one go, feel free to use the all-in-one package:
Alternatively, feel free to install only the modules you need：
hejunjie/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 - 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 - 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 - 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 - 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 - 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 - A PHP library for generating URLs with encryption and signature protection—useful for secure resource access and tamper-proof links.
hejunjie/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 - A lightweight and flexible PHP rule engine supporting complex conditions and dynamic rule execution—ideal for business logic evaluation and data validation.
👀 All packages follow the principles of being lightweight and practical — designed to save you time and effort. They can be used individually or combined flexibly. Feel free to ⭐ star the project or open an issue anytime!
This library will continue to be updated with more practical features. Suggestions and feedback are always welcome — I’ll prioritize new functionality based on community input to help improve development efficiency together.
