Download the PHP package glitter1105/address-parser without Composer
On this page you can find all versions of the php package glitter1105/address-parser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Please rate this library. Is it a good library?
Informations about the package address-parser
PHP 中国地址解析器 (Address Parser)
一个强大的 PHP 中国地址解析器,能够智能解析混合文本中的用户信息和地址信息。支持从复杂的地址字符串中精确提取省市区、街道地址、用户姓名、手机号码、身份证号、邮政编码等信息。
✨ 主要特性
🎯 智能地址解析
- 精确的省市区识别: 支持全国34个省级行政区、333个地级行政区、2851个县级行政区
- 多种地址格式: 兼容各种中文地址表述习惯和格式变体
- 智能关键词匹配: 基于"省"、"市"、"区"、"县"、"旗"等关键词的位置感知算法
- 同名地名处理: 有效解决重名地区的歧义性问题
👤 用户信息提取
- 姓名识别: 智能提取用户真实姓名
- 手机号码: 支持11位手机号和各种座机格式
- 身份证号: 支持18位和15位身份证号码
- 邮政编码: 精确识别6位邮政编码
🛡️ 可靠性保障
- 异常处理: 完善的错误处理机制,确保程序稳定性
- 数据验证: 多层次的输入验证和数据校验
- 容错能力: 对不完整或格式异常的地址具有较强的容错性
- 性能优化: 高效的算法设计,支持大批量地址解析
📦 安装方式
使用 Composer 安装(推荐)
手动安装
- 下载源码包
- 解压到你的项目目录
- 引入 autoload 文件:
🚀 快速开始
基础用法
仅解析地址信息
📋 使用示例
示例 1: 标准格式地址
示例 2: 包含身份证和邮编的地址
示例 3: 复杂格式地址
示例 4: 批量处理
🔧 高级用法
异常处理
自定义处理逻辑
🏗️ 系统要求
- PHP 版本: 7.4 或更高版本
- PHP 扩展:
ext-json
: JSON 数据处理ext-mbstring
: 多字节字符串处理(中文支持)
- 依赖包: 无外部依赖
📊 支持的地址格式
省级行政区
- 省: 如"广东省"、"山东省"
- 直辖市: 如"北京市"、"上海市"
- 自治区: 如"新疆维吾尔自治区"、"西藏自治区"
- 特别行政区: 如"香港特别行政区"、"澳门特别行政区"
地级行政区
- 地级市: 如"深圳市"、"杭州市"
- 自治州: 如"延边朝鲜族自治州"
- 盟: 如"锡林郭勒盟"
县级行政区
- 市辖区: 如"朝阳区"、"浦东新区"
- 县: 如"海淀县"、"宝安县"
- 自治县: 如"秀山土家族苗族自治县"
- 旗: 如"察哈尔右翼前旗"
🎯 算法特点
地址解析算法
-
预处理阶段
- 清理空格、标点符号等干扰字符
- 标准化行政区划名称表述
- 移除常见的非地名关键词
-
关键词提取
- 基于位置感知的关键词识别
- 优先级排序:区县 > 市 > 省
- 特殊地名格式处理
- 智能匹配
- 多级行政区划数据库匹配
- 同名地名的歧义性解决
- 不完整地址的智能补全
用户信息提取算法
-
正则表达式匹配
- 手机号: 支持11位手机号和各种座机格式
- 身份证: 支持18位和15位格式
- 邮政编码: 6位数字格式
- 启发式姓名识别
- 基于词长度和位置的姓名推断
- 常见姓名模式识别
- 与其他信息的上下文关联
🚨 注意事项
- 数据准确性: 解析结果的准确性取决于输入地址的完整性和规范性
- 性能考虑: 对于大批量数据处理,建议适当控制并发数量
- 字符编码: 确保输入数据使用 UTF-8 编码
- 特殊字符: 避免使用特殊符号和表情符号
🤝 贡献指南
我们欢迎任何形式的贡献!
报告问题
- 在 GitHub Issues 提交 bug 报告
- 提供详细的错误信息和复现步骤
提交代码
- Fork 本项目
- 创建特性分支 (
git checkout -b feature/amazing-feature
) - 提交更改 (
git commit -m 'Add some amazing feature'
) - 推送到分支 (
git push origin feature/amazing-feature
) - 创建 Pull Request
开发规范
- 遵循 PSR-4 自动加载规范
- 添加适当的单元测试
- 确保代码风格一致
- 添加详细的注释文档
📄 许可证
本项目采用 MIT 许可证。详情请查看 LICENSE 文件。
🙏 致谢
- 感谢所有贡献者的努力和支持
- 参考了国家标准《中华人民共和国行政区划代码》(GB/T 2260)
- 使用了开源的行政区划数据
📞 联系方式
- 作者: glitter1105
- 邮箱: [email protected]
- GitHub: https://github.com/glitter1105/address-parser
🔗 相关链接
⭐ 如果这个项目对你有帮助,请给我们一个 Star!
All versions of address-parser with dependencies
PHP Build Version
Package Version
Requires
php Version
>=7.4
ext-json Version *
ext-mbstring Version *
ext-json Version *
ext-mbstring Version *
The package glitter1105/address-parser contains the following files
Loading the files please wait ....