PHPackages                             glitter1105/address-parser - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing & Serialization](/categories/parsing)
4. /
5. glitter1105/address-parser

ActiveLibrary[Parsing & Serialization](/categories/parsing)

glitter1105/address-parser
==========================

一个强大的 PHP 中国地址解析器，能够智能解析混合文本中的用户信息和地址信息。支持从复杂的地址字符串中精确提取省市区、街道地址、用户姓名、手机号码、身份证号、邮政编码等信息。

1.0.0(10mo ago)1191MITPHPPHP >=7.4

Since Jul 15Pushed 10mo agoCompare

[ Source](https://github.com/glitter1105/address-parser)[ Packagist](https://packagist.org/packages/glitter1105/address-parser)[ Docs](https://github.com/glitter1105/address-parser)[ RSS](/packages/glitter1105-address-parser/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

PHP 中国地址解析器 (Address Parser)
============================

[](#php-中国地址解析器-address-parser)

[![PHP Version](https://camo.githubusercontent.com/ce0c70c519047d0e507604f03e6e8ae6c27bcc072027e899680d9bf93804dc76/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e342532422d626c7565)](https://php.net)[![License](https://camo.githubusercontent.com/5caa455d8debc46fb23abbadb45a733a937f3910a73fc875c2f7820468e1bb54/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e)](LICENSE)

一个强大的 PHP 中国地址解析器，能够智能解析混合文本中的用户信息和地址信息。支持从复杂的地址字符串中精确提取省市区、街道地址、用户姓名、手机号码、身份证号、邮政编码等信息。

✨ 主要特性
------

[](#-主要特性)

### 🎯 智能地址解析

[](#-智能地址解析)

- **精确的省市区识别**: 支持全国34个省级行政区、333个地级行政区、2851个县级行政区
- **多种地址格式**: 兼容各种中文地址表述习惯和格式变体
- **智能关键词匹配**: 基于"省"、"市"、"区"、"县"、"旗"等关键词的位置感知算法
- **同名地名处理**: 有效解决重名地区的歧义性问题

### 👤 用户信息提取

[](#-用户信息提取)

- **姓名识别**: 智能提取用户真实姓名
- **手机号码**: 支持11位手机号和各种座机格式
- **身份证号**: 支持18位和15位身份证号码
- **邮政编码**: 精确识别6位邮政编码

### 🛡️ 可靠性保障

[](#️-可靠性保障)

- **异常处理**: 完善的错误处理机制，确保程序稳定性
- **数据验证**: 多层次的输入验证和数据校验
- **容错能力**: 对不完整或格式异常的地址具有较强的容错性
- **性能优化**: 高效的算法设计，支持大批量地址解析

📦 安装方式
------

[](#-安装方式)

### 使用 Composer 安装（推荐）

[](#使用-composer-安装推荐)

```
composer require glitter1105/address-parser
```

### 手动安装

[](#手动安装)

1. 下载源码包
2. 解压到你的项目目录
3. 引入 autoload 文件：

```
require_once 'vendor/autoload.php';
```

🚀 快速开始
------

[](#-快速开始)

### 基础用法

[](#基础用法)

```