tencent cloud

消息队列 RabbitMQ 版

动态与公告
新功能发布记录
公告
产品简介
TDMQ 产品系列介绍与选型
什么是消息队列 RabbitMQ 版
产品优势
应用场景
开源托管版与 Serverless 版差异说明
开源版本支持说明
与开源 RabbitMQ 对比
高可用
使用限制
RabbitMQ 相关概念
开区地域
相关云服务
产品计费
计费概述
价格说明
计费示例
按小时付费转包年包月
续费说明
查看消费明细
欠费说明
退费说明
快速入门
入门流程指引
步骤1:准备工作
步骤2:创建 RabbitMQ 集群
步骤3:配置 Vhost
步骤4:使用 SDK 收发消息
步骤5:查询消息
步骤6:销毁资源
用户指南
使用流程指引
配置账号权限
创建集群
配置 Vhost
连接集群
管理消息
配置高级特性
管理集群
查看监控和配置告警
实践教程
实践教程使用说明
RabbitMQ 客户端实践教程
RabbitMQ 消息可靠性实践教程
RabbitMQ 支持 MQTT 协议说明
迁移集群
迁移方案概述
步骤1:购买云上实例
步骤2:迁移元数据上云
步骤3:开启双读写
API 参考(开源托管版)
API 概览
API 参考(Serverless 版)
History
Introduction
API Category
Making API Requests
Relevant APIs for RabbitMQ Serverless PAAS Capacity
RabbitMQ Serverless Instance Management APIs
Data Types
Error Codes
SDK 文档
SDK 概述
Spring Boot Starter 接入
Spring Cloud Stream 接入
Java SDK
Go SDK
Python SDK
PHP SDK
安全与合规
权限管理
网络安全
删除保护
变更记录
云 API 审计
常见问题
服务等级协议
联系我们

PHP SDK

PDF
聚焦模式
字号
最后更新时间: 2026-01-04 15:32:35

操作场景

本文以调用 PHP SDK 为例介绍通过开源 SDK 实现消息收发的操作过程,帮助您更好地理解消息收发的完整过程。

前提条件

已参考 SDK 概述,获取相关的客户端连接参数

操作步骤

步骤1:安装 php-amqplib 库

根据 RabbitMQ 官网推荐使用 php-amqplib Client,首先需要在项目中引入 php-amqplib 库。
1. 在项目中添加 composer.json 文件。
{
"require": {
"php-amqplib/php-amqplib": ">=3.0"
}
}
2. 使用 Composer 进行安装。
composer.phar install
或者使用下述命令:
composer install
3. 创建客户端需要引入库文件,在客户端文件中引入库文件。
require_once('../vendor/autoload.php');
完成上述步骤即可创建连接与服务端进行交互。

步骤2:发送消息

创建并编译生产消息程序(以 direct 类型交换机为例)。
require_once('../vendor/autoload.php');

use PhpAmqpLib\\Connection\\AMQPStreamConnection;
use PhpAmqpLib\\Message\\AMQPMessage;

$exchange_name = 'exchange_name';
$exchange_type = 'direct';

// 创建连接
$connection = new AMQPStreamConnection(
$host,
$port,
$username,
$password,
$vhost,
false,
'PLAIN');
// 建立通道
$channel = $connection->channel();
// 声明交换机
$channel->exchange_declare($exchange_name, $exchange_type, false, true, false);

// 设定消息路由key
$routing_keys = array('info', 'waring', 'error');

for ($x = 0; $x < count($routing_keys); $x++) {
// 消息内容
$msg = new AMQPMessage('This is a direct[' . $routing_keys[$x] . '] message!');
// 发送消息到指定的交换机并设置routing key
$channel->basic_publish($msg, $exchange_name, $routing_keys[$x]);

echo " [Producer(Routing)] Sent '" . $msg->body . "'\\n";
}
// 资源释放
$channel->close();
$connection->close();
参数
说明
$exchange_name
Exchange 名称,在控制台 Exchange 列表获取。
$exchange_type
类型需与上述 Exchange 的类型保持一致。
$host
集群接入地址,在集群基本信息页面的客户端接入模块获取。

$port
集群接入地址中的端口号。
$username
用户名称,填写在控制台创建的用户名称。
$password
用户密码,填写在控制台创建用户时填写的密码。
$vhost
Vhost 名称,在控制台 Vhost 列表获取。
$routing_keys[$x]
消费者消息队列绑定的 routing key,消息的路由规则,在控制台绑定关系列表的绑定 Key列获取。
img



步骤3:消费消息

创建并编译消费消息程序。
<?php

require_once('../vendor/autoload.php');
require_once('../Constant.php');

use PhpAmqpLib\\Connection\\AMQPStreamConnection;

$exchange_name = 'exchange_name';
$exchange_type = 'direct';
$queue_name = 'route_queue1';

// 创建链接
$connection = new AMQPStreamConnection(
$host,
$port,
$username,
$password,
$vhost,
false,
'PLAIN');
// 建立通道
$channel = $connection->channel();
// 声明交换机
$channel->exchange_declare($exchange_name, $exchange_type, false, true, false);
// 声明消息队列
$channel->queue_declare($queue_name, false, true, false, false);

// 设定队列路由key
$routing_keys = array('info', 'waring', 'error');
for ($x = 0; $x < count($routing_keys); $x++) {
// 绑定消息队列到指定交换机并设置routingKey
$channel->queue_bind($queue_name, $exchange_name, $routing_keys[$x]);
}

echo " [Consumer1(Routing: info/waring/error)] Waiting for messages. To exit press CTRL+C\\n";

// 消息回调(消息消费逻辑)
$callback = function ($msg) {
echo ' [Consumer1(Routing: info/waring/error)] Received ', $msg->body, "\\n";
};
// 创建消费者监听指定消息队列
$channel->basic_consume($queue_name, '', false, true, false, false, $callback);

while ($channel->is_open()) {
$channel->wait();
}
// 关闭资源
$channel->close();
$connection->close();
参数
说明
$exchange_name
Exchange 名称,可在控制台 Exchange 列表获取。
$exchange_type
类型需与上述 Exchange 的类型保持一致。
$queue_name
Queue名称,可在控制台 Queue 列表获取。
$host
集群接入地址,在集群基本信息页面的客户端接入模块获取。

$port
集群接入地址中的端口号。
$username
用户名称,填写在控制台创建的用户名称。
$password
用户密码,填写在控制台创建用户时填写的密码。
$vhost
Vhost 名称,在控制台 Vhost 列表获取。
$routing_keys[$x]
消息队列支持的routing key。消费者消息队列绑定的 routing key,消息的路由规则,在控制台绑定关系列表的绑定 Key列获取。
img



步骤4:查看消息

如果您想确认消息是否成功发送至 TDMQ RabbitMQ 版,可以在控制台 集群管理 > Queue 基本信息页面查看接入的消费者情况。

说明:
完整示例或其他使用可参见 Demo 或者 RabbitMQ 官方使用文档

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈