用 PHP 简单实现地址自动识别功能

在现代化的开发中，地址自动识别已经成为一个非常常见的功能。特别是在快递填写地址时，系统会根据输入的内容自动识别地址、姓名、手机号码等信息，并自动填充到相应的输入框中。这不仅提高了用户体验，还减少了手动输入的错误概率。

实现思路

我们使用 Laravel 框架来实现这个功能，主要涉及到以下几个部分：

路由 (Route)
模型 (Model)
视图 (View)
控制器 (Controller)

1. 控制器实现

在 UsersController 控制器中，我们通过依赖注入将 UsersRepository 注入到控制器中，方便处理用户相关的业务逻辑。以下是控制器的核心代码：

/** @var UserRepository */
private $userRepository;

public function __construct(UsersRepository $userRepo) {
    $this->userRepository = $userRepo;
}

地址识别方法

$discernDel 是从前端传递过来的地址信息。业务逻辑的处理通过 UsersRepository 中的方法 getDiscern 实现：

/**
 * Function: 地址识别
 */
public function getDiscern(Request $request) {
    $discernDel = $request->input('discernDel');
    try {
        DB::beginTransaction();
        $address = $this->userRepository->getDiscern($discernDel);
        DB::commit();
    } catch (\Exception $e) {
        DB::rollBack();
        $msg = "信息提示:".$e->getMessage()."，行:".$e->getLine();
        return response(['code' => 0, 'msg' => $msg]);
    }

    return response(['code' => 1, 'msg' => $address]); // 地址识别完成
}

2. 业务逻辑处理

在 UsersRepository 中，我们处理地址识别的业务逻辑。getDiscern 方法负责解析输入的姓名、手机号码、地址等信息：

public function getDiscern($discernDel) {
    if (empty($discernDel)) {
        throw new \Exception("请传入要识别的地址");
    }

    $discernDel_left = explode('[', $discernDel);
    if (!isset($discernDel_left[1])) {
        throw new \Exception("你填写的地址规则错误,手机号码应该用[]");
    }

    $discernDel_right = explode(']', $discernDel_left[1]);
    if (!isset($discernDel_right[1]) || empty($discernDel_right[1])) {
        throw new \Exception("你填写的地址规则错误,手机号码应该用[]");
    }

    $name = $discernDel_left[0];
    if (empty($name)) {
        throw new \Exception("你填写的姓名有误！");
    }

    $mobile = $discernDel_right[0];
    if (empty($mobile) || checkMobile($mobile) == 0) {
        throw new \Exception("你填写的手机号码格式有误！");
    }

    $address = trim($discernDel_right[1]);
    if (empty($address)) {
        throw new \Exception("你填写的地址不能为空");
    }

    $var_address = $this->getAddressArrar($address);
    $var_address['name'] = $name;
    $var_address['mobile'] = $mobile;

    return $var_address;
}

3. 地址匹配处理

getAddressArrar 方法处理复杂的地址格式。例如不同地区的名称可能会有所不同（如 "广西省" 和 "广西壮族自治区"），需要进行灵活的匹配。

function getAddressArrar($address) {
    // 获取所有地址递归列表
    $regions = $this->getRegions();
    $province = $city = $district = [];

    // 查找省份
    $province = $this->checkAddress($address, $regions);
    if ($province) {
        // 特殊市辖区处理
        if (in_array($province['region_code'], ['110000', '300000', '404100', '310000']) && count($city['list']) == 0) {
            // 查找市辖区
            $city = $this->checkAddress('市辖区', $province['list']);
            if ($city) {
                $district = $this->checkAddress($address, $city['list']);
                if (!isset($district['region_code'])) {
                    $city = $this->checkAddress('县', $province['list']);
                    $district = $this->checkAddress($address, $city['list']);
                }
            }
        } else {
            if ($city) {
                $district = $this->checkAddress($address, $city['list']);
            }
        }
    } else {
        throw new \Exception("省份没填写，请检查");
    }

    return $this->getAddressInfo($address, $province, $city, $district);
}

4. 前端实现

前端使用了简单的表单输入和按钮触发 Ajax 请求，将用户输入的地址信息发送到后台进行识别：

<div class="form-group">
    {!! Form::label('discern', '自动识别地址:',['class' => 'control-label col-sm-2']) !!}
    <div class="col-sm-5">
        {!! Form::textarea('discern', '', ['class' => 'form-textarea form-control form-discern','rows' => 3]) !!}
    </div>
    <div class="col-sm-3" style="height: 75px;">
        <button type="button" class="btn btn-info btn-sm discern" onclick="getDiscern();">提交识别</button>
        <small class="ruleGet" style="color: #676a74;">*查看模板</small>
    </div>
</div>

5. 前端 JavaScript

在前端，使用 jQuery 实现了 Ajax 提交，地址识别结果会填充到对应的输入框中：

function getDiscern() {
    var discernDel = $(".form-discern").val();
    if (!discernDel) {
        alert("请输入要识别的地址");
        return false;
    }

    $.ajax({
        type: 'POST',
        url: "{!! route('admin.user.getDiscern') !!}",
        data: {
            '_token': csrf_token(),
            'discernDel': discernDel
        },
        dataType: 'json',
        timeout: 50000,
        success: function(res) {
            if (res.code == 1) {
                $("input[name='addr[linkman]']").val(res.msg.name);
                $("input[name='user_name']").val(res.msg.mobile);
                $("input[name='addr[address]']").val(res.msg.info);

                // 触发 change 事件
                $('#province').val(res.msg.province).trigger('change');
                $('#city').val(res.msg.city).trigger('change');
                $('#area').val(res.msg.district).trigger('change');

                // 识别后清除
                $(".form-discern").val("");
            } else {
                alert(res.msg);
            }
        }
    });
}

总结

地址自动识别功能的实现过程其实非常简单，核心思路是通过正则匹配和递归遍历地址库，实现对地址、姓名、手机号码等信息的自动识别和填充。这种功能不仅提升了用户体验，还减少了手动输入的工作量。在 Laravel 框架中，通过依赖注入、前后端交互和数据库操作，可以非常方便地实现这个功能。

复制全文生成海报编程 Web开发用户体验 PHP Laravel

编程 用 PHP 简单实现地址自动识别功能