源码系统概览
文章正文
IP138 SDK 是一套封装 IP138 官方接口的 PHP 组件源码，覆盖 IP 归属地、手机号归属、天气与二维码四类查询能力。
项目由 hejunjie 开源维护，仓库获 6 个 star 关注，采用 MIT 协议发布，以 2026.9.22 源码打包为版本口径，README 最后更新 2026 年 9 月。
源码简介
SDK 把 IP138 的四个接口端点统一封装，HTTP 与 HTTPS 入口以常量区分，调用方免处理签名与协议细节。
除 IP 归属地外还覆盖手机号归属、天气查询与二维码生成，一包多用。
凭据在 IP138 用户中心申请，composer 安装后配置即可调用。
SDK 将四个接口端点定义为类常量，国内 HTTP 与 HTTPS 入口分别对应不同常量值，README 给出每个端点的调用示例与返回字段说明。
对比 GeoIP2 和纯真离线库，区别在于 IP138 官方接口的实时在线查询能力。
| 对比维度 | IP138 SDK | 离线 IP 库方案 |
|---|---|---|
| 数据时效 | 官方接口实时更新 | 离线库定期手工更新 |
| 能力范围 | IP 手机天气二维码 | 多为单一 IP 能力 |
| 接入成本 | SDK 统一封装 | 自研协议对接 |
| 部署形态 | 在线调用无库文件 | 需分发库文件 |
需要精准 IP 归属地与周边查询能力的项目，接入 SDK 配置凭据即可调用。
适用场景
- 登录与订单风控的 IP 归属地校验
- 内容平台的手机号归属地展示
- 按城市维度展示天气的入口服务
技术栈与运行环境
命名空间为 Hejunjie Ip138 系列，四个接口端点以类常量暴露。
SDK 负责 HTTP 调用与结果解析，composer 安装后配置凭据即可使用。
功能亮点
- IP 归属地实时查询
- 手机号归属地查询
- 天气查询能力内置
- 二维码生成接口
- composer 一行接入
技术架构与部署指南
安装与部署提示
安装组件。
composer require hejunjie/ip138配置凭据并调用归属地查询。
use Hejunjie\Ip138\IP138; $res = IP138::query('8.8.8.8', IP138::URL_DOMESTIC_HTTPS);按业务需要扩展天气与二维码调用。
php -r "require 'vendor/autoload.php'; var_dump(class_exists('Hejunjie\\Ip138\\IP138'));"截图与演示说明
本页配图采用 GitHub 仓库社交分享卡片，展示 SDK 名称与查询能力定位。
README 以英文文档与代码示例为主，列出四个接口端点常量与调用方式。
SDK 类库无运行界面截图，效果以示例代码与返回结构说明。
四个端点的常量命名与官方文档一一对应，接入方按业务场景选择对应常量传入查询方法即可。
常见问题
问. IP138 SDK 是什么
一套封装 IP138 官方接口的 PHP 组件源码，覆盖四类查询能力。
问. 需要自己申请凭据吗
需要，凭据在 IP138 用户中心申请后配置即可。
问. 离线环境能用吗
SDK 为在线接口调用，离线场景请选择离线 IP 库方案。
问. 可以商用吗
采用 MIT 协议发布，保留版权与协议声明即可自由使用。
安全风险提示
接口凭据请通过环境变量注入，勿提交进代码仓库。
注意调用频次与计费，线上请增加缓存与限流。
项目采用 MIT 协议开源，商用保留版权与协议声明即可。
接入后请跟进仓库的后续版本更新，及时获取问题修复与功能改进。
使用中遇到问题可在仓库 issue 区反馈，附上复现步骤便于定位。
下载说明
本页提供 PHP IP 查询组件完整源码打包下载，含 SDK 代码与调用示例。
压缩包内含完整组件代码、双语文档与使用示例，解压后按 README 步骤安装依赖即可接入现有项目运行。
GitHub项目开源地址 https://github.com/zxc7563598/php-ip138
