phpEnv 中无法使用旧版 geoip 扩展，因 Windows 缺失 PECL 编译链且该扩展已停更；应改用 Composer 安装 geoip2/geoip2 包，配合 MaxMind GeoLite2 .mmdb 数据库实现 IP 定位。
phpEnv 是 Windows 下的 PHP 多版本环境管理工具（类似 Linux 的 phpbrew），但它不内置 GeoIP 扩展安装功能，也不通过自己的仓库分发扩展。所有扩展都需手动编译或适配已编译好的 .dll 文件，并配置到对应 PHP 版本的 ext 目录中。
phpEnv 环境下找不到 php-pecl-geoip 怎么办
phpEnv 本身没有 yum 或 pecl 命令，也不能直接运行 pecl install geoip —— 因为 Windows 下 PECL 编译链缺失，且官方早已停止维护旧版 geoip 扩展的 Windows 构建。
常见错误现象：
- 运行
pecl install geoip报错：Cannot find autoconf或no build system - 下载第三方提供的
php_geoip.dll后，php -m不显示、或启动时报PHP Startup: Unable to load dynamic library 'geoip' -
geoip_record_by_name()函数不存在
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要尝试在
phpEnv中用pecl安装旧版geoip扩展（它依赖 libGeoIP.dll，而该库已停更，且无 Windows 官方二进制） - 若必须用传统函数接口，可找与当前 PHP 版本、线程安全（TS/NTS）、架构（x64/x86）严格匹配的预编译
php_geoip.dll（极难找全，PHP 8.1+ 基本不可用） - 更现实的做法：跳过 C 扩展，改用纯 PHP 的
geoip2/geoip2Composer 包（推荐）
用 Composer + GeoIP2 在 phpEnv 中实现 IP 定位
这是目前在 phpEnv 上最稳定、可复现、且支持最新 MaxMind 数据库（.mmdb）的方式。
使用场景：
- 项目已用 Composer 管理依赖
- 需要国家/城市/经纬度等结构化数据
- 不想折腾 DLL、VC 运行库、PHP 编译版本对齐
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行：
composer require geoip2/geoip2（确保phpEnv当前激活的 PHP 版本支持 Composer） - 注册 MaxMind 账号，下载免费版
GeoLite2-Country.mmdb或GeoLite2-City.mmdb，存到项目目录如data/GeoLite2-City.mmdb - 代码中加载：
$reader = new \GeoIp2\Database\Reader('data/GeoLite2-City.mmdb'); $record = $reader->city($_SERVER['REMOTE_ADDR']); echo $record->country->name; // China echo $record->city->name; // Beijing echo $record->location->latitude; - 注意：PHP 需启用
mbstring和json扩展（phpEnv默认已开，可用php -m | findstr "mbstring json"确认）
为什么不能直接复制 Linux 的 geoip.so 到 phpEnv
参数差异与兼容性影响：
-
.so是 Linux 动态库，Windows 只认.dll - 即使找到同名
php_geoip.dll，也大概率依赖旧版libGeoIP.dll（MaxMind 已于 2019 年终止 GeoLite Legacy 支持） - PHP 7.4+ 的 TS/NTS 模式、VC 编译器版本（VC15/VC16/VC17）必须与 DLL 完全一致，否则
php -m加载失败且无明确报错 -
geoip.so无法读取新版.mmdb格式，只能读.dat（已下线）
容易踩的坑：
- 下载来源不明的 DLL（含后门或病毒）
- 忽略 PHP 架构（x86 vs x64）——
phpEnv默认是 x64，但很多老 DLL 是 x86 - 把
extension=geoip写进错误的php.ini（phpEnv每个 PHP 版本有独立 ini，路径类似C:\phpEnv\php\php-8.2.12-Win32-vs16-x64\php.ini）
phpEnv 中验证 GeoIP2 是否正常工作的最小检查点
性能与可靠性提示：
-
GeoIp2\Database\Reader实例应复用，不要每次请求都新建（避免重复 mmap 文件） - 免费数据库精度有限，国内城市级定位常偏差 50–200km，仅适合国家/省份粗筛
-
.mmdb文件需保证 PHP 进程有读权限（Windows 下注意 NTFS 权限，非仅文件属性）
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先用固定 IP 测试（如
8.8.8.8），排除客户端 IP 获取逻辑干扰 - 检查文件路径是否含中文或空格（
Reader构造时会静默失败） - 运行：
php -r "$r = new \GeoIp2\Database\Reader('data/GeoLite2-City.mmdb'); var_dump($r->country('8.8.8.8')->country->isoCode);" - 若报
Class 'GeoIp2\Database\Reader' not found，说明 autoloader 未加载，确认vendor/autoload.php已引入
旧版 geoip 扩展在 phpEnv 中基本不可用，不是配置问题，而是生态断层——MaxMind 停更、PHP 官方移除支持、Windows 编译链缺失。绕过 DLL，走 Composer + .mmdb 是唯一靠谱路径。
