php 8.6接入rabbitmq工作队列时,生产者使用publisher confirms确认消息被代理接收,消费者则在工作成功后发送手动ack。这是两个不同环节;二者结合仍可能重复投递,因此实际任务还需要稳定任务id和幂等处理。下面以php-amqplib和持久化quorum队列演示。

官方文档:RabbitMQ tutorial - Work Queues
准备连接和持久队列
安装php-amqplib 3.7系列,确认sockets和mbstring可用,并准备已部署的RabbitMQ与专用账号。将连接参数放入环境变量;下面common.php由生产者和消费者共用,不使用默认guest账号跨主机连接。
composer require php-amqplib/php-amqplib:"^3.7"
<?php require __DIR__.'/vendor/autoload.php';
use PhpAmqpLib\Connection\AMQPStreamConnection;
use PhpAmqpLib\Wire\AMQPTable;
$connection = new AMQPStreamConnection(
getenv('AMQP_HOST'), (int)(getenv('AMQP_PORT') ?: 5672),
getenv('AMQP_USER'), getenv('AMQP_PASSWORD'), getenv('AMQP_VHOST') ?: '/'
);
$channel = $connection->channel();
$queue = 'demo.php86.work';
$channel->queue_declare($queue, false, true, false, false, false,
new AMQPTable(['x-queue-type'=>'quorum']));

官方文档:RabbitMQ tutorial - Reliable Publishing with Publisher Confirms
生产者等待发布确认
保存producer.php。队列名和声明参数必须与消费者一致;已有同名但类型不同的队列会被服务器拒绝,应另建测试队列,而不是删除线上队列。
<?php require __DIR__.'/common.php';
use PhpAmqpLib\Message\AMQPMessage;
try {
$channel->confirm_select();
$channel->set_nack_handler(static function (AMQPMessage $message): void {
throw new RuntimeException('Broker rejected publication');
});
$body = json_encode(['job_id'=>'demo-001','action'=>'prepare-report'], JSON_THROW_ON_ERROR);
$channel->basic_publish(new AMQPMessage($body, [
'content_type'=>'application/json',
'delivery_mode'=>AMQPMessage::DELIVERY_MODE_PERSISTENT,
'message_id'=>'demo-001'
]), '', $queue);
$channel->wait_for_pending_acks(5.0);
echo "Publication confirmed\n";
} finally {
$channel->close(); $connection->close();
}
消费者成功处理后才ACK
保存consumer.php,先启动消费者,再运行生产者。这个演示只把任务写到标准输出;接入真实业务时,把输出替换成已具备幂等保护的处理逻辑,并在持久化成功后ACK。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
<?php require __DIR__.'/common.php';
use PhpAmqpLib\Message\AMQPMessage;
$channel->basic_qos(null, 1, false);
$channel->basic_consume($queue, '', false, false, false, false,
static function (AMQPMessage $message): void {
try {
$job = json_decode($message->getBody(), true, 32, JSON_THROW_ON_ERROR);
if (!is_array($job) || !is_string($job['job_id'] ?? null)) {
throw new InvalidArgumentException('Invalid job');
}
if (fwrite(STDOUT, $job['job_id'].PHP_EOL) === false) {
throw new RuntimeException('Work failed');
}
$message->ack();
} catch (Throwable $e) {
error_log($e::class);
$message->nack(false, false);
}
});
try { $channel->consume(); }
finally { $channel->close(); $connection->close(); }
给失败任务配置明确去向
示例nack不重新入队;没有死信交换机时,这类消息会被丢弃,生产使用前必须先配置并验证死信队列及人工重放路径。确认超时也不证明消息未保存,不能不加判断地换ID重发。消费者处理成功但ACK前断线时可能再次收到同一任务,业务应以job_id防止重复扣减或重复执行。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










