ThinkPHP需结合外部服务或本地数据库实现IP属地解析；获取真实IP须配置信任代理、Nginx透传及CDN设置，并推荐使用ip-api.com API或QQWry.dat离线库，同时必须加入缓存与降级策略。
ThinkPHP 本身不提供 IP 属地解析功能，必须依赖外部服务或本地数据库；直接调用 get_client_ip() 只能拿到 IP，不能自动显示归属地。
怎么获取用户真实 IP（避免代理干扰）
很多情况下 $_SERVER['REMOTE_ADDR'] 是反向代理（如 Nginx、CDN）的地址，不是真实访客 IP。ThinkPHP 的 request()->ip() 默认已做基础代理头识别，但需确认配置是否生效：
- 确保
app.php中'trust_proxy' => true已开启（5.1+）或'trusted_proxies' => ['127.0.0.1', '192.168.0.0/16']（6.x/7.x） - Nginx 需显式透传真实 IP：
proxy_set_header X-Real-IP $remote_addr;，否则X-Forwarded-For可能被伪造 - 若使用 CDN（如阿里云、腾讯云），需在控制台开启「传递客户端真实 IP」，并检查 Header 中实际生效的是
X-Forwarded-For还是X-Real-IP
用纯 PHP 调用免费 IP 归属地 API（无 SDK）
推荐使用国内响应快、无需申请 Key 的公开接口，例如 ip.taobao.com（已停用）或改用 ip-api.com（免费版限 45 次/分钟）。注意：该接口返回 JSON，需处理网络超时与错误响应。
$ip = request()->ip();
$url = "http://ip-api.com/json/{$ip}?lang=zh";
$response = file_get_contents($url, false, stream_context_create(['http' => ['timeout' => 3]]));
$data = json_decode($response, true);
$location = $data['status'] === 'success'
? "{$data['country']}{$data['regionName']}{$data['city']}"
: '未知地区';
- 不要在模板中直接调用
file_get_contents，应封装到服务类或中间件中，避免每次渲染都发请求 - 生产环境务必加缓存（如 Redis 存
"ip_location:{$ip}"，TTL 设为 1 小时），否则高并发下容易触发接口限流或拖慢页面 -
ip-api.com免费版对大陆 IP 返回较简略（常无省市区），可考虑备用方案：聚合数据、腾讯位置服务（需实名+配额）
用本地纯真 IP 库（QQWry.dat）离线解析
适合对稳定性、隐私、延迟敏感的场景。ThinkPHP 无内置支持，需引入第三方解析器（如 overtrue/ip-parser）并加载本地 QQWry.dat 文件。
立即学习“PHP免费学习笔记（深入）”；
- 下载最新
qqwry.dat放到public/static/或runtime/目录，确保 PHP 进程有读取权限 - 安装解析器：
composer require overtrue/ip-parser - 使用示例：
use Overtrue\IPParser\QQWry; $parser = new QQWry(ROOT_PATH . 'public/static/qqwry.dat'); $location = $parser->lookup(request()->ip()); // 返回类似 "中国|广东省|深圳市|电信"
- 注意
QQWry.dat编码为 GBK，overtrue/ip-parser默认转 UTF-8，若乱码可手动iconv('GBK', 'UTF-8', $location) - 该库不支持 IPv6，如需兼容，得额外判断 IP 类型再跳过或 fallback 到 API
- 更新 IP 库需手动替换文件，建议写个命令行脚本定期拉取（如从
https://github.com/oicu/ipdb获取）
真正麻烦的不是“怎么显示”，而是“什么时候查、查几次、查失败怎么办”。IP 属地属于弱一致性数据，缓存策略和降级逻辑比解析本身更重要——比如首次访问查 API，失败则显示“海外用户”，后续同 IP 直接走缓存，连缓存都没命中才 fallback 到本地库。这些细节不写进业务层，上线后就会在凌晨三点收到报警。
