ThinkPHP集成RabbitMQ环境的依赖安装_PHP扩展适配指南-ThinkPHP-PHP中文网

必须安装 amqp 扩展，依赖 librabbitmq c 库，php ≥ 7.4，linux/macos 需配置 cli 模式 php.ini 启用 extension=amqp.so，vhost 和 port 必须显式配置为字符串或整型，不支持 amqps。

thinkphp集成rabbitmq环境的依赖安装_php扩展适配指南

PHP需要安装哪些扩展才能用RabbitMQ

直接说结论：必须装 amqp 扩展，不能只靠 php-amqplib 这类纯PHP库顶替。后者在高并发或长连接场景下容易丢消息、超时、连接复用失效，而 amqp 是基于 librabbitmq C 库的原生绑定，性能和稳定性差一个量级。

常见错误是只 composer require php-amqplib/php-amqplib 就以为齐活了——结果上线后消费者进程隔几小时就静默退出，日志里连错误都没留下。

amqp 扩展依赖系统级的 librabbitmq（不是 librabbitmq-dev，Ubuntu/Debian 下装后者，CentOS/RHEL 下要先 yum install rabbitmq-c-devel）
PHP 版本需 ≥ 7.4；PHP 8.2+ 需确认 amqp 扩展已发布兼容版本（截至 2024 年中，amqp 1.11.0+ 支持 PHP 8.2）
Windows 下基本不建议走 amqp 扩展路线，CI/CD 和生产环境一致性难保障，优先改用 Docker 容器化部署

ThinkPHP 6/7 中如何正确加载 amqp 扩展

很多项目跑 php -m | grep amqp 显示已加载，但 TP 启动队列命令时仍报 Class 'AMQPConnection' not found——根本原因是 CLI SAPI 和 Web SAPI 的 php.ini 不同，而 ThinkPHP 的 queue:work 是走 CLI 模式。

检查路径：php --ini 输出的 Loaded Configuration File 必须包含 extension=amqp.so（Linux/macOS）或 extension=php_amqp.dll（Windows，极不推荐）；Web 环境的 php.ini 是否启用不影响队列运行。

btpanel phpsite 宝塔面板PHP网站

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

下载

使用 php -r "var_dump(extension_loaded('amqp'));" 在 CLI 下直验，返回 bool(true) 才算真正可用
若用宝塔、AMH 等面板，注意其 PHP 管理界面常只修改 Web 模式的配置，CLI 模式需手动编辑对应版本的 /www/server/php/{version}/bin/php.ini
容器内部署时，Dockerfile 中不要只写 pecl install amqp，得补上 docker-php-ext-enable amqp，否则扩展不会被启用

amqp 扩展与 php-amqplib 共存时的冲突点

两者共存本身不报错，但会埋下隐性坑：比如你用 php-amqplib 写了个临时脚本测试连接，它能通；可 TP 队列驱动底层若误判环境（如通过 class_exists('AMQPConnection') 判断是否启用原生扩展），可能跳过连接池逻辑，导致消费者反复重建 TCP 连接。

ThinkPHP 的 think-queue 默认不强制绑定 amqp，它只认 amqp 驱动配置项，但底层实现仍依赖扩展是否存在。一旦扩展存在，TP 就会尝试调用 AMQPConnection 类——此时若 php-amqplib 也注册了同名类（旧版有此问题），就会触发 Fatal error: Cannot declare class AMQPConnection。

彻底规避方法：卸载 php-amqplib，所有 RabbitMQ 操作统一走 amqp 扩展原生 API（如 new AMQPConnection()、new AMQPExchange()）
若必须保留 php-amqplib（例如对接遗留 SDK），则确保其 autoloader 不提前加载任何 AMQP 相关类，且在 TP 队列启动前不 require 相关文件
amqp 扩展的连接对象默认不支持 Laravel/TP 常用的「连接复用 + 心跳保活」语义，需手动在消费者循环里调用 $connection->isConnected() + $connection->reconnect()

ThinkPHP 队列配置里 connection 参数怎么填才不连不上

TP 的 config/queue.php 中 amqp 驱动的 connections 配置，看着简单，填错一个字段就卡在 AMQPConnectionException: Connection refused 或静默失败。

关键不是 URL 格式（amqp://user:pass@host:5672/vhost），而是扩展对字段的实际解析逻辑：它**不识别 URL 中的 vhost 路径部分**，vhost 必须单独配在 vhost 键下；同时 port 若为字符串（如 '5672'）会被当成字符串处理，导致连接超时。

正确写法示例：

'amqp' => [
    'host'       => '127.0.0.1',
    'port'       => 5672,
    'login'      => 'guest',
    'password'   => 'guest',
    'vhost'      => '/',
    'exchange'   => 'tp_exchange',
    'queue'      => 'tp_queue',
]