增加README

Author: zxc7563598

README.md

@@ -0,0 +1,109 @@
+# hejunjie/address-parser
+
+一个简单实用的 PHP 地址解析工具，可以从混杂的字符串中提取出 **姓名、手机号、身份证、邮编、以及完整的省市区地址信息**。
+
+> 🚀 适用于快递地址、用户信息录入等场景，自动识别结构化信息。
+
+---
+
+## ✨ 特性
+
+- 自动识别：支持姓名、手机号、身份证、邮编提取  
+- 地址解析：基于省市区行政区划数据，智能匹配行政区域  
+- 结构化返回：统一结构输出，便于前后端对接  
+- 零依赖：纯 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，我会尽量回复。
+
+# 🔧 更多工具包（可独立使用，也可统一安装）
+
+本项目最初是从 [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) - 常用工具方法集合。
+
+👀 所有包都遵循「轻量实用、解放双手」的原则，能单独用，也能组合用，自由度高，欢迎 star 🌟 或提 issue。
+
+---
+
+该库后续将持续更新，添加更多实用功能。欢迎大家提供建议和反馈，我会根据大家的意见实现新的功能，共同提升开发效率。