Composer不能直接集成RabbitMQ，需安装AMQP客户端如php-amqplib/php-amqplib；执行composer require rabbitmq会失败，因无此官方包；正确做法是安装php-amqplib并配置连接参数、持久化队列与消息。
Composer 是 PHP 的依赖管理工具，它不支持直接集成 RabbitMQ 客户端——RabbitMQ 本身是用 Erlang 写的，PHP 项目要连它，得靠 AMQP 协议客户端库（比如 php-amqplib/php-amqplib），不是靠 Composer “集成 RabbitMQ”。这个说法容易让人误以为 Composer 能装出一个 RabbitMQ 实例来。
为什么 composer require rabbitmq 失败或没效果
执行 composer require rabbitmq 会报错或安装空包，因为官方没有叫 rabbitmq 的 PHP 包。真正要用 RabbitMQ，必须明确指定 AMQP 协议实现库：
-
php-amqplib/php-amqplib是最主流、维护活跃、兼容 RabbitMQ 3.8+ 的纯 PHP 客户端（无需扩展） -
ext-amqp是 C 扩展，性能更好但需编译安装，且在 PHP 8.0+ 兼容性不稳定，生产环境慎选 - 别信“
rabbitmq/client”“laravel/rabbitmq”这类非官方包，多数已废弃或封装粗糙
正确安装 php-amqplib 并连接 RabbitMQ
确保 RabbitMQ 服务已运行（默认 localhost:5672），再执行：
composer require php-amqplib/php-amqplib
连接和基础收发示例（注意异常捕获和连接复用）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
$connection = new \PhpAmqpLib\Connection\AMQPStreamConnection(
'localhost', 5672, 'guest', 'guest', '/', false, 'AMQPLAIN', null, 'en_US', 30, 30
);
$channel = $connection->channel();
<p>// 声明队列（durable=true 确保重启后还在）
$channel->queue_declare('task_queue', false, true, false, false);</p><p>// 发送消息（delivery_mode=2 表示持久化）
$msg = new \PhpAmqpLib\Message\AMQPMessage('Hello World!', ['delivery_mode' => 2]);
$channel->basic_publish($msg, '', 'task_queue');关键点：
- 连接参数里
'/'是 virtual host，别漏掉；false, 'AMQPLAIN'是认证机制，新版 RabbitMQ 默认支持 - 队列声明必须设
$durable = true，否则服务重启后队列消失 - 消息要持久化，仅设
delivery_mode => 2不够，交换机和队列也必须是 durable 的
常见报错及对应修复动作
看到这些错误，别急着换库，先检查底层配置：
-
Connection refused (111)：RabbitMQ 没启动，或防火墙拦了 5672 端口，用telnet localhost 5672验证连通性 -
Channel connection is closed：通常因未正确关闭 channel 或 connection，或心跳超时（建议在AMQPStreamConnection构造时加$heartbeat = 60参数） -
NOT_FOUND - no queue 'xxx' in vhost '/'：消费者启动早于生产者，且队列未提前声明；应在消费者和生产者两端都做queue_declare -
ACCESS_REFUSED - Login was refused：凭据错误，或用户没被授权访问该 virtual host（用rabbitmqctl list_permissions查）
消息堆积时别只改 PHP 代码
队列积压不是靠换客户端能解决的。当 php-amqplib 消费变慢，优先排查：
- PHP 进程是否被
max_execution_time中断？应设为0或足够大 - 消费逻辑里是否有同步调用第三方 API 或数据库慢查询？考虑异步解耦或加缓存
- 队列本身是否启用了惰性模式（
x-queue-mode=lazy）？百万级消息必须开，否则内存爆掉 - 确认 RabbitMQ 磁盘/内存告警是否触发了 flow control（看
rabbitmqctl status输出里的disk_free_limit和mem_limit）
AMQP 客户端只是通道，消息可靠性、顺序性、堆积应对，全依赖 RabbitMQ 服务端配置 + 业务层设计。把 php-amqplib 当成“网线”，别指望它自动修路由器。
