应使用模型事件钩子（如before_write）而非重写save()方法实现IP属地自动写入，配合离线IP库解析，并仅在IP字段有效时赋值属地字段。
直接在模型里写 save() 钩子就能完成 IP 属地自动写入，但必须避开两个坑：一是不能覆盖原始 save() 逻辑，二是不能对批量操作或不含 IP 字段的场景强行处理。
为什么不能重写 save() 方法
重写 save() 容易破坏框架底层事务、事件触发和关联保存行为。比如调用 $model->saveAll() 或使用 withSave() 关联写入时，自定义的 save() 可能跳过关键校验或未正确传递参数，导致数据不一致或静默失败。
正确做法是利用模型事件钩子，在数据真正落库前注入归属地信息：
- 只监听
before_write事件（ThinkPHP 5.1+）或before_insert/before_update（TP5.0） - 检查当前操作是否为单条记录、且字段中存在
ip或类似字段名（如login_ip） - 用
parent::save()或原生写入逻辑兜底，不接管整个流程
IP 属地解析必须离线做，别碰在线 API
每次写入都调用百度/腾讯地图 API，会拖慢响应、触发限流、暴露密钥，还可能因网络抖动导致写入失败回滚。纯真 QQWry.dat 或 UTFWry.dat 离线库才是生产首选。
立即学习“PHP免费学习笔记（深入）”；
实操要点：
- IP 库文件必须放在
extend/Org/Net/下，且文件名严格匹配（如UTFWry.dat，大小写敏感） - 类实例化时显式传入文件名：
new \Org\Net\IpLocation('UTFWry.dat') - 若返回的
country是 GBK 编码（常见于老版纯真库），需手动转 UTF-8：iconv('GBK', 'UTF-8//IGNORE', $location['country']) - 避免在循环中反复 new 实例，建议将
IpLocation实例缓存为静态属性或容器绑定
如何安全地把属地信息写进模型字段
属地字段（如 ip_province、ip_city）不应由前端提交，也不能靠 JS 或中间件预设 —— 必须在模型层、数据入库前完成赋值，且仅当 IP 字段非空时才执行解析。
示例代码片段（TP5.1）：
protected static function init()
{
self::event('before_write', function ($model) {
if (!$model->ip || !is_string($model->ip) || filter_var($model->ip, FILTER_VALIDATE_IP) === false) {
return;
}
$ipLoc = new \Org\Net\IpLocation('UTFWry.dat');
$loc = $ipLoc->getlocation($model->ip);
if ($loc && !empty($loc['country'])) {
$model->ip_province = iconv('GBK', 'UTF-8//IGNORE', $loc['country']);
$model->ip_city = iconv('GBK', 'UTF-8//IGNORE', $loc['area']);
}
});
}
注意：before_write 事件在 insert/update 前统一触发，无需区分新增或修改；但要确保 $model->ip 是已赋值状态（比如来自表单或中间件注入），否则取不到值。
字段命名与兼容性细节
不同版本 ThinkPHP 对字段自动完成的支持差异较大。TP5.0 不支持 before_write，得退回到 before_insert + before_update 分开注册；TP6 则推荐用模型的 save() 静态方法配合 data() 预处理。
容易被忽略的关键点：
-
get_client_ip()返回的是字符串，但某些代理环境会返回逗号分隔的多个 IP（如X-Forwarded-For），需先explode(',', ...)[0]截取最左真实 IP - 数据库字段类型建议用
VARCHAR(50)，别用CHAR浪费空间，也别用TEXT增加索引成本 - 如果业务允许，可把完整归属地存为 JSON 字段（如
ip_location），方便后续扩展字段而不改表结构
