顺手写了个地址解析小工具,支持在线用,也能接 PHP 项目里

之前做项目的时候,经常遇到这种情况:用户填的收货地址是一整段话,像这样:

复制代码
张三 13512345678 重庆市攀枝花市东区机场路88号 410123199001011234 邮编100000

人眼一看还行,但要让程序去拆成「姓名」「手机号」「省市区」「详细地址」这些字段,还是挺折磨的。

所以我就自己写了一个小工具,现在开源出来了,分享给大家用。支持直接在网页上粘贴地址自动解析,也可以安装进 PHP 项目里用。


✅ 不懂技术也能用:在线演示地址

如果你只是想把一批收货地址快速拆成结构化格式,比如帮客服导入表格、整理用户地址,那你直接用这个就行:

👉 在线体验地址:点击立即使用

打开后,把地址粘进去,它会自动给你拆出来:

字段 示例值
姓名 张三
手机号 13512345678
身份证号 410123199001011234
省市区 四川省 攀枝花市 东区
详细地址 机场路88号
邮编 100000

操作很简单,不用注册、不用装软件,直接用。


🛠 这个工具怎么来的?

也没啥"市场需求分析"那种大词,其实就是我自己做系统的时候经常遇到类似的问题。

尤其是后台管理系统,导入收货地址的时候,用户填的内容各种格式都有:

  • 用逗号分隔的
  • 什么标点都没有的
  • 中英文夹杂的

自己去写正则一个个拆,太麻烦,而且还不稳定。所以我就打算干脆写个通用一点的解析器,干干净净地输出结构化结果,自己用起来省事,也能给有类似需求的朋友用。


🔍 它能干啥?

一句话总结:把一段收货地址文本,拆成结构化的字段

比如:

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' => '攀枝花市',
    'area' => '东区',
    'detail' => '机场路88号'
]

你可以拿这些字段去存数据库,或者回填表单都行。


🧠 技术思路简单聊聊(给懂 PHP 的朋友)

  • 手机号、身份证号、邮编识别:用正则表达式直接提取
  • 省市区识别:内置了一份完整的中国行政区划数据,然后根据关键词匹配 + 模糊判断
  • 姓名 vs 地址怎么分? :写了点简单的规则,比如常见的人名长度、位置优先级啥的

整个项目是纯 PHP 实现 的,没依赖 Laravel、ThinkPHP、Symfony 什么的,也不用数据库,装了就能用,适合绝大多数项目接入


📦 怎么安装 / 用它?

如果你是开发者,那用 Composer 安装就行:

bash 复制代码
composer require hejunjie/address-parser

然后直接调用静态方法:

php 复制代码
use Hejunjie\AddressParser\AddressParser;

$parsed = AddressParser::parse('张三 北京市朝阳区xxx小区 13512345678');

它会返回一个包含 name​、mobile​、province​、city​、area​、detail​ 等字段的数组。

GitHub 项目地址在这里,欢迎 Star、Fork、提 Issue: 👉 zxc7563598/php-address-parser


🧩 最后:

这个工具本来是我做项目时的一个小需求,后来觉得也许别人也会用得上,就整理了下发出来。

你是技术人员可以直接接入项目; 你不是技术人员,也可以直接用我做好的在线演示页面; 你有兴趣研究实现方式,那源码也完全开放了。

总之,有用你就拿去用就行,简单实用比啥都强。

相关推荐
TlSfoward10 小时前
抓包代理链路下的 TLS 指纹变化分析 TLSFOWARD抓包工具
数据库·爬虫·网络协议·搜索引擎·php
—Miss. Z—13 小时前
计算机二级MySQL——简单应用题(存储过程&存储函数)
数据库·oracle·php
故乡de云14 小时前
AWS 添加付款方式失败排查清单:卡片、银行风控与账号状态逐项定位
开发语言·php
梦梦代码精15 小时前
基于ThinkPHP6 + Vue3的家政预约系统全解析:从LBS定位到自动派单的完整实现
java·docker·开源·php·代码规范
郑州光合科技余经理15 小时前
家政O2O平台解析:从0搭建上门预约小程序解决方案
android·java·开发语言·前端·小程序·架构·php
lxw184491251416 小时前
PHP后端(CI框架方向)面试题库,分为基础必问、MySQL、Redis、工程运维、高阶加分、场景实操六大模块,适配该JD全部考点,附带标准答案
ci/cd·面试·php
郑州光合科技余经理16 小时前
家政预约小程序后端源码深度剖析:支付回调实战
java·开发语言·前端·git·小程序·架构·php
weixin_408099671 天前
2026 图片去水印 API 接口完全指南:一键去除图片水印(附 Python/Java/PHP/C# 示例)
java·python·php·图片处理·api调用·图片去水印·石榴智能
王莎莎-MinerU1 天前
MCP 解决的是工具接入,科研 Agent 还缺的是科学证据接口标准化
开发语言·网络·人工智能·深度学习·pdf·c#·php
AC赳赳老秦2 天前
OpenClaw 采集任务日志审计:全程记录采集行为,满足合规溯源与企业审计要求
java·大数据·python·数据挖掘·数据分析·php·openclaw