XAMPP环境下安装RabbitMQ扩展 XAMPP消息队列集成-php教程-PHP中文网

php amqp扩展在xampp下安装失败90%因版本错配或dll/.so路径错误，需严格匹配php版本、位数（x86/x64）及线程模型（ts/nts），windows下须同时放置php_amqp.dll至ext目录并配置extension=，另将rabbitmq.4.dll放php根目录且通过httpd.conf的loadfile显式加载。

xampp环境下安装rabbitmq扩展 xampp消息队列集成

PHP 的 AMQP 扩展在 XAMPP 下装不上，90% 是因为版本错配或 DLL / .so 加载路径不对，不是 PHP 配置漏了 extension= 这一行。

确认 PHP 版本和线程安全（TS/NTS）类型

Windows 下的 php_amqp.dll 必须严格匹配当前 XAMPP 中 PHP 的版本、位数（x86/x64）、线程模型（TS 或 NTS）。不匹配会导致 Apache 启动失败，或 phpinfo 里完全看不到 amqp 模块。

运行 php -v 查看 PHP 版本（如 PHP 7.4.33）
运行 php -i | findstr "Thread Safety"（Windows）或 php -i | grep "Thread Safety"（Linux/macOS），确认是 enabled（TS）还是 disabled（NTS）
去 https://www.php.cn/link/d5c4a9269e461042632f0e07414edf9d 找对应版本：比如 PHP 7.4 TS x64 → 下载 amqp-1.10.2-win32.zip 或类似命名的包
别直接用“最新版”，PECL 页面上每个版本都标注了支持的 PHP 范围和构建类型

Windows：DLL 文件放哪、怎么加载

Windows 下 XAMPP 的 AMQP 不是只复制一个 DLL 就完事。它依赖两个文件，且加载方式不同：

XAMPP 8.0.30

XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin

下载

php_amqp.dll 放到 XAMPP\php\ext\ 目录下，然后在 php.ini 里加 extension=php_amqp.dll
rabbitmq.4.dll（或类似名称，如 rabbitmq-4.dll）不能放 ext 里，必须放在 XAMPP\php\ 根目录（即和 php.exe 同级）
Apache 需要显式加载该 DLL：编辑 XAMPP\apache\conf\httpd.conf，在末尾加一行 LoadFile "D:/xampp/php/rabbitmq.4.dll"（路径按实际调整）
如果系统是 64 位，且用了 32 位 XAMPP，rabbitmq.4.dll 还得额外复制到 C:\Windows\SysWOW64\；否则 Apache 可能报找不到模块

Linux（Ubuntu）下 XAMPP 编译安装常见断点

Linux 下 XAMPP 自带的是闭源编译环境，/opt/lampp/bin/phpize 和 /opt/lampp/bin/php-config 必须全程使用，不能混用系统自带的工具，否则生成的 .so 无法加载。

先装 rabbitmq-c 依赖：解压后 ./configure --prefix=/usr/local/rabbitmq-c，再 make && make install
进 amqp 源码目录后，必须用 XAMPP 的 phpize：/opt/lampp/bin/phpize
./configure 时关键参数不能少：--with-php-config=/opt/lampp/bin/php-config --with-librabbitmq-dir=/usr/local/rabbitmq-c
编译完的 amqp.so 路径由 make install 输出决定，例如 /opt/lampp/lib/php/extensions/no-debug-non-zts-20190902/amqp.so，这个路径要完整写进 php.ini 的 extension= 行里，不能只写文件名
改完 php.ini 后，必须重启整个 XAMPP：/opt/lampp/lampp restart，不是只重启 Apache

验证失败时优先查这三件事

phpinfo 页面没出现 amqp，或者 php -m | grep amqp 没输出，别急着重装，先快速过一遍这些硬性条件：

Apache 错误日志里有没有 PHP Warning: Unable to load dynamic library 'php_amqp.dll' 或类似报错？有就说明路径或依赖缺失
php -m 输出里有没有 amqp？没有说明扩展根本没注册成功；有但 phpinfo 没显示，可能是配置了多个 php.ini，php --ini 看实际加载的是哪个
Linux 下用 ldd /opt/lampp/lib/php/extensions/.../amqp.so 检查是否缺 librabbitmq.so，缺的话要加 /usr/local/rabbitmq-c/lib 到 /etc/ld.so.conf.d/rabbitmq-c.conf 并执行 ldconfig

最容易被忽略的是：XAMPP 的 PHP 和系统 PHP 完全隔离，所有路径、工具、依赖都得跟着它走，跨环境复用配置几乎必然失败。