PHP扩展加载失败主因是extension_dir路径错误、DLL/SO文件位置不当、ABI不匹配或依赖缺失，需核对php.ini路径、修正extension_dir为绝对路径、确认扩展与PHP版本及线程安全模式兼容，并检查DLL依赖和权限。
这个问题基本就是扩展路径或依赖没对上，不是 PHP 版本不兼容，就是 extension_dir 指错了，或者 .dll/.so 文件根本没放对位置。
检查 extension_dir 是否指向真实存在的目录
phpEnv 默认不会自动同步系统级的扩展路径，它用的是自己解压出来的 PHP 副本，php.ini 里的 extension_dir 很可能还留着旧值（比如 "C:phpext"），但实际 phpEnv 把扩展放在 phpenv ersions{版本号}ext 下。
- 运行
php --ini确认当前生效的php.ini路径 - 打开该文件，找到
extension_dir行，改成绝对路径，例如：extension_dir = "D:phpenv ersions8.2.12ext" - 注意 Windows 下路径分隔符用反斜杠
，但必须是双反斜杠\或正斜杠/，否则 PHP 会解析失败 - 改完后务必重启 Web 服务（如 Apache）或终端（CLI 场景下需新开命令行）
确认扩展文件名和 PHP 版本 ABI 兼容
PHP 扩展不是“扔进去就能用”，php_sockets.dll 这类名字只是通用名，实际要匹配你当前 PHP 的编译配置：NTS/TS、x64/x86、VC 版本（如 VC17）、以及主版本号（8.2 vs 8.3）。
- 在 phpEnv 安装目录里找
phpenv ersions8.2.12php.exe，执行php -v和php -i | findstr "Thread Safety|Architecture|Compiler" - 输出含
Thread Safety => disabled→ 用 NTS 版扩展；含enabled→ 用 TS 版 - 扩展文件必须来自与当前 PHP 同源的二进制包（比如 php.net 官方 ZIP 包里的
ext目录，或经 phpEnv 自动下载的版本） - 别直接从老 PHP 文件夹拷
php_curl.dll过来——哪怕名字一样，ABI 不匹配就会静默失败或报 “Unable to load dynamic library”
Windows 下 DLL 依赖缺失导致加载失败
很多扩展（如 php_opcache.dll、php_mysqli.dll）依赖 libmysql.dll、ssleay32.dll 等运行时库。phpEnv 不会自动把它们扔进系统 PATH，所以即使扩展文件存在，也会因找不到依赖而报错。
立即学习“PHP免费学习笔记（深入）”；
- 用
depends.exe（Dependency Walker）或ldd（WSL）检查扩展 DLL 缺少哪些 DLL - 常见解法：把 phpEnv 自带的
phpenv ersions{版本}整个目录加到系统PATH，或只把phpenv ersions{版本}加进去（确保它在 PATH 最前面） - 验证方式：在 CMD 中执行
where libmysql.dll，应返回 phpEnv 对应版本路径下的文件 - Apache 场景下，还需确认
httpd.conf中LoadFile是否提前加载了冲突的 DLL（比如两个不同版本的libcrypto-1_1.dll）
Linux/macOS 下 .so 权限与 ldconfig 缓存问题
虽然 phpEnv 主打 Windows，但它也支持 Linux/macOS；此时报 “Unable to load dynamic library” 多半不是路径错，而是权限或动态链接器缓存没更新。
- 确认
.so文件有可读+可执行权限：chmod 755 /path/to/phpenv/versions/8.2.12/ext/opcache.so - 如果扩展依赖自定义路径（如
/opt/openssl/lib），需在/etc/ld.so.conf.d/phpenv.conf里添加该路径，再运行sudo ldconfig - PHP CLI 和 Web SAPI（如 FPM）可能使用不同用户运行，检查
opcache.so所在目录是否对www-data或_www用户可读 - 临时调试可用
LD_DEBUG=libs php -m | grep opcache查看动态库加载过程
最常被忽略的是：phpEnv 切换版本后，php.ini 不会自动切换 —— 它只改环境变量 PATH 和 PHPROOT，但 ini 文件仍指向旧版本。每次 phpenv use 后，务必手动核对 php --ini 输出的配置路径，并确认该文件里的 extension_dir 和 extension= 行都匹配当前版本。否则，警告照出，连 php -m 都看不到那个扩展。
