PHPackages                             hejunjie/china-division - 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. [Validation & Sanitization](/categories/validation)
4. /
5. hejunjie/china-division

ActiveLibrary[Validation & Sanitization](/categories/validation)

hejunjie/china-division
=======================

定期更新，全国最新省市区划分数据，身份证号码解析地址，支持 Composer 安装与版本控制，适用于表单选项、数据校验、地址解析等场景 | 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

v2.0.1(1mo ago)71.6k↓81.5%12MITPHPPHP ^7.4 || ^8.0

Since Apr 12Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/zxc7563598/php-china-division)[ Packagist](https://packagist.org/packages/hejunjie/china-division)[ RSS](/packages/hejunjie-china-division/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (8)DependenciesVersions (9)Used By (2)

hejunjie/china-division
=======================

[](#hejunjiechina-division)

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

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 scenarios.

**This project has been parsed by Zread. [View project overview](https://zread.ai/zxc7563598/php-china-division)**

Features
--------

[](#features)

- 📦 Nationwide administrative division data, synced regularly from public sources like the National Bureau of Statistics
- 🆔 ID-card parsing: address lookup, gender, date of birth, and checksum validation
- 📅 Historical data and change records — trace revoked, merged, or renamed regions
- 🔗 Built-in cascader data conversion, ready for frontend province-city-district linkage components
- 🏷 City tier classification (level\_1 / level\_2 / level\_3)
- 🚀 Composer install, zero dependencies

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

[](#requirements)

- PHP >= 7.4

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

[](#installation)

```
composer require hejunjie/china-division
```

Included Data Files
-------------------

[](#included-data-files)

FileDescription`data.json`Current valid administrative division data`history.json`Historical region data (revoked, merged, or renamed regions)`diff.json`Administrative division change records (region code mappings)You can also work with the JSON files directly without the Division helper class.

Usage
-----

[](#usage)

### Retrieving Data

[](#retrieving-data)

```