{"id":27854110,"url":"https://github.com/zxc7563598/php-address-parser","last_synced_at":"2025-05-04T08:58:14.473Z","repository":{"id":288012451,"uuid":"965836629","full_name":"zxc7563598/php-address-parser","owner":"zxc7563598","description":"收货地址智能解析工具，支持从非结构化文本中提取姓名、手机号、身份证号、省市区、详细地址等字段，适用于电商、物流、CRM 等系统。","archived":false,"fork":false,"pushed_at":"2025-04-30T02:20:29.000Z","size":16,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-04T08:58:09.612Z","etag":null,"topics":["address-extraction","address-parser","china-address","composer","natural-language-processing","php","php8","shipping-addresses","smart-parser"],"latest_commit_sha":null,"homepage":"https://tools.hejunjie.life/#/external/address-parser","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zxc7563598.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-14T01:42:08.000Z","updated_at":"2025-04-30T02:20:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"7138af0d-7d88-4eba-b0f1-940cc0172223","html_url":"https://github.com/zxc7563598/php-address-parser","commit_stats":null,"previous_names":["zxc7563598/php-address-parser"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxc7563598%2Fphp-address-parser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxc7563598%2Fphp-address-parser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxc7563598%2Fphp-address-parser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxc7563598%2Fphp-address-parser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zxc7563598","download_url":"https://codeload.github.com/zxc7563598/php-address-parser/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252310964,"owners_count":21727516,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["address-extraction","address-parser","china-address","composer","natural-language-processing","php","php8","shipping-addresses","smart-parser"],"created_at":"2025-05-04T08:58:13.974Z","updated_at":"2025-05-04T08:58:14.464Z","avatar_url":"https://github.com/zxc7563598.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hejunjie/address-parser\n\n一个简单实用的 PHP 地址解析工具，可以从混杂的字符串中提取出 **姓名、手机号、身份证、邮编、以及完整的省市区地址信息**。\n\n\u003e 🚀 适用于快递地址、用户信息录入等场景，自动识别结构化信息。\n\n如果你不想要部署，只是想要进行使用，可以 👉 [点击此处进行使用](https://tools.hejunjie.life/#/external/address-parser)\n\n支持批量查询\n\n---\n\n## ✨ 特性\n\n- 自动识别：支持姓名、手机号、身份证、邮编提取  \n- 地址解析：基于省市区行政区划数据，智能匹配行政区域  \n- 结构化返回：统一结构输出，便于前后端对接  \n- 零依赖：纯 PHP 编写，无需额外扩展  \n- 支持 PHP 8+\n\n---\n\n## 📦 安装\n\n使用 Composer 安装：\n\n```bash\ncomposer require hejunjie/address-parser\n```\n\n## 🧠 使用示例\n\n```php\nuse Hejunjie\\AddressParser\\AddressParser;\n\n$raw = '张三，13512345678,410123199001011234 重庆攀枝花市东区机场路88号 邮编100000';\n\n$parsed = AddressParser::parse($raw);\n\nprint_r($parsed);\n\n```\n\n输出结果\n\n```php\n[\n    'name' =\u003e '张三',\n    'mobile' =\u003e '13512345678',\n    'idn' =\u003e '410123199001011234',\n    'postcode' =\u003e '100000',\n    'province' =\u003e '四川省',\n    'city' =\u003e '攀枝花市',\n    'region' =\u003e '东区',\n    'street' =\u003e '机场路88号'\n]\n```\n\n## 🧩 返回字段说明\n\n| 字段名 | 说明 |\n|:-------|:-----|\n| name | 姓名 |\n| mobile | 手机号 |\n| idn | 身份证号 |\n| postcode | 邮政编码 |\n| province | 省份名称 |\n| city | 城市名称 |\n| region | 区/县名称 |\n| street | 详细地址（去除省市区后的部分） |\n\n## 🧰 用途 \u0026 背景\n\n在实际业务中，用户填写的地址往往是非结构化的，例如：\n\n\u003e 张三 13512345678 北京市朝阳区建国路88号 邮编100000\n\n将这些信息手动拆分不仅低效，而且容易出错。`hejunjie/address-parser` 就是为了解决这种 **非结构化地址的自动解析** 而设计的，广泛适用于：\n\n- 🛒 电商系统中的订单地址处理  \n- 📦 快递物流系统地址识别  \n- 🧾 后台管理系统用户信息补全  \n- 📱 小程序/APP 用户地址录入校验  \n\n无论是个人项目还是企业系统，它都能快速提升地址处理的自动化与准确率。\n\n有啥问题或者建议都欢迎提 issue 或 PR，我会尽量回复。\n\n## 🙏 致谢\n这个包最初的灵感，来自一位朋友在我另一个仓库的 issues 里提到的想法，还贴心地分享了其他朋友的实现：[pupuk/address](https://github.com/pupuk/address)。当时就觉得这个方向挺有意思，也正是因为他的启发，我才动手做了 `hejunjie/address-parser`。\n\n感谢他的思路分享，也希望这个小工具能帮到更多人 🙌\n\n## 🔧 更多工具包（可独立使用，也可统一安装）\n\n本项目最初是从 [hejunjie/tools](https://github.com/zxc7563598/php-tools) 拆分而来，如果你想一次性安装所有功能组件，也可以使用统一包：\n\n```bash\ncomposer require hejunjie/tools\n```\n\n当然你也可以按需选择安装以下功能模块：\n\n[hejunjie/cache](https://github.com/zxc7563598/php-cache) - 多层缓存系统，基于装饰器模式。\n\n[hejunjie/china-division](https://github.com/zxc7563598/php-china-division) - 中国省市区划分数据包。\n\n[hejunjie/error-log](https://github.com/zxc7563598/php-error-log) - 责任链日志上报系统。\n\n[hejunjie/mobile-locator](https://github.com/zxc7563598/php-mobile-locator) - 国内手机号归属地 \u0026 运营商识别。\n\n[hejunjie/utils](https://github.com/zxc7563598/php-utils) - 常用工具方法集合。\n\n[hejunjie/url-signer](https://github.com/zxc7563598/php-url-signer) - URL 签名工具，支持对 URL 进行签名和验证。\n\n[hejunjie/google-authenticator](https://github.com/zxc7563598/php-google-authenticator) - Google Authenticator 及类似应用的密钥生成、二维码创建和 OTP 验证。\n\n[hejunjie/simple-rule-engine](https://github.com/zxc7563598/php-simple-rule-engine) - 一个轻量、易用的 PHP 规则引擎，支持多条件组合、动态规则执行。\n\n👀 所有包都遵循「轻量实用、解放双手」的原则，能单独用，也能组合用，自由度高，欢迎 star 🌟 或提 issue。\n\n---\n\n该库后续将持续更新，添加更多实用功能。欢迎大家提供建议和反馈，我会根据大家的意见实现新的功能，共同提升开发效率。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzxc7563598%2Fphp-address-parser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzxc7563598%2Fphp-address-parser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzxc7563598%2Fphp-address-parser/lists"}