ip-location-zh 使用教程:从安装到查询的 10 分钟完整实战指南

发布时间:2026/10/28 4:52:39

ip-location-zh 使用教程:从安装到查询的 10 分钟完整实战指南 ip-location-zh 使用教程从安装到查询的 10 分钟完整实战指南【免费下载链接】ip-location-zh获取 IP 地址的真实地理位置项目地址: https://gitcode.com/gh_mirrors/ip/ip-location-zhip-location-zh 是一款免费的 PHP IP 地址定位库无需数据库配置一行 composer 命令即可安装通过Ip::find一个方法就能查出 IP 地址的真实地理位置例如中国河南郑州以及中国行政区划代码支持到市级。本文带你 10 分钟内完成安装与首次查询。一、ip-location-zh 是什么能做什么简单来说输入一个 IP 地址返回它所在的位置。中文结果171.12.10.156→中国 河南 郑州国外 IP 同样支持只是不如国内详细行政区划代码额外返回市级编码如410100郑州方便做区域统计⚡零配置不依赖 MySQL 等数据库IP 数据库以二进制文件src/20190703.ipdb随包提供即安即用Composer 管理遵循国际标准的依赖管理随时可更新⚠️ 提前说明免费版数据不含经纬度、运营商、行政区等字段也不负责国家码/邮编适合需求简单的场景数据更新于 2019-7-3不定期更新。二、如何快速安装 ip-location-zh1. 前置条件确认 Composer 可用ip-location-zh 通过 Composer 安装。若未安装先自行安装 Composer再执行下一条命令。2. 一行命令完成安装在你的项目根目录执行composer require zhuzhichao/ip-location-zh如果你更想先把仓库克隆到本地查看源码可以使用git clone https://gitcode.com/gh_mirrors/ip/ip-location-zh安装完成后核心文件位于src/Ip.php查询逻辑与src/20190703.ipdbIP 数据库无需任何额外配置。三、10 秒上手IP 定位查询实战1. 最简查询示例require vendor/autoload.php; use Zhuzhichao\IpLocationZh\Ip; var_dump(Ip::find(171.12.10.156));2. 看懂返回结果查询返回一个数组各字段含义如下下标示例值含义0中国国家1河南省份2郑州城市3空保留位4410100市级行政区划代码几个值得注意的细节查询127.0.0.1会返回「本机地址」而不是报错传入不合法的字符串会抛出InvalidArgumentException异常请确保传入合法 IP数据库中查不到的 IP 返回N/A同时支持 IPv4 与 IPv6内置缓存机制同一个 IP 二次查询直接命中缓存性能开销极低 核心源码参考Ip::find 是全部查询入口整个库对外就暴露这一个方法真正做到了「功能专一」。四、Laravel 项目中如何接入 IP 定位如果你使用 Laravel 框架接入更优雅只需三步安装插件composer require zhuzhichao/ip-location-zh注册别名Laravel 5.0 - 5.4 需在config/app.php的aliases中添加Ip Zhuzhichao\IpLocationZh\IpLaravel 5.5 支持扩展包自动发现可跳过直接使用Ip::find(171.12.10.156); Ip::find(Request::getClientIp()); // 直接查访问者的 IP最后一行非常实用一行代码即可定位当前访问者所在省市常用于用户日志、区域限制等场景。五、行政区划代码如何解析find返回的最后一个元素是行政区划代码如410100。如果需要把省份、城市名与编码做对照可直接调用内置方法$locations \Zhuzhichao\IpLocationZh\Ip::locations(); // 覆盖全国省/直辖市/自治区含各城市编码该映射表内置于src/Ip.php的locations()方法中无需额外维护。测试用例见tests/TestIp.php可帮助你快速验证环境是否正常。六、常见问题 FAQQ1数据多久更新一次A不定期更新当前数据库版本为20190703文件名见src/20190703.ipdb。对精度要求不高、追求免费的场景完全够用。Q2为什么查不到经纬度和运营商A免费数据库不提供经纬度、运营商、行政区等详细内容这是免费版与商业版的差异。Q3国外 IP 能查吗A可以但详细程度不如国内 IP。Q4支持 IPv6 吗A支持find方法会先校验 IPv4/IPv6 合法性再进行查询。写在最后回顾一下 ip-location-zh 的三个优势零数据库配置、单一方法上手、Composer 标准管理。项目结构也非常清爽核心文件一览src/Ip.php核心查询与行政区划编码逻辑src/20190703.ipdbIP 地理位置数据库tests/TestIp.phpPHPUnit 测试用例composer.json包元信息MIT 协议见License.txt只需 10 分钟你的 PHP 项目就具备了 IP 地址真实地理位置查询能力 【免费下载链接】ip-location-zh获取 IP 地址的真实地理位置项目地址: https://gitcode.com/gh_mirrors/ip/ip-location-zh创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/28 4:47:57

技能不是知道而是稳定做到:一套完整的技能养成与盘点体系

总听人把“skills”挂在嘴边,简历上写“沟通能力强、熟悉Office三件套、会Python基础”,可真遇到实际任务的时候,往往发现那些写在纸上的技能根本撑不住场面。我在过去几年里带过团队、也做过自由职业,见过太多人陷在“学了一堆东…

2026/10/28 4:47:57

ECC椭圆曲线密码学原理与全栈实践指南

1. ECC到底是什么?别被缩写骗了,它不是“企业云中心”也不是“加密货币钱包”ECC这个词在最近的开发者热搜里反复刷屏,但很多人点进去才发现——自己根本没搞清它指什么。有人以为是SAP里的ECC系统(Enterprise Central Component&…

2026/10/28 4:47:57

JAR文件双击打不开的根源与修复指南

1. 为什么双击JAR文件会“消失”——这不是Bug,是系统在认真执行你的指令你把一个写着“点我运行”的JAR文件拖到桌面,满怀期待地双击——结果什么都没发生:没有窗口弹出,没有错误提示,甚至没看到任务栏闪烁一下&#…

2026/10/28 4:47:57

AI摄像头技术解析:从人形检测到智能家居联动

1. 项目概述:当家用摄像头遇上AI会发生什么?去年帮父母家安装小米摄像头时,我发现传统监控存在三个痛点:误报频繁(树叶晃动也报警)、被动查看(必须人工盯着屏幕)、事件回溯困难&…

2026/10/28 4:47:57

YOLOv8环境搭建与目标检测实战教程

1. 项目概述YOLOv8作为当前最先进的实时目标检测算法之一,在工业质检、安防监控、自动驾驶等领域有着广泛应用。本教程将完整演示从零开始搭建YOLOv8开发环境的全流程,包括服务器配置、数据准备、模型训练、性能优化到最终部署的全套解决方案。特别说明&…

2026/10/28 4:42:57

8MP车载摄像头:像素密度、识别距离与上车工程账

1. 从一颗像素说起:8MP进车为什么成了分水岭两年前跟一位做感知算法的朋友聊方案,他给整车厂报的是2MP(19201080)摄像头模组,理由很朴素:算力吃得消、链路成熟、成本可控。今年再聊,同一批人拿出…

2026/10/27 14:24:03

全国计算机二级C语言真题PDF高效刷题指南

简介:这份PDF是全国计算机二级C语言考试的试题与答案解析,专为备考二级C语言的考生准备。内容涵盖C语言特点与设计理念、程序基本组成单位、main函数执行流程、函数嵌套调用规则、标识符命名规范、整型实型字符型数据类型、八进制十六进制数合法形式、运…

2026/10/27 9:34:54

requests+BeautifulSoup:爬虫抓取h1标题的入门实战指南

简介:一份以实战为导向的Python爬虫入门资源,面向具备基本编程基础、希望快速掌握网络数据抓取的初学者,可解决从零编写简单爬虫的常见困惑。实例以requests库发送HTTP请求、BeautifulSoup解析HTML文档,完整演示从网页中提取 标题…

2026/10/28 3:32:29

递推最小二乘参数辨识MATLAB编程:二阶系统与渐消记忆实现

简介:这是一篇面向控制系统、信号处理与机器学习等领域学习者的最小二乘参数辨识程序说明文档。资源共包含一个docx格式文档,压缩包大小七十八KB,内容围绕递推最小二乘算法和渐消记忆最小二乘算法展开:先构造一个极点位于单位圆内…

2026/10/28 0:02:13

Python股票自动交易系统源码解析:从行情获取到风控的完整链路

简介:这份资源是面向高校计算机、金融相关专业毕业设计场景的完整项目源码包,主题为基于Python的股票自动交易系统,适合需要完成毕设选题、课程设计或自学金融量化交易开发的学生与开发者参考。压缩包共收录687个文件,整体约14.93…

2026/10/28 0:02:13

视酷酷信IM源码部署指南:Java 17+MySQL 8.0.33实战配置

简介:这是一套2024年亲测可部署的视酷酷信IM即时通讯系统源码,面向具备Java、OC、C#及Vue开发能力的技术人员,解决私有化即时通讯平台快速搭建与二次定制需求,尤其适用于需集成商城、保障数据主权的中小型企业或独立开发者。资源共…

2026/10/28 0:02:13

Python爬取百度迁徙数据:接口解析、批量采集与避坑指南

简介:这份资源是一个用Python爬取百度迁徙数据的脚本压缩包,面向具备Python基础、希望入门网络爬虫与数据解析的开发者,解决按日期获取全国热门城市人口迁徙数据的问题。包内共1个文件,为单个py脚本,压缩包约1KB&#…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑