zifan/addressparser

中文收货地址智能识别

v2.2.7 2023-08-31 10:36 UTC

This package is auto-updated.

Last update: 2024-09-30 01:19:43 UTC


README

Latest Version on Packagist Total Downloads Build Status StyleCI

中文收货地址智能识别

参考链接:

查看 contributing.md 了解待办事项清单。

要求

  • PHP >= 7.1.0
  • Mbstring PHP 扩展

安装

通过 Composer

$ composer require zifan/addressparser

用法

$options = ['strict' => true]

$parser = new AddressParser($options);

$parser->handle('浙江省杭州市滨江区西兴街道滨康路228号万福中心A座21楼');

选项

数组 $options 如

[
    'dataProvider' => [
        'driver' => 'file'            // 驱动,默认file,其它方式(如数据模型)可自行扩展
        'path' => null,               // 指定省市区数据文件,默认从插件config文件夹中读取
    ],
    'enable_keywords_split' => false, // 是否启用关键词分割(适用于在淘宝、京东App上复制收货地址时开启,固定格式,拼多多不带关键字只是格式固定)
    'keywords' => [                   // enable_keywords_split 为 true 时才生效
        'person' => ['收货人', '收件人', '姓名'],
        'mobile' => ['手机号码', '手机', '联系方式', '电话号码', '电话'],
    ],
    'extra' => [                      // 额外提取字段
        'sub_district' => false,      // 村乡镇/街道(准确度低)
        'idn' => false,               // 身份证号
        'mobile' => false,            // 联系方式(手机号/座机号)
        'postcode' => false,          // 邮编
        'person' => false,            // 姓名(准确度低)
    ],
    'strict' => false,                // 是否对提取结果进行准确度校验、补齐
]

带关键字固定格式的收货地址示例

京东格式

姓名:张三
地址:浙江省杭州市滨江区 西兴街道 滨康路228号万福中心A座21楼

淘宝格式

收货人: 张三
手机号码: 158********
所在地区: 浙江省杭州市滨江区西兴街道
详细地址: 滨康路228号万福中心A座21楼

变更日志

请参阅 changelog 了解最近的变化。

贡献

请参阅 contributing.md 了解详细信息及待办事项清单。

安全性

如果您发现任何安全相关的问题,请发送电子邮件至 s443939412@163.com 而不是使用问题跟踪器。

鸣谢

许可协议

MIT. 请参阅 许可文件 了解更多信息。