https://github.com/zxc7563598/php-address-parser
收货地址智能解析工具，支持从非结构化文本中提取姓名、手机号、身份证号、省市区、详细地址等字段，适用于电商、物流、CRM 等系统。
https://github.com/zxc7563598/php-address-parser
address-extraction address-parser china-address composer natural-language-processing php php8 shipping-addresses smart-parser
Last synced: 19 days ago
JSON representation
收货地址智能解析工具，支持从非结构化文本中提取姓名、手机号、身份证号、省市区、详细地址等字段，适用于电商、物流、CRM 等系统。
- Host: GitHub
- URL: https://github.com/zxc7563598/php-address-parser
- Owner: zxc7563598
- License: mit
- Created: 2025-04-14T01:42:08.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-30T02:20:29.000Z (24 days ago)
- Last Synced: 2025-05-04T08:58:09.612Z (19 days ago)
- Topics: address-extraction, address-parser, china-address, composer, natural-language-processing, php, php8, shipping-addresses, smart-parser
- Language: PHP
- Homepage: https://tools.hejunjie.life/#/external/address-parser
- Size: 15.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# hejunjie/address-parser
一个简单实用的 PHP 地址解析工具，可以从混杂的字符串中提取出 **姓名、手机号、身份证、邮编、以及完整的省市区地址信息**。
> 🚀 适用于快递地址、用户信息录入等场景，自动识别结构化信息。
如果你不想要部署，只是想要进行使用，可以 👉 [点击此处进行使用](https://tools.hejunjie.life/#/external/address-parser)
支持批量查询
---
## ✨ 特性
- 自动识别：支持姓名、手机号、身份证、邮编提取
- 地址解析：基于省市区行政区划数据，智能匹配行政区域
- 结构化返回：统一结构输出，便于前后端对接
- 零依赖：纯 PHP 编写，无需额外扩展
- 支持 PHP 8+
---
## 📦 安装
使用 Composer 安装：
```bash
composer require hejunjie/address-parser
```
## 🧠 使用示例
```php
use Hejunjie\AddressParser\AddressParser;
$raw = '张三，13512345678,410123199001011234 重庆攀枝花市东区机场路88号 邮编100000';
$parsed = AddressParser::parse($raw);
print_r($parsed);
```
输出结果
```php
[
'name' => '张三',
'mobile' => '13512345678',
'idn' => '410123199001011234',
'postcode' => '100000',
'province' => '四川省',
'city' => '攀枝花市',
'region' => '东区',
'street' => '机场路88号'
]
```
## 🧩 返回字段说明
| 字段名 | 说明 |
|:-------|:-----|
| name | 姓名 |
| mobile | 手机号 |
| idn | 身份证号 |
| postcode | 邮政编码 |
| province | 省份名称 |
| city | 城市名称 |
| region | 区/县名称 |
| street | 详细地址（去除省市区后的部分） |
## 🧰 用途 & 背景
在实际业务中，用户填写的地址往往是非结构化的，例如：
> 张三 13512345678 北京市朝阳区建国路88号 邮编100000
将这些信息手动拆分不仅低效，而且容易出错。`hejunjie/address-parser` 就是为了解决这种 **非结构化地址的自动解析** 而设计的，广泛适用于：
- 🛒 电商系统中的订单地址处理
- 📦 快递物流系统地址识别
- 🧾 后台管理系统用户信息补全
- 📱 小程序/APP 用户地址录入校验
无论是个人项目还是企业系统，它都能快速提升地址处理的自动化与准确率。
有啥问题或者建议都欢迎提 issue 或 PR，我会尽量回复。
## 🙏 致谢
这个包最初的灵感，来自一位朋友在我另一个仓库的 issues 里提到的想法，还贴心地分享了其他朋友的实现：[pupuk/address](https://github.com/pupuk/address)。当时就觉得这个方向挺有意思，也正是因为他的启发，我才动手做了 `hejunjie/address-parser`。
感谢他的思路分享，也希望这个小工具能帮到更多人 🙌
## 🔧 更多工具包（可独立使用，也可统一安装）
本项目最初是从 [hejunjie/tools](https://github.com/zxc7563598/php-tools) 拆分而来，如果你想一次性安装所有功能组件，也可以使用统一包：
```bash
composer require hejunjie/tools
```
当然你也可以按需选择安装以下功能模块：
[hejunjie/cache](https://github.com/zxc7563598/php-cache) - 多层缓存系统，基于装饰器模式。
[hejunjie/china-division](https://github.com/zxc7563598/php-china-division) - 中国省市区划分数据包。
[hejunjie/error-log](https://github.com/zxc7563598/php-error-log) - 责任链日志上报系统。
[hejunjie/mobile-locator](https://github.com/zxc7563598/php-mobile-locator) - 国内手机号归属地 & 运营商识别。
[hejunjie/utils](https://github.com/zxc7563598/php-utils) - 常用工具方法集合。
[hejunjie/url-signer](https://github.com/zxc7563598/php-url-signer) - URL 签名工具，支持对 URL 进行签名和验证。
[hejunjie/google-authenticator](https://github.com/zxc7563598/php-google-authenticator) - Google Authenticator 及类似应用的密钥生成、二维码创建和 OTP 验证。
[hejunjie/simple-rule-engine](https://github.com/zxc7563598/php-simple-rule-engine) - 一个轻量、易用的 PHP 规则引擎，支持多条件组合、动态规则执行。
👀 所有包都遵循「轻量实用、解放双手」的原则，能单独用，也能组合用，自由度高，欢迎 star 🌟 或提 issue。
---
该库后续将持续更新，添加更多实用功能。欢迎大家提供建议和反馈，我会根据大家的意见实现新的功能，共同提升开发效率。