phpEnv 会自动将 extension_dir 设为所选 PHP 版本目录下 ext 子目录的 realpath 绝对路径，手动填写相对路径或错误格式会导致“找不到动态库”；应通过 php -r "echo ini_get('extension_dir');" 查看实际生效路径，并优先将扩展文件放入 phpEnv 自动管理的 ext 目录。
phpEnv 默认不自动适配 extension_dir，直接复制 PHP 安装包里的 ext 目录路径进去多半会失效——根本原因是它用的是「运行时解析的绝对路径」，而你填的可能是相对路径或硬编码路径。
extension_dir 在 phpEnv 里为什么总报“找不到动态库”
常见错误现象：PHP Warning: PHP Startup: Unable to load dynamic library 'redis' 或 Warning: Cannot load module 'xdebug'...。不是扩展没编译，也不是 DLL/SO 文件缺失，而是 extension_dir 指向了一个 PHP 实际无法访问的路径。
phpEnv 启动时会重写 php.ini 中的 extension_dir，但它的逻辑是：取当前所选 PHP 版本目录下的 ext 子目录，并**用 realpath() 展开为绝对路径**。如果你手动改过 extension_dir（比如写成 ./ext、ext 或 D:phpext），它会在加载前被覆盖或校验失败。
- phpEnv 的配置优先级：自身识别路径 > ini 中手动写的路径 > 环境变量
- Windows 下注意反斜杠转义问题：
D:php8.2ext要写成D:\php\8.2\ext或正斜杠D:/php/8.2/ext，否则ini解析会截断 - Linux/macOS 下路径必须存在且 PHP 进程有读权限；若用符号链接，确保
realpath()能穿透（phpEnv 依赖这个）
怎么查 phpEnv 实际生效的 extension_dir
别猜，直接让 PHP 自己说：
立即学习“PHP免费学习笔记（深入）”；
php -r "echo ini_get('extension_dir');"
这个命令输出的路径，才是 phpEnv 最终使用的值。如果和你预期不符，说明 phpEnv 已接管并修正了它。
- 输出为空？检查是否启用了正确的 PHP 版本：
phpenv use 8.2再试 - 输出是类似
C:phpenv ersions8.2.12ext——说明 phpEnv 成功定位，此时你要把.dll文件放进去，而不是去改php.ini - 输出是
/tmp/ext这类明显错位的路径？大概率是 phpEnv 配置文件损坏，删掉~/.phpenv/versions/8.2.12/etc/php.ini让它重建
手动指定 extension_dir 的正确姿势（不推荐但有时必须）
仅当你要混用不同版本扩展（比如用 8.1 编译的 xdebug.so 跑在 8.2 上），才需绕过 phpEnv 自动路径。操作前提是：你知道自己在做什么，且已验证该 SO/DLL 兼容当前 PHP ABI。
- 编辑 phpEnv 生成的
php.ini（路径通常为~/.phpenv/versions/8.2.12/etc/php.ini） - 在
[Extension Manager]段落之后、任何extension=行之前，插入一行：extension_dir = "D:/my-exts"（Windows）或extension_dir = "/usr/local/php-exts"（Linux/macOS） - 务必确认该路径下只有合法扩展文件（
.dll或.so），且文件名与extension=xxx中的一致 - 改完后执行
phpenv rehash，再用上面的php -r命令验证是否生效
最稳妥的做法永远是：把扩展文件放进 phpEnv 自动管理的 ext 目录，然后只通过 extension= 启用。路径错位问题八成出在试图“跳过 phpEnv 的路径逻辑”，而不是扩展本身。记住，phpEnv 不是普通 PHP 封装，它对 extension_dir 有强控制——对抗它，不如顺着它走。
