如何在 XAMPP 中解决无法加载动态链接库（php_*.dll）的问题-php教程-PHP中文网

Mac/Linux下XAMPP启用Windows专用.dll扩展是常见报错根源，因系统只识别.so文件；需注释php.ini中所有含.dll的extension=行并重启服务。

如何在 xampp 中解决无法加载动态链接库（php_*.dll）的问题

Mac/Linux 下 XAMPP 启用了 Windows 专用的 `.dll` 扩展

这是 macOS 或 Linux 上 XAMPP 最常见的报错根源：你在 /Applications/XAMPP/xamppfiles/etc/php.ini（macOS）或 /opt/lampp/etc/php.ini（Linux）里看到一堆 extension=php_pdo_mysql.dll、extension=php_intl.dll 这样的行，但 macOS/Linux 根本不认 .dll 文件——它们只加载 .so（shared object）文件。

直接后果就是启动 PHP 时刷出一连串 Unable to load dynamic library ... php_*.dll - image not found 或 invalid ELF header 错误。

打开 php.ini，搜索所有含 .dll 的 extension= 行
把它们全部用分号注释掉，例如：;extension=php_pdo_mysql.dll
保存后重启 Apache（或整个 XAMPP）
如果需要启用对应扩展（如 PDO MySQL），XAMPP 在 Unix 系统下已预编译好 .so 版本，通常无需手动开启——只要模块本身被编译进 PHP（phpinfo() 中能看到 pdo_mysql 已启用），就不用管 extension= 那一行

Windows 下 `php_*.dll` 报“找不到指定的模块”

这个错误不是因为路径写错了，而是依赖缺失：PHP 扩展本身是 DLL，但它可能依赖 Visual C++ 运行库、Oracle 客户端、SQL Server Native Client 等外部二进制文件。系统找不到这些依赖，就会报 找不到指定的模块（error 126）。

先确认你的 PHP 是 TS（线程安全）还是 NTS（非线程安全）版本：访问 http://localhost/dashboard/phpinfo.php，查 Thread Safety 项。值为 enabled → 用 _ts.dll；disabled → 用 _nts.dll
检查扩展名是否匹配 PHP 主版本和小版本，比如 PHP 8.2 要用 php_parallel-1.4.0-8.2-ts-vc15-x64.dll 这类命名的文件，不能混用 8.1 或 VC16 编译的
把扩展依赖的 DLL（如 oci.dll、msvcr120.dll、sqlncli11.dll）复制到 C: mpppachein 目录（Apache 启动时会优先从这里找依赖）
别把扩展放在 C: mppphpext 却让 extension_dir 指向别的路径——用 phpinfo() 确认当前生效的 extension_dir 值

扩展路径正确但依然加载失败：检查 `extension_dir` 和权限

即使 .dll 或 .so 文件就在 ext/ 目录下，PHP 也可能根本没去那里找——因为 php.ini 里 extension_dir 配置被改过，或者路径中包含中文、空格、符号导致解析失败。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 phpinfo() 页面搜索 extension_dir，确认显示的路径和你放扩展的物理路径完全一致（注意末尾斜杠有无、大小写、符号转义）
Windows 下路径不要用反斜杠写死在 php.ini 里，统一用正斜杠 / 或双反斜杠 \，例如：extension_dir = "C:/xampp/php/ext"
macOS/Linux 下确保 .so 文件有可读权限：chmod 644 /opt/lampp/lib/php/extensions/no-debug-non-zts-*/php_intl.so
某些扩展（如 php_opcache.dll）要求必须放在 php.ini 中靠前位置加载，否则依赖它的其他扩展会失败——把它移到所有 extension= 行最上面试试

PHP 8+ 下部分扩展已废弃或需手动编译

PHP 8.0 起移除了 mysql 扩展，8.2 起默认禁用 zend.ze1_compatibility_mode；而像 parallel、amqp、rdkafka 这类较新的扩展，XAMPP 官方包根本没打包进去，也不能直接下载 Windows DLL 就用。

php_mysql.dll 已彻底删除，必须改用 mysqli 或 PDO MySQL，代码里别再调 mysql_connect()
PECL 扩展如 parallel 在 Windows 上没有官方预编译包支持 PHP 8.2+，你得自己用 phpize + VS 工具链编译，或换用 WAMP/PHP 官方二进制包 + 手动配 ext
用 php -m 命令快速验证扩展是否真被加载，比看 Apache 日志更直接；如果扩展名不在列表里，说明 php.ini 没生效或路径错

最容易被忽略的一点：XAMPP 控制面板启动的是它自带的 Apache，但如果你同时装了其他服务（如 IIS、Docker 的 MySQL），它们可能劫持了配置文件或端口，导致你改了 php.ini 却始终不生效——务必确认你编辑的是 Apache 实际加载的那个 php.ini，而不是某个备份或旧版本残留文件。