zoujingli/ip2region

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

1432 stars · 210 forks observed · 2026-10-05

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A PHP library for offline IP geolocation lookups based on the ip2region XDB data format, supporting IPv4 and IPv6 with multiple caching strategies. It ships with a bundled IPv4 database and provides both a global helper function and an object-oriented API, plus a CLI tool for managing database files.

Use cases

• look up the city and ISP of an IP address in PHP
• offline IP geolocation without external API calls
• resolve IPv6 addresses to regions
• identify private, loopback, and reserved IP addresses
• batch query IP locations with caching
• download and manage ip2region XDB database files

When to choose

• you need fast, offline IP-to-region lookups in a PHP 7.1+ application with no extension dependencies
• you want a bundled IPv4 database that works out of the box via Composer
• you need both functional and OOP APIs plus caching modes for performance tuning

When to avoid

• you need global, street-level, or highly precise geolocation data
• your project is not in PHP
• you require IPv6 support without downloading an extra database file

Facets

library · maturity active

search-engine cli developer-tools networking developer-tools php cli cross-platform ip-geolocation ip2region offline-database ipv4 ipv6 xdb composer-package command-line

Member repositories

For agents

markdown · JSON · MCP: product_card(name="zoujingli/ip2region")