结论：PHP的amqp扩展无法通过Composer安装，必须编译安装；而php-amqplib/php-amqplib是Packagist上可直接composer require的纯PHP客户端，为主流选择。
直接说结论：PHP-Amqp 本身不支持 Composer 原生安装，php-amqplib/php-amqplib 才是当前主流、可直接用 Composer 引入的 RabbitMQ 客户端库；而 php-amqp（即 amqp 扩展）是 PHP 的 C 扩展，必须编译安装，不能通过 composer require 装。
为什么 composer require php-amqp 会失败
因为 php-amqp 是一个 PECL 扩展，源码托管在 GitHub 的 php-amqp/amqp 仓库，但没有发布到 Packagist。Composer 只能安装 Packagist 上注册的包，所以执行 composer require php-amqp 会报错：Package php-amqp not found 或 Could not find package php-amqp。
- 它依赖系统级 AMQP 协议库（如 librabbitmq），需先
pecl install amqp或从源码编译 - 启用扩展需在
php.ini中添加extension=amqp - 扩展安装后，类名是
AMQPConnection、AMQPChannel等，和纯 PHP 库完全不兼容
应该用哪个库：php-amqplib/php-amqplib
这是目前最稳定、文档完善、社区活跃的纯 PHP RabbitMQ 客户端，支持 AMQP 0.9.1 协议，兼容 Laravel、Symfony 等框架，也适合高并发场景（配合连接池或长连接管理）。
- 安装命令：
composer require php-amqplib/php-amqplib - 基础连接示例：
use PhpAmqpLib\Connection\AMQPStreamConnection; use PhpAmqpLib\Message\AMQPMessage; $connection = new AMQPStreamConnection('localhost', 5672, 'guest', 'guest'); $channel = $connection->channel(); $channel->queue_declare('task_queue', false, true, false, false); $msg = new AMQPMessage('Hello World!', ['delivery_mode' => 2]); $channel->basic_publish($msg, '', 'task_queue'); $channel->close(); $connection->close(); - 注意：
AMQPStreamConnection是阻塞式连接，高并发下建议复用连接/通道，不要每次请求都新建
高并发下的关键配置与避坑点
纯 PHP 实现的客户端在高并发下容易成为瓶颈，不是库不行，而是用法不对。
立即学习“PHP免费学习笔记（深入）”；
- 避免每条消息都新建
AMQPStreamConnection—— 连接建立开销大，应复用连接对象（例如在 CLI 进程中保持长连接） - 生产环境务必开启
heartbeat参数（如new AMQPStreamConnection(..., ..., ..., 30)），否则 TCP 连接可能被中间设备（如负载均衡器）静默断开 - 投递大量消息时，不要频繁调用
basic_publish()，可启用 confirm 模式（$channel->confirm_select()）并批量发送 - 消费端要用
basic_qos控制预取数量（如$channel->basic_qos(null, 10, null)），防止某消费者堆积过多未确认消息导致其他消费者饿死
amqp 扩展 vs php-amqplib：怎么选
除非你有明确性能压测数据证明纯 PHP 库扛不住，否则优先选 php-amqplib/php-amqplib。它的调试、部署、CI/CD 兼容性远优于 C 扩展。
-
amqp扩展性能略高（约 10–20%），但要求运维介入编译、版本对齐（PHP 版本、RabbitMQ 版本、librabbitmq 版本），上线风险高 -
php-amqplib支持异步 I/O（配合amphp/amp或reactphp），也能达到接近扩展的吞吐量 - Laravel Horizon、Symfony Messenger 默认集成的是
php-amqplib，生态更友好
真正难的不是连上 RabbitMQ，而是连接生命周期管理、异常重试策略、消息幂等性和死信队列设计——这些跟用哪个库关系不大，但容易被跳过。
