php-address-parser

KO | EN

gitlite — search

#typescript #llm #golang #android #deep-learning #docker #macos #awesome #cli #kubernetes #awesome-list #security #mcp #openai

php-address-parser

(★ 10)

收货地址智能解析工具，支持从非结构化文本中提取姓名、手机号、身份证号、省市区、详细地址等字段，适用于电商、物流、CRM 等系统 | An intelligent address parser that extracts name, phone number, ID number, region, and detailed address from unstructured text—perfect for e-commerce, logistics, and CRM systems.

php-address-parser 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# hejunjie/address-parser

<div align="center">
  <a href="./README.md">English</a>｜<a href="./README.zh-CN.md">简体中文</a>
</div>

An intelligent address parser that extracts name, phone number, ID number, province, city, district, and detailed address from unstructured text — ideal for e-commerce, logistics, and CRM systems.

> For a quick project overview, check out the [Zread analysis](https://zread.ai/zxc7563598/php-address-parser). If you'd rather not deploy it yourself, try the [online tool](https://hejunjie.life/composer/address-parser), which also supports batch queries.

## Features

- **User Info Extraction**: Automatically recognizes name, phone number, ID number, and postal code
- **Smart Address Matching**: Intelligently resolves administrative divisions using nationwide province/city/district data
- **Structured Output**: Returns a consistent array format for easy frontend-backend integration
- **Flexible Configuration**: Supports custom division data sources and configurable fallback values
- **PHP 7.4+ / 8.0+** with ext-mbstring required

## Installation

```bash
composer require hejunjie/address-parser
```

## Quick Start

```php
use Hejunjie\AddressParser\AddressParser;

$raw = '张三，13512345678，410123199001011234 重庆攀枝花市东区机场路88号 邮编100000';

$parsed = AddressParser::parse($raw);

print_r($parsed);
```

Output:

```php
[
    'name'     => '张三',
    'mobile'   => '13512345678',
    'idn'      => '410123199001011234',
    'postcode' => '100000',
    'province' => '四川省',
    'city'     => '攀枝花市',
    'region'   => '东区',
    'street'   => '机场路88号',
]
```

## API

### `AddressParser::parse()`

```php
public static function parse(
    string $string,         // Raw address string to parse
    bool $user = true,      // Whether to extract user info (name, phone, ID, postcode)
    string $unknownValue = '未知',  // Fallback value when a region cannot be matched
    array $level1Data = [], // Custom province-level data; uses built-in data if empty
    array $level2Data = [], // Custom city-level data
    array $level3Data = []  // Custom district/county-level data
): array
```

> Built-in division data is sourced from [hejunjie/china-division](https://github.com/zxc7563598/php-china-division) and updated regularly.

**Parameters:**

**Batch Parsing Example:**

```php
$addresses = [
    '张三 13512345678 北京市朝阳区望京SOHO 邮编100000',
    '李四 13800138000 上海市浦东新区陆家嘴金融中心88号',
];

foreach ($addresses as $raw) {
    $result = AddressParser::parse($raw);
    // Process each result...
}
```

## Return Fields

## Use Cases

In real-world scenarios, user-submitted addresses are often unstructured. For example:

> 张三 13512345678 北京市朝阳区建国路88号 邮编100000

Manually parsing such strings is inefficient and error-prone. `hejunjie/address-parser` is designed specifically for these situations:

- Order address processing in e-commerce systems
- Address recognition in logistics and delivery services
- User profile completion in admin panels
- Address input validation in mini-programs and mobile apps

If you have any questions or suggestions, feel free to open an [issue](https://github.com/zxc7563598/php-address-parser/issues). I'll respond as soon as I can.

## Acknowledgements

The inspiration for this package came from a friend who mentioned the idea in an issue on one of my other repositories and kindly shared the [pupuk/address](https://github.com/pupuk/address) implementation. That spark led to `hejunjie/address-parser` — many thanks for the inspiration 🙌

php-address-parser

php-address-parser 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

php-address-parser

php-address-parser 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README