Trendshift - Ask AI

base on PHP版本的离线IP地址定位库 [![Latest Stable Version](https://poser.pugx.org/zoujingli/ip2region/v/stable)](https://packagist.org/packages/zoujingli/ip2region) [![Total Downloads](https://poser.pugx.org/zoujingli/ip2region/downloads)](https://packagist.org/packages/zoujingli/ip2region) [![Monthly Downloads](https://poser.pugx.org/zoujingli/ip2region/d/monthly)](https://packagist.org/packages/zoujingli/ip2region) [![Daily Downloads](https://poser.pugx.org/zoujingli/ip2region/d/daily)](https://packagist.org/packages/zoujingli/ip2region) [![PHP Version Require](http://poser.pugx.org/zoujingli/ip2region/require/php)](https://packagist.org/packages/ip2region) [![License](https://poser.pugx.org/zoujingli/ip2region/license)](https://packagist.org/packages/zoujingli/ip2region) # ip2region v3.0 🚀 **企业级 IP 地理位置查询库**：**支持 IPv4 和 IPv6**，智能分片管理，高性能缓存，零依赖。基于官方 [ip2region](https://github.com/lionsoul2014/ip2region) 深度优化，专为 PHP 项目定制，提供毫秒级 IP 地理位置查询服务。 > ⚠️ **重要提示**：由于 V3.0 版本新增了 IPv6 数据库支持，尽管已进行智能压缩优化，但整体体积仍超过 100MB。如果您仅需 IPv4 查询功能，建议使用 V2 版本以获得更小的体积和更快的加载速度。 ## 📦 版本选择 | 特性 | V2.0（轻量级） | V3.0（完整版） | | ------------- | ------------------------------------------- | ------------------------------------------- | | **IPv4 支持** | ✅ | ✅ | | **IPv6 支持** | ❌ | ✅ | | 体积大小 | 10MB+ | 100MB+ | | 性能 | 极快 | 极快 | | 适用场景 | 仅需 IPv4 | 需要 IPv6 或企业级功能 | | Composer 安装 | `composer require zoujingli/ip2region:^2.0` | `composer require zoujingli/ip2region:^3.0` | > ⚠️ **重要提示**：默认的 `composer require zoujingli/ip2region` 命令会安装 V3.0 版本。如需 V2.0 版本，请使用 `composer require zoujingli/ip2region:^2.0`。 ## 🎯 项目简介 ip2region 是一个高性能的 IP 地址定位库，**支持 IPv4 和 IPv6 地址查询**。通过智能分片和压缩技术，实现了大数据库文件的高效管理，为企业和开发者提供准确、快速的 IP 地理位置查询服务。 > 📖 **V2.0 版本文档**：如果您仅需 IPv4 查询功能，建议使用 [V2.0 版本](https://github.com/zoujingli/ip2region/tree/v2.0)，体积更小（10MB+），加载更快。 ## ✨ 核心特性 - **🌍 双协议支持**：**支持 IPv4 和 IPv6 地址查询**，自动识别 IP 版本 - **⚡ 高性能**：基于官方 xdb 格式，查询速度极快，微秒级响应 - **📦 零依赖**：纯 PHP 实现，兼容 PHP 5.4+，无需额外扩展 - **🔧 自定义数据库**：支持自定义 IPv4/IPv6 数据库路径配置 - **🔧 易集成**：支持 Composer 安装，提供函数式和面向对象两种 API - **💾 智能缓存**：支持文件缓存、VectorIndex 缓存、完整数据缓存 - **📊 分片管理**：大文件自动分片（<100MB），支持按需加载和合并 - **🗜️ 智能压缩**：支持 gzip、zip、zstd 多种压缩格式，压缩率高达 81% - **🛡️ 企业级**：完善的错误处理、异常管理和性能监控 - **🔄 懒加载**：IPv4/IPv6 查询器按需创建，优化内存使用 - **💡 零配置**：开箱即用，自动检测数据库版本和格式 ## 📁 项目结构 ``` ip2region/ ├── src/ # 核心源码 │ ├── Ip2Region.php # 主类，支持 IPv4/IPv6 双协议 │ ├── XdbSearcher.php # 官方 xdb 查询器封装 │ └── ChunkedDbHelper.php # 分片文件管理助手 ├── db/ # 分片数据库文件（用户使用） │ ├── ip2region_v4.xdb.part1.zip # IPv4 数据库分片 │ └── ip2region_v6.xdb.part*.gz # IPv6 数据库分片（多个文件） ├── tools/ # 开发工具（内部使用） │ ├── split_db.php # 数据库分片工具 │ ├── ip2region_v4.xdb # IPv4 完整数据库（开发用） │ └── ip2region_v6.xdb # IPv6 完整数据库（开发用） ├── tests/ # 测试文件 │ ├── demo.php # 演示程序 │ └── quick_performance_test.php # 性能测试脚本 ├── doc/ # 详细文档 │ ├── API.md # API 参考 │ ├── CUSTOM_DB_USAGE.md # 自定义数据库使用说明 │ └── DATABASE_DOWNLOAD.md # 数据库下载说明 ├── function.php # 全局函数入口 ├── composer.json # Composer 配置 └── README.md # 项目文档 ``` > **💡 重要提示**： > > - `db/` 目录包含分片数据库文件，用户直接使用，无需关心内部实现 > - `tools/` 目录是开发工具，包含： > - `split_db.php`：数据库分片工具（开发发布用） > - `ip2region_v4.xdb`：IPv4 完整数据库（开发用） > - `ip2region_v6.xdb`：IPv6 完整数据库（开发用） > - 项目已包含分片文件，可直接使用，无需手动生成 > - 如需自定义数据库，请参考 [自定义数据库使用说明](doc/CUSTOM_DB_USAGE.md) ## 🆕 v3.0 新增功能 ### 智能分片管理 - **自动分片**：大文件自动分割为 <100MB 的小文件 - **压缩支持**：支持 gzip/zip 压缩，显著减小文件大小（压缩率可达 60-80%） - **按需合并**：首次使用时自动解压并合并分片文件 - **智能缓存**：合并后的文件缓存到临时目录，避免重复解压合并 - **内存优化**：支持懒加载，IPv4/IPv6 查询器按需创建 ### 增强的 API - **双协议支持**：`ip2region()` 函数自动识别 IPv4/IPv6 - **面向对象**：`Ip2Region` 类提供完整的面向对象接口 - **批量查询**：`batchSearch()` 方法支持批量 IP 查询 - **性能监控**：`getStats()` 和 `getMemoryUsage()` 方法监控性能 ### 企业级特性 - **错误处理**：完善的异常处理和错误提示 - **并发安全**：支持多进程/多线程安全使用 - **缓存策略**：支持文件、VectorIndex、完整数据三种缓存方式 - **PHP 5.4+ 兼容**：完全兼容 PHP 5.4 及以上版本 ## 🚀 快速开始 ### 1. 通过 Composer 安装 ```bash # 安装 V3.0 版本（推荐，功能完整） composer require zoujingli/ip2region:^3.0 # 或安装 V2.0 版本（轻量级，仅 IPv4） composer require zoujingli/ip2region:^2.0 ``` ### 2. 自定义数据库配置项目已包含分片数据库文件，可直接使用。如需使用自定义数据库： ```php <?php require 'vendor/autoload.php'; try { // 使用自定义数据库路径（建议使用绝对路径） $ip2region = new \Ip2Region('file', '/path/to/your/ip2region_v4.xdb', // IPv4 数据库路径 '/path/to/your/ip2region_v6.xdb' // IPv6 数据库路径 ); // 查询示例 echo $ip2region->simple('61.142.118.231') . "\n"; echo $ip2region->simple('2001:4860:4860::8888') . "\n"; } catch (Exception $e) { echo "错误: " . $e->getMessage() . "\n"; } ?> ``` **获取数据库文件**： - **免费版本**：从 [ip2region 官方仓库](https://github.com/lionsoul2014/ip2region) 下载 - **商业版本**：从 [ip2region 官网](https://www.ip2region.net/) 购买或下载 - **详细说明**：请参考 [自定义数据库使用说明](doc/CUSTOM_DB_USAGE.md) ### 3. 一行代码开始使用 ```php <?php require 'vendor/autoload.php'; // 最简单的使用方式 echo ip2region('61.142.118.231') . "\n"; // 中国广东省中山市【电信】 echo ip2region('2001:4860:4860::8888') . "\n"; // 美国加利福尼亚州圣克拉拉【专线用户】 // 使用不同查询方法 echo ip2region('61.142.118.231', 'search') . "\n"; // 中国|广东省|中山市|电信 echo ip2region('61.142.118.231', 'memory') . "\n"; // 返回数组格式 // 或者使用类方式 $ip2region = new \Ip2Region(); echo $ip2region->simple('61.142.118.231') . "\n"; // 中国广东省中山市【电信】 // 使用自定义数据库（可选） $ip2region = new \Ip2Region('file', '/path/to/ip2region_v4.xdb', '/path/to/ip2region_v6.xdb'); echo $ip2region->simple('8.8.8.8') . "\n"; // 美国【Level3】 ?> ``` ### 4. 验证安装 ```bash # 测试 IPv4 查询 composer test:ipv4 # 测试 IPv6 查询 composer test:ipv6 # 测试不同查询方法 composer test:search # 详细查询 composer test:memory # 内存查询 # 查询指定 IP composer query 61.142.118.231 composer query:search 61.142.118.231 composer query:memory 61.142.118.231 # 运行演示程序 composer demo ``` ## 在项目中快速调用 ### 函数式调用 ```php <?php require 'vendor/autoload.php'; // 简单查询 echo ip2region('61.142.118.231') . "\n"; // 中国广东省中山市【电信】 echo ip2region('2001:4860:4860::8888') . "\n"; // 美国加利福尼亚州圣克拉拉【专线用户】 // 使用不同查询方法 echo ip2region('61.142.118.231', 'search') . "\n"; // 中国|广东省|中山市|电信 echo ip2region('61.142.118.231', 'memory') . "\n"; // 返回数组格式 // 批量查询 $ips = ['61.142.118.231', '114.114.114.114', '2001:4860:4860::8888']; foreach ($ips as $ip) { echo "$ip => " . ip2region($ip) . "\n"; } ?> ``` ### 面向对象调用 ```php <?php require 'vendor/autoload.php'; try { // 默认模式（使用分片数据库） $ip2region = new \Ip2Region(); // 如需使用自定义数据库，请参考下面的"自定义数据库配置"部分 // $ip2region = new \Ip2Region('file', '/path/to/your/ip2region_v4.xdb', '/path/to/your/ip2region_v6.xdb'); // 基础查询 echo $ip2region->simple('61.142.118.231') . "\n"; echo $ip2region->search('2001:4860:4860::8888') . "\n"; // 获取详细信息 $info = $ip2region->getIpInfo('61.142.118.231'); print_r($info); // 输出: Array( // [country] => 中国 // [region] => 广东省 // [province] => 中山市 // [city] => 电信 // [isp] => // [ip] => 61.142.118.231 // [version] => v4 // ) // 批量查询 $results = $ip2region->batchSearch(['61.142.118.231', '114.114.114.114']); print_r($results); // 性能监控 $stats = $ip2region->getStats(); echo "内存使用: " . $stats['memory_usage'] . " bytes\n"; echo "IPv4 已加载: " . ($stats['v4_loaded'] ? '是' : '否') . "\n"; echo "IPv6 已加载: " . ($stats['v6_loaded'] ? '是' : '否') . "\n"; } catch (Exception $e) { echo "错误: " . $e->getMessage() . "\n"; } ?> ``` ## 数据库优先级 ### 优先级顺序 IP2Region 采用智能优先级机制，按以下顺序查找数据库文件： 1. **自定义数据库**（最高优先级） - 如果构造函数中指定了自定义路径且文件存在 - 直接使用指定的 `.xdb` 文件 - **完全跳过分片处理**，性能最优 2. **持久化缓存** - 检查系统临时目录中的合并缓存文件 - 验证缓存文件的有效性（大小、时间戳、内容格式） - 如果有效则直接使用 3. **分片文件合并**（默认模式） - 查找 `db/` 目录下的分片文件 - 自动解压并合并成完整数据库 - 生成持久化缓存供后续使用 ### 性能对比 | 模式 | 首次加载 | 后续加载 | 文件数量 | 处理复杂度 | |------|----------|----------|----------|------------| | 自定义数据库 | ~1ms | ~1ms | 1个 | 无 | | 持久化缓存 | ~30ms | ~1ms | 1个 | 无 | | 分片文件合并 | ~30ms | ~1ms | 多个 | 高 | ### 使用建议 - **生产环境**：推荐使用自定义数据库，性能最佳 - **开发环境**：可以使用默认分片模式，方便更新 - **混合使用**：IPv4 用自定义，IPv6 用分片（或反之） ### 自定义数据库配置 ```php <?php require 'vendor/autoload.php'; try { // 使用自定义数据库路径（建议使用绝对路径） $ip2region = new \Ip2Region('file', '/path/to/your/ip2region_v4.xdb', '/path/to/your/ip2region_v6.xdb'); // 查询IP echo $ip2region->simple('8.8.8.8') . "\n"; // 检查是否使用自定义数据库 $customStatus = $ip2region->isUsingCustomDb(); echo "IPv4 使用自定义数据库: " . ($customStatus['v4'] ? '是' : '否') . "\n"; echo "IPv6 使用自定义数据库: " . ($customStatus['v6'] ? '是' : '否') . "\n"; // 动态设置数据库路径 $ip2region->setCustomDbPaths('/path/to/v4.xdb', '/path/to/v6.xdb'); // 获取数据库配置信息 $dbInfo = $ip2region->getDatabaseInfo(); echo "IPv4 路径: " . ($dbInfo['custom_v4_path'] ?: '默认分片') . "\n"; echo "IPv6 路径: " . ($dbInfo['custom_v6_path'] ?: '默认分片') . "\n"; } catch (Exception $e) { echo "错误: " . $e->getMessage() . "\n"; } ?> ``` ## 数据库文件准备 ### 使用预置数据库项目已包含分片数据库文件，位于 `db/` 目录： - `ip2region_v4.xdb.part1` - IPv4 数据库分片 - `ip2region_v6.xdb.part*` - IPv6 数据库分片（多个文件） ### 使用自定义数据库如果需要使用自定义的数据库文件，请按以下步骤操作： #### 1. 获取完整数据库文件 **重要**：必须将完整的 `.xdb` 文件放置到 `tools/` 目录，文件名必须完全匹配： ``` tools/ ├── ip2region_v4.xdb # IPv4 数据库文件（必须） └── ip2region_v6.xdb # IPv6 数据库文件（必须） ``` **文件要求**： - **文件名**：必须严格按照 `ip2region_v4.xdb` 和 `ip2region_v6.xdb` 命名 - **文件位置**：必须放在 `tools/` 目录下 - **文件大小**：IPv4 约 11MB，IPv6 约 617MB - **文件格式**：必须是有效的 xdb 格式文件 **获取数据库文件**： - **免费版本**：从 [ip2region 官方仓库](https://github.com/lionsoul2014/ip2region) 下载 - IPv4 数据库：[ip2region_v4.xdb](https://raw.githubusercontent.com/lionsoul2014/ip2region/master/data/ip2region_v4.xdb) (10.5MB) - IPv6 数据库：[ip2region_v6.xdb](https://raw.githubusercontent.com/lionsoul2014/ip2region/master/data/ip2region_v6.xdb) (617MB) - **商业版本**：从 [ip2region 官网](https://www.ip2region.net/) 购买或下载 - **格式要求**：确保下载的是 `.xdb` 格式，不是 `.txt` 或其他格式 - **版本选择**：建议使用最新版本以获得最准确的地理位置数据 - **重要提醒**：自定义数据库文件需要从官网下载或购买，确保使用正版数据源 #### 2. 分片工具（开发用） > **⚠️ 注意**：此工具仅用于开发发布，普通用户无需使用。项目已包含分片文件，可直接使用。使用项目提供的分片工具将大文件分割为小文件，支持压缩以减小文件大小： ```bash # 基本用法（默认 100MB 分片，gzip 压缩） php tools/split_db.php v4 php tools/split_db.php v6 # 自定义分片大小和压缩方式 php tools/split_db.php v4 50 gzip # IPv4，50MB 分片，gzip 压缩 php tools/split_db.php v6 100 zip # IPv6，100MB 分片，zip 压缩 php tools/split_db.php v4 100 none # IPv4，100MB 分片，不压缩 # 使用绝对路径分割 php tools/split_db.php /path/to/ip2region_v4.xdb 100 gzip php tools/split_db.php /path/to/ip2region_v6.xdb 100 zip # 参数说明： # 第一个参数：版本 (v4/v6) 或文件路径 # 第二个参数：分片大小限制（MB），默认 100 # 第三个参数：压缩方式 (gzip/zip/none)，默认 gzip ``` **压缩方式对比**： - **gzip**：压缩率高，解压速度快，推荐使用 - **zip**：通用性好，兼容性强 - **none**：不压缩，文件较大但处理最快 #### 3. 分片文件说明 - **输入文件**：`db/` 目录下的分片文件 - **输出目录**：`db/` 目录 - **分片命名**： - 未压缩：`ip2region_v4.xdb.part1`, `ip2region_v4.xdb.part2`, ... - gzip 压缩：`ip2region_v4.xdb.part1.gz`, `ip2region_v4.xdb.part2.gz`, ... - zip 压缩：`ip2region_v4.xdb.part1.zip`, `ip2region_v4.xdb.part2.zip`, ... - **分片大小**：默认 100MB，可通过参数调整 - **压缩支持**：支持 gzip、zip 压缩，显著减小文件大小 - **自动解压**：首次使用时自动解压并合并分片文件到临时缓存 #### 4. 实际使用示例 ```bash # 查看当前分片文件 $ ls -la db/ip2region_*.xdb.part* -rw-r--r-- 1 user staff 11042429 Dec 19 10:00 db/ip2region_v4.xdb.part1 -rw-r--r-- 1 user staff 104857600 Dec 19 10:00 db/ip2region_v6.xdb.part1 -rw-r--r-- 1 user staff 104857600 Dec 19 10:00 db/ip2region_v6.xdb.part2 -rw-r--r-- 1 user staff 104857600 Dec 19 10:00 db/ip2region_v6.xdb.part3 -rw-r--r-- 1 user staff 17932583 Dec 19 10:00 db/ip2region_v6.xdb.part4 # 查看分片文件大小 $ du -h db/ip2region_*.xdb.part* 11M db/ip2region_v4.xdb.part1 100M db/ip2region_v6.xdb.part1 100M db/ip2region_v6.xdb.part2 100M db/ip2region_v6.xdb.part3 18M db/ip2region_v6.xdb.part4 # 测试分片文件是否正常工作 $ composer test:ipv4 美国【Level3】 $ composer test:ipv6 美国加利福尼亚州圣克拉拉【专线用户】 ``` ## Composer 脚本项目提供了便捷的 Composer 脚本命令： ```bash # 运行演示程序 composer demo # 测试 IPv4 查询 composer test:ipv4 # 测试 IPv6 查询 composer test:ipv6 # 测试不同查询方法 composer test:search # 详细查询 composer test:memory # 内存查询 # 查询指定 IP composer query 61.142.118.231 composer query:search 61.142.118.231 composer query:memory 61.142.118.231 # 性能测试 composer test:performance # 快速性能测试 # 分割 IPv4 数据库（gzip 压缩，需要先下载数据库文件） composer split:v4 # 分割 IPv6 数据库（gzip 压缩，需要先下载数据库文件） composer split:v6 # 使用 zip 压缩 composer split:v4:zip composer split:v6:zip # 不压缩 composer split:v4:none composer split:v6:none ``` ## API 参考 ### 全局函数 #### `ip2region($ip, $method = 'simple')` - **功能**：全局 IP 地理位置查询函数，提供统一的查询接口 - **特性**： - 自动识别 IPv4/IPv6 地址类型 - 支持多种查询方法和返回格式 - 内置 IP 地址格式验证 - 懒加载机制，按需初始化查询器 - 异常安全，提供详细的错误信息 - **参数**： - `$ip` (string) - IP 地址，支持 IPv4 和 IPv6 格式 - `$method` (string) - 查询方法，可选值：simple, search, memory, binary, btree - **返回**：`string|array|null` - 查询结果，失败时返回 null - **异常**：当 IP 地址格式无效时抛出 `Exception` - **示例**： ```php // 简单查询（默认） echo ip2region('61.142.118.231'); // 输出: 中国广东省中山市【电信】 // 详细查询 echo ip2region('61.142.118.231', 'search'); // 输出: 中国|广东省|中山市|电信 // 内存查询（返回数组） $result = ip2region('61.142.118.231', 'memory'); // 输出: Array([city_id] => 0, [region] => 中国|广东省|中山市|电信) // IPv6 查询 echo ip2region('2001:4860:4860::8888'); // 输出: 美国加利福尼亚州圣克拉拉【专线用户】 // 异常处理 try { $result = ip2region('invalid-ip'); } catch (Exception $e) { echo "错误: " . $e->getMessage(); } ``` #### 查询方法对比 | 方法名 | 描述 | 返回值类型 | 性能特点 | 适用场景 | 示例输出 | | -------- | ---------------- | ---------- | -------- | ---------------------- | ----------------------------------------------------- | | `simple` | 简单查询（默认） | string | 最快 | 一般查询，用户友好显示 | `中国广东省中山市【电信】` | | `search` | 详细查询 | string | 快 | 需要原始数据格式 | `中国\|广东省\|中山市\|电信` | | `memory` | 内存查询 | array | 快 | 需要结构化数据 | `{"city_id":0,"region":"中国\|广东省\|中山市\|电信"}` | | `binary` | 二进制搜索 | array | 中等 | 有序数据快速查找 | `{"city_id":0,"region":"中国\|广东省\|中山市\|电信"}` | | `btree` | B 树索引 | array | 中等 | 大规模数据平衡查询 | `{"city_id":0,"region":"中国\|广东省\|中山市\|电信"}` | #### 使用建议 - **一般查询**：使用 `simple` 方法，返回格式化的地理位置字符串 - **数据处理**：使用 `search` 方法，获取原始数据格式便于解析 - **程序集成**：使用 `memory` 方法，获取结构化数组数据 - **性能优化**：根据数据量选择 `binary` 或 `btree` 方法 - **异常处理**：始终使用 try-catch 包装函数调用 ### Ip2Region 类 #### 构造函数 ```php new Ip2Region($cachePolicy = 'file', $dbPathV4 = null, $dbPathV6 = null) ``` - **参数**： - `$cachePolicy` (string) - 缓存策略：'file', 'vectorIndex', 'content' - `$dbPathV4` (string|null) - IPv4 数据库文件路径，null 表示使用默认分片 - `$dbPathV6` (string|null) - IPv6 数据库文件路径，null 表示使用默认分片 - **示例**： ```php // 默认模式（使用分片数据库） $ip2region = new Ip2Region(); // 使用自定义数据库（建议使用绝对路径） $ip2region = new Ip2Region('file', '/path/to/your/ip2region_v4.xdb', '/path/to/your/ip2region_v6.xdb'); // 只使用自定义 IPv4 数据库，IPv6 使用默认分片 $ip2region = new Ip2Region('file', '/path/to/your/ip2region_v4.xdb', null); ``` #### 核心查询方法 ##### `simple($ip)` - **功能**：简单查询，返回格式化结果 - **参数**：`$ip` (string) - IP 地址 - **返回**：`string|null` - 格式化查询结果 - **示例**：`$ip2region->simple('61.142.118.231'); // 中国广东省中山市【电信】` ##### `search($ip)` - **功能**：基础查询，返回原始结果 - **参数**：`$ip` (string) - IP 地址 - **返回**：`string|null` - 原始查询结果 - **示例**：`$ip2region->search('61.142.118.231'); // 中国|广东省|中山市|电信` ##### `memorySearch($ip)` - **功能**：内存查询，返回数组格式 - **参数**：`$ip` (string) - IP 地址 - **返回**：`array` - 包含 city_id 和 region 的数组 - **示例**：`$ip2region->memorySearch('61.142.118.231'); // ['city_id' => 0, 'region' => '中国|广东省|中山市|电信']` ##### `batchSearch($ips)` - **功能**：批量查询多个 IP - **参数**：`$ips` (array) - IP 地址数组 - **返回**：`array` - IP 地址为键的查询结果数组 - **示例**：`$ip2region->batchSearch(['61.142.118.231', '114.114.114.114']);` ##### `getIpInfo($ip)` - **功能**：获取详细的 IP 信息 - **参数**：`$ip` (string) - IP 地址 - **返回**：`array|null` - 包含 country, region, province, city, isp, ip, version 的数组 - **示例**：`$ip2region->getIpInfo('61.142.118.231');` #### 兼容性方法 ##### `binarySearch($ip)` - **功能**：二进制搜索（兼容旧版本） - **参数**：`$ip` (string) - IP 地址 - **返回**：`array` - 查询结果数组 ##### `btreeSearch($ip)` - **功能**：B 树搜索（兼容旧版本） - **参数**：`$ip` (string) - IP 地址 - **返回**：`array` - 查询结果数组 ##### `searchByBytes($ipBytes)` - **功能**：二进制字节搜索 - **参数**：`$ipBytes` (string) - 二进制 IP 地址 - **返回**：`string|null` - 查询结果 #### 工具方法 ##### `getStats()` - **功能**：获取统计信息 - **返回**：`array` - 包含内存使用、IO 计数、加载状态等 - **示例**：`$stats = $ip2region->getStats();` ##### `getMemoryUsage()` - **功能**：获取内存使用情况 - **返回**：`array` - 包含当前内存、峰值内存、加载状态等 - **示例**：`$memory = $ip2region->getMemoryUsage();` ##### `getIOCount()` - **功能**：获取 IO 计数 - **返回**：`array` - 包含 IPv4、IPv6 和总 IO 计数 - **示例**：`$io = $ip2region->getIOCount();` ##### `getProtocolVersion($ip)` - **功能**：获取 IP 协议版本 - **参数**：`$ip` (string) - IP 地址 - **返回**：`string` - 'v4', 'v6' 或 'unknown' ##### `isIPv4Supported()` - **功能**：检查是否支持 IPv4 - **返回**：`bool` - 是否支持 IPv4 ##### `isIPv6Supported()` - **功能**：检查是否支持 IPv6 - **返回**：`bool` - 是否支持 IPv6 ##### `getDatabaseInfo()` - **功能**：获取数据库信息 - **返回**：`array` - 包含加载状态、缓存策略、版本信息、自定义路径等 ##### `setCustomDbPaths($v4Path, $v6Path)` - **功能**：动态设置自定义数据库路径 - **参数**： - `$v4Path` (string|null) - IPv4 数据库文件路径 - `$v6Path` (string|null) - IPv6 数据库文件路径 - **示例**：`$ip2region->setCustomDbPaths('/path/to/v4.xdb', '/path/to/v6.xdb');` ##### `isUsingCustomDb()` - **功能**：检查是否使用自定义数据库 - **返回**：`array` - 包含 IPv4 和 IPv6 的使用状态 - **示例**：`$status = $ip2region->isUsingCustomDb();` ##### `getCustomDbInfo()` - **功能**：获取自定义数据库文件信息 - **返回**：`array` - 包含自定义数据库文件的大小、修改时间等信息 - **示例**：`$info = $ip2region->getCustomDbInfo();` #### 静态方法 ##### `Ip2Region::clearCache()` - **功能**：清理所有缓存 - **示例**：`Ip2Region::clearCache();` ##### `Ip2Region::clearExpiredCache($days = 7)` - **功能**：清理过期缓存 - **参数**：`$days` (int) - 过期天数 - **示例**：`Ip2Region::clearExpiredCache(7);` ##### `Ip2Region::getCacheStats()` - **功能**：获取缓存统计信息 - **返回**：`array` - 缓存统计信息 - **示例**：`$cacheStats = Ip2Region::getCacheStats();` ## 性能监控示例 ```php <?php require 'vendor/autoload.php'; try { // 默认模式（使用分片数据库） $ip2region = new \Ip2Region(); // 或者使用自定义数据库（建议使用绝对路径） // $ip2region = new \Ip2Region('file', '/path/to/your/ip2region_v4.xdb', '/path/to/your/ip2region_v6.xdb'); // 查询前状态 $statsBefore = $ip2region->getStats(); echo "查询前内存使用: " . $statsBefore['memory_usage'] . " bytes\n"; // 执行查询 $result = $ip2region->simple('61.142.118.231'); echo "查询结果: " . $result . "\n"; // 查询后状态 $statsAfter = $ip2region->getStats(); echo "查询后内存使用: " . $statsAfter['memory_usage'] . " bytes\n"; echo "IPv4 已加载: " . ($statsAfter['v4_loaded'] ? '是' : '否') . "\n"; echo "IPv6 已加载: " . ($statsAfter['v6_loaded'] ? '是' : '否') . "\n"; echo "IPv4 IO 次数: " . $statsAfter['v4_io_count'] . "\n"; echo "IPv6 IO 次数: " . $statsAfter['v6_io_count'] . "\n"; // 内存使用详情 $memory = $ip2region->getMemoryUsage(); echo "当前内存: " . $memory['current'] . "\n"; echo "峰值内存: " . $memory['peak'] . "\n"; } catch (Exception $e) { echo "错误: " . $e->getMessage() . "\n"; } ?> ``` ## 缓存管理示例 ```php <?php require 'vendor/autoload.php'; // 获取缓存统计信息 $cacheStats = \Ip2Region::getCacheStats(); echo "缓存目录: " . $cacheStats['cache_dir'] . "\n"; echo "缓存文件数: " . $cacheStats['file_count'] . "\n"; echo "缓存总大小: " . $cacheStats['total_size'] . " bytes\n"; echo "内存缓存数: " . $cacheStats['memory_cached'] . "\n"; // 清理过期缓存（7天前） \Ip2Region::clearExpiredCache(7); echo "已清理7天前的过期缓存\n"; // 清理所有缓存 \Ip2Region::clearCache(); echo "已清理所有缓存\n"; ?> ``` ## FPM 环境优化 ### FPM 进程模型优化在 FPM（FastCGI Process Manager）环境下，每个进程处理完请求后会保持存活，但静态变量会在进程重启时丢失。本库已针对 FPM 环境进行了优化： #### 智能缓存机制 1. **持久化缓存**：合并后的数据库文件会缓存到系统临时目录 2. **智能验证**：基于文件修改时间和内容格式验证缓存文件的有效性 3. **自动恢复**：进程重启后自动检测并使用有效的缓存文件 4. **避免重复生成**：相同分片文件不会重复合并 5. **自动更新**：当分片文件更新时，自动重新生成缓存 #### 缓存目录 - **默认位置**：`/tmp/ip2region_cache/`（Linux/macOS）或 `C:\Users\用户名\AppData\Local\Temp\ip2region_cache\`（Windows） - **文件命名**：`ip2region_v4.xdb` 和 `ip2region_v6.xdb` - **自动清理**：支持手动清理过期缓存 #### 性能优势 ```php <?php // 第一次请求：合并分片文件并缓存（较慢） $ip2region = new \Ip2Region(); echo $ip2region->simple('61.142.118.231'); // 需要合并分片 // 后续请求：直接使用缓存文件（极快） $ip2region = new \Ip2Region(); echo $ip2region->simple('8.8.8.8'); // 直接使用缓存 ?> ``` #### 缓存管理 ```php <?php // 清理持久化缓存 $cleared = \Ip2Region::clearPersistentCache(); echo "已清理 {$cleared} 个缓存文件\n"; // 获取缓存统计 $stats = \Ip2Region::getCacheStats(); echo "缓存目录: " . $stats['cache_dir'] . "\n"; echo "缓存文件数: " . $stats['file_count'] . "\n"; ?> ``` #### 缓存验证机制 **智能验证策略**： 1. **文件大小检查**：确保缓存文件不小于最小阈值（IPv4: 10MB, IPv6: 100MB） 2. **时间戳对比**：检查缓存文件是否比源分片文件更新 3. **内容格式验证**：验证文件包含地理位置数据（中国、美国、| 等标识符） 4. **自动更新**：当分片文件更新时，自动重新生成缓存 **验证优势**： - 不依赖硬编码的文件大小，适应数据库更新 - 基于文件修改时间，确保缓存与源文件同步 - 内容格式检查，避免使用损坏的缓存文件 - 自动处理分片文件更新，无需手动干预 #### 生产环境建议 1. **预热缓存**：在应用启动时进行一次查询，预热缓存 2. **监控缓存**：定期检查缓存文件大小和有效性 3. **清理策略**：定期清理过期缓存，避免磁盘空间浪费 4. **自定义路径**：对于高并发环境，建议使用自定义数据库路径 5. **分片更新**：更新分片文件后，缓存会自动重新生成 ## 性能测试 ### 快速性能测试运行 `composer test:performance` 进行快速性能测试： ```bash composer test:performance ``` **测试结果示例**： ``` 测试环境信息: ================== 操作系统: Darwin 25.0.0 PHP版本: 8.1.29 内存限制: 128M 最大执行时间: 0秒时区: UTC 当前时间: 2025-09-18 02:46:44 系统负载: 4.05, 3.18, 2.77 当前内存使用: 4MB 峰值内存使用: 4MB 磁盘空间: 587.81GB 可用 / 926.35GB 总计 CPU: Apple M4 Pro CPU核心数: 14 首次加载 vs 缓存命中: IPv4: 32.02ms → 0.5ms (提升 98.4%) (new Ip2Region() + simple()) IPv6: 1174.68ms → 1.03ms (提升 99.9%) (new Ip2Region() + simple()) 查询方法性能: simple: 0.17ms (ip2region->simple()) search: 0.01ms (ip2region->search()) memorySearch: 0.01ms (ip2region->memorySearch()) 批量处理性能: 10个IP: 1.94ms (ip2region->batchSearch()) 10000个IP: 100.75ms (ip2region->batchSearch()) 10000次循环: 55.23ms (10000次 ip2region->simple()) QPS性能: 10个IP: 5155 QPS 10000个IP: 99256 QPS 10000次循环: 181061 QPS 缓存管理性能: 清理缓存: 0.23ms (Ip2Region::clearCache() + clearPersistentCache()) 性能评分: 100/100 性能等级: 优秀 ⭐⭐⭐⭐⭐ ``` ### 性能测试内容快速性能测试包含以下项目： - 首次加载测试（无缓存） - 缓存命中测试 - 不同查询方法性能对比 - 批量查询测试（10个IP + 10000个IP） - 循环查询测试（10000次） - 内存使用测试 - 缓存清理性能测试 - 系统环境信息展示 - 性能评分和等级评定 ### 性能特点 #### 测试环境 - **硬件配置**：Apple M4 Pro (14核心)，16GB+ 内存 - **操作系统**：macOS 15.0 (Darwin 25.0.0) - **PHP版本**：8.1.29 - **磁盘空间**：587GB+ 可用空间 #### 性能指标 1. **首次加载**：需要合并分片文件，IPv4 约 32ms，IPv6 约 1175ms (`new Ip2Region() + simple()`) 2. **缓存命中**：直接使用缓存文件，IPv4 约 0.5ms，IPv6 约 1ms (`new Ip2Region() + simple()`) 3. **性能提升**：IPv4 提升 98.4%，IPv6 提升 99.9% 4. **查询方法**： - `simple()`：约 0.17ms (格式化输出) - `search()`：约 0.01ms (原始数据) - `memorySearch()`：约 0.01ms (数组格式) 5. **批量查询**： - 10个IP：约 1.9ms (5155 QPS) (`ip2region->batchSearch()`) - 10000个IP：约 101ms (99256 QPS) (`ip2region->batchSearch()`) - 10000次循环：约 55ms (181061 QPS) (10000次 `ip2region->simple()`) 6. **内存使用**：当前 4MB，峰值 76.55MB 7. **缓存清理**：约 0.23ms (`Ip2Region::clearCache() + clearPersistentCache()`) 8. **性能评分**：90/100 (优秀 ⭐⭐⭐⭐⭐) #### 性能等级说明 - **90-100分**：优秀 ⭐⭐⭐⭐⭐ (企业级性能) - **80-89分**：良好 ⭐⭐⭐⭐ (生产环境推荐) - **70-79分**：中等 ⭐⭐⭐ (一般应用) - **60-69分**：及格 ⭐⭐ (基础应用) - **0-59分**：需要优化 ⭐ (性能不足) ## 故障排除 ### 常见问题 #### 1. 数据库文件不存在 **错误信息**：`数据库文件不存在: /path/to/ip2region_v4.xdb` **解决方案**： - **检查文件位置**：确保数据库文件存在于 `tools/` 目录下 - **检查文件名**：必须严格按照 `ip2region_v4.xdb` 和 `ip2region_v6.xdb` 命名 - **检查文件权限**：确保文件可读 - **下载数据库文件**：从官方仓库下载完整的 `.xdb` 文件 - **获取数据源**： - 免费版本：从 [ip2region 官方仓库](https://github.com/lionsoul2014/ip2region) 下载 - IPv4：[ip2region_v4.xdb](https://raw.githubusercontent.com/lionsoul2014/ip2region/master/data/ip2region_v4.xdb) (10.5MB) - IPv6：[ip2region_v6.xdb](https://raw.githubusercontent.com/lionsoul2014/ip2region/master/data/ip2region_v6.xdb) (617MB) - 商业版本：从 [ip2region 官网](https://www.ip2region.net/) 购买或下载 - **生成分片文件**： ```bash # 方法1：使用 Composer 脚本 composer split:v4 composer split:v6 # 方法2：直接使用工具 php tools/split_db.php v4 php tools/split_db.php v6 ``` **文件摆放检查**： ```bash # 检查文件是否存在 ls -la db/ip2region_v*.xdb* # 应该看到类似输出： # -rw-r--r-- 1 user staff 11042429 Dec 19 10:00 db/ip2region_v4.xdb.part1.zip # -rw-r--r-- 1 user staff 617000000 Dec 19 10:00 db/ip2region_v6.xdb.part1.gz ``` #### 2. 内存不足 **错误信息**：`Fatal error: Allowed memory size exhausted` **解决方案**： - 增加 PHP 内存限制：`ini_set('memory_limit', '256M');` - 使用文件缓存策略：`new Ip2Region('file')` - 定期清理缓存：`Ip2Region::clearCache()` #### 3. 分片文件损坏 **错误信息**：`无法合并分割的IPv6数据库文件` **解决方案**： - 检查 `db/` 目录下的分片文件是否完整 - 重新分割数据库文件：`composer split:v6` - 清理缓存后重试：`Ip2Region::clearCache()` #### 4. 并发使用问题 **错误信息**：`Too many open files` **解决方案**： - 每个进程/线程创建独立的 `Ip2Region` 实例 - 增加系统文件描述符限制 - 使用内存缓存策略：`new Ip2Region('content')` ### 性能优化建议 1. **使用合适的缓存策略**： - 单次查询：使用 `file` 策略 - 频繁查询：使用 `vectorIndex` 策略 - 高并发：使用 `content` 策略 2. **批量查询优化**： - 使用 `batchSearch()` 方法进行批量查询 - 避免在循环中重复创建实例 3. **内存管理**： - 定期清理过期缓存 - 监控内存使用情况 - 使用懒加载特性 4. **分片文件管理**： - 定期检查分片文件完整性 - 使用 `getCacheStats()` 监控缓存状态 - 合理设置分片大小（<100MB） - 使用压缩减少存储空间和传输时间： ```bash # 生成压缩分片文件（推荐） php tools/split_db.php v4 100 gzip # IPv4，100MB 分片，gzip 压缩 php tools/split_db.php v6 50 gzip # IPv6，50MB 分片，gzip 压缩 # 使用 zip 压缩（兼容性更好） php tools/split_db.php v4 100 zip # IPv4，100MB 分片，zip 压缩 php tools/split_db.php v6 50 zip # IPv6，50MB 分片，zip 压缩 # 检查分片文件 ls -la db/ip2region_*.xdb.part* ``` 5. **压缩优化建议**： - **gzip 压缩**：压缩率高（60-80%），解压速度快，推荐使用 - **zip 压缩**：通用性好，兼容性强，适合跨平台使用 - **无压缩**：处理最快，但文件较大，适合本地使用 - **分片大小**：建议 50-100MB，平衡压缩效果和处理速度 ## 更新日志 ### v3.0.2 (2025-09-18) 🚀 #### 🚀 FPM 环境优化 - **持久化缓存**：智能缓存机制，避免重复合并分片文件 - **缓存验证**：基于文件大小、时间戳、内容格式的智能验证 - **性能提升**：IPv4 提升 98.4%，IPv6 提升 99.9% - **自动恢复**：进程重启后自动检测并使用有效缓存 #### 📊 性能测试增强 - **系统信息**：详细的硬件配置和系统环境展示 - **性能评分**：基于多维度指标的综合性能评分系统 - **方法说明**：每个测试都显示具体调用的方法 - **测试覆盖**：首次加载、缓存命中、批量查询、循环测试 #### 📚 文档完善 - **优先级说明**：详细的数据库优先级机制说明 - **自定义配置**：完整的自定义数据库配置指南 - **项目结构**：优化的项目结构说明和目录分类 ### v3.0.1 (2025-09-16) 🔧 #### 🔧 自定义数据库配置 - **自定义路径**：支持指定 IPv4 和 IPv6 数据库文件路径 - **智能优先级**：自定义数据库 > 持久化缓存 > 分片文件合并 - **性能优化**：使用自定义数据库时完全跳过分片处理，启动更快 - **灵活配置**：可以混合使用自定义数据库和默认分片文件 - **格式支持**：支持标准的 `.xdb` 格式数据库文件 #### 🚀 API 增强 - **新增方法**： - `setCustomDbPaths($v4Path, $v6Path)` - 设置自定义数据库路径 - `isUsingCustomDb()` - 检查是否使用自定义数据库 - `getCustomDbInfo()` - 获取自定义数据库信息 - **增强方法**： - `getDatabaseInfo()` - 现在包含自定义数据库信息 - `createSearcher()` - 支持自定义数据库路径参数 #### 🔧 兼容性改进 - **PHP 5.4+**：完全兼容 PHP 5.4 及以上版本 - **语法优化**：替换了 PHP 5.5+ 特有的语法特性 - **错误处理**：增强了自定义数据库文件的错误处理机制 #### 📚 文档完善 - **使用指南**：添加了详细的自定义数据库配置说明 - **下载指南**：提供了数据库文件获取的完整指南 - **示例代码**：包含了丰富的使用示例和最佳实践 ### v3.0.0 (2025-09-15) 🚀 #### 🎯 企业级优化 - 重构架构，支持分片文件自动管理 - **压缩支持**：支持 gzip/zip 压缩，文件大小减少 60-80% - 智能缓存机制，避免重复解压合并文件 - 懒加载设计，IPv4/IPv6 查询器按需创建 #### 🚀 性能提升 - 微秒级查询速度 - 内存使用优化至 <8MB - 支持三种缓存策略：file、vectorIndex、content #### 🆕 新增功能 - 批量查询支持：`batchSearch()` 方法 - 性能监控：`getStats()` 和 `getMemoryUsage()` 方法 - 详细 IP 信息：`getIpInfo()` 方法 - 缓存管理：`clearCache()` 和 `clearExpiredCache()` 方法 #### 🛡️ 企业级特性 - 完善的错误处理和异常管理 - 支持多进程/多线程安全使用 - 完全兼容 PHP 5.4+ 版本 - 零依赖，纯 PHP 实现 #### 📱 IPv6 支持 - 完整支持 IPv6 地址查询 - 自动识别 IP 版本 - 分片文件管理优化大文件处理 #### 🔧 开发友好 - 统一 API 设计 - 函数式和面向对象两种使用方式 - 完整的 API 文档和示例 - Composer 脚本支持 ## 许可证本项目基于 Apache-2.0 许可证开源。 ## 🔧 通用查询函数 IP2Region 提供了通用的 `ip2region()` 函数，支持多种查询方法： ### 函数签名 ```php ip2region(string $ip, string $method = 'simple'): string|array|null ``` ### 支持的查询方法 | 方法 | 描述 | 返回值 | 示例 | | -------- | ---------------- | ---------------------- | ---------------------- | | `simple` | 简单查询（默认） | 格式化的地理位置字符串 | `"美国【Level3】"` | | `search` | 详细查询 | 管道分隔的详细信息 | `"美国\|0\|0\|Level3"` | | `binary` | 二进制查询 | 原始二进制数据 | 二进制字符串 | | `btree` | B 树查询 | B 树索引查询结果 | 查询结果字符串 | | `memory` | 内存查询 | 内存中的查询结果 | 查询结果字符串 | ### 使用示例 ```php <?php require 'vendor/autoload.php'; // 简单查询（默认方法） echo ip2region('61.142.118.231'); // 输出: 中国广东省中山市【电信】 // 详细查询 echo ip2region('61.142.118.231', 'search'); // 输出: 中国|广东省|中山市|电信 // 内存查询（返回数组） $result = ip2region('61.142.118.231', 'memory'); print_r($result); // 输出: Array([city_id] => 0, [region] => 中国|广东省|中山市|电信) // IPv6查询 echo ip2region('2001:4860:4860::8888'); // 输出: 美国加利福尼亚州圣克拉拉【专线用户】 // 异常安全 $result = ip2region('invalid-ip'); // 返回: null if ($result === null) { echo "IP地址无效或查询失败"; } ``` ### 特性说明 - **自动识别**：自动识别 IPv4 和 IPv6 地址 - **分片支持**：自动处理分片数据库文件 - **智能缓存**：内置缓存机制，提升查询性能 - **异常安全**：查询失败返回 null，不会抛出异常 - **静态实例**：使用静态实例，避免重复初始化 ## 🔄 版本切换如果您需要从 V3.0 切换到 V2.0 或反之，请按以下步骤操作： ### 从 V3.0 切换到 V2.0 ```bash # 卸载 V3.0 版本 composer remove zoujingli/ip2region # 安装 V2.0 版本 composer require zoujingli/ip2region:^2.0 ``` ### 从 V2.0 升级到 V3.0 ```bash # 升级到 V3.0 版本 composer require zoujingli/ip2region:^3.0 ``` > ⚠️ **注意事项**： > > - V2.0 仅支持 IPv4 查询，升级到 V3.0 后可使用 IPv6 功能 > - V2.0 体积 10MB+，V3.0 体积 100MB+，请确保服务器有足够空间 > - 代码兼容性：V2.0 的 API 在 V3.0 中完全兼容 ## 📚 相关文档 - [V2.0 版本文档](https://github.com/zoujingli/ip2region/tree/v2.0) - 轻量级版本，仅支持 IPv4 - [V3.0 版本文档](https://github.com/zoujingli/ip2region/tree/master) - 完整版本，支持 IPv4 + IPv6 - [文档中心](doc/) - 完整的文档索引和导航 - [API 文档](doc/API.md) - 完整的 API 参考文档 - [自定义数据库配置说明](doc/CUSTOM_DB_USAGE.md) - 自定义数据库路径配置详细说明 - [数据库文件下载说明](doc/DATABASE_DOWNLOAD.md) - 如何获取和配置自定义数据库文件 - [贡献指南](doc/CONTRIBUTING.md) - 如何参与项目贡献 - [官方 ip2region 项目](https://github.com/lionsoul2014/ip2region) - 原始项目 ## 贡献欢迎提交 Issue 和 Pull Request 来改进这个项目。 ## 联系方式如有问题或建议，请通过以下方式联系： - **GitHub Issues**：[提交问题或建议](https://github.com/zoujingli/ip2region/issues) - **邮箱**：[email protected] - **作者主页**：[https://thinkadmin.top](https://thinkadmin.top) ", Assign "at most 3 tags" to the expected json: {"id":"8596","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"

AI prompts