前提條件

您已完成以下操作：

• 安裝PHP SDK。更多信息，請參見準備環境。

• 創建資源。代碼中涉及的資源信息，例如實例、Topic和Group ID等，需要在控制臺上提前創建。更多信息，請參見創建資源。

• 獲取阿里云訪問密鑰AccessKey ID和AccessKey Secret。更多信息，請參見創建AccessKey。

發送普通消息

發送普通消息的示例代碼如下。

<?php

require "vendor/autoload.php";

use MQ\Model\TopicMessage;
use MQ\MQClient;

class ProducerTest
{
    private $client;
    private $producer;

    public function __construct()
    {
        $this->client = new MQClient(
            // 設置HTTP協議客戶端接入點，進入消息隊列RocketMQ版控制臺實例詳情頁面的接入點區域查看。
            "${HTTP_ENDPOINT}",
            // 請確保環境變量ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET已設置。
	          // AccessKey ID，阿里云身份驗證標識。
	          getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
	          // AccessKey Secret，阿里云身份驗證密鑰。
	          getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET')
        );

        // 消息所屬的Topic，在消息隊列RocketMQ版控制臺創建。
        $topic = "${TOPIC}";
        // Topic所屬的實例ID，在消息隊列RocketMQ版控制臺創建。
        // 若實例有命名空間，則實例ID必須傳入；若實例無命名空間，則實例ID傳入null空值或字符串空值。實例的命名空間可以在消息隊列RocketMQ版控制臺的實例詳情頁面查看。
        $instanceId = "${INSTANCE_ID}";

        $this->producer = $this->client->getProducer($instanceId, $topic);
    }

    public function run()
    {
        try
        {
            for ($i=1; $i<=4; $i++)
            {
                $publishMessage = new TopicMessage(
                // 消息內容。
                "hello mq!"
                );
                // 設置消息的自定義屬性。
                $publishMessage->putProperty("a", $i);
                // 設置消息的Key。
                $publishMessage->setMessageKey("MessageKey");

                $result = $this->producer->publishMessage($publishMessage);

                print "Send mq message success. msgId is:" . $result->getMessageId() . ", bodyMD5 is:" . $result->getMessageBodyMD5() . "\n";
            }
        } catch (\Exception $e) {
            print_r($e->getMessage() . "\n");
        }
    }
}


$instance = new ProducerTest();
$instance->run();

?>

            

訂閱普通消息

訂閱普通消息的示例代碼如下。

<?php

use MQ\MQClient;

require "vendor/autoload.php";

class ConsumerTest
{
    private $client;
    private $consumer;

    public function __construct()
    {
        $this->client = new MQClient(
            // 設置HTTP協議客戶端接入點，進入消息隊列RocketMQ版控制臺實例詳情頁面的接入點區域查看。
            "${HTTP_ENDPOINT}",
            // 請確保環境變量ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET已設置。
	          // AccessKey ID，阿里云身份驗證標識。
	          getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
	          // AccessKey Secret，阿里云身份驗證密鑰。
	          getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET')
        );

        // 消息所屬的Topic，在消息隊列RocketMQ版控制臺創建。
        $topic = "${TOPIC}";
        // 您在消息隊列RocketMQ版控制臺創建的Group ID。
        $groupId = "${GROUP_ID}";
        // Topic所屬的實例ID，在消息隊列RocketMQ版控制臺創建。
        // 若實例有命名空間，則實例ID必須傳入；若實例無命名空間，則實例ID傳入null空值或字符串空值。實例的命名空間可以在消息隊列RocketMQ版控制臺的實例詳情頁面查看。
        $instanceId = "${INSTANCE_ID}";

        $this->consumer = $this->client->getConsumer($instanceId, $topic, $groupId);
    }

    public function ackMessages($receiptHandles)
    {
        try {
            $this->consumer->ackMessage($receiptHandles);
        } catch (\Exception $e) {
            if ($e instanceof MQ\Exception\AckMessageException) {
                // 某些消息的句柄可能超時，會導致消費確認失敗。
                printf("Ack Error, RequestId:%s\n", $e->getRequestId());
                foreach ($e->getAckMessageErrorItems() as $errorItem) {
                    printf("\tReceiptHandle:%s, ErrorCode:%s, ErrorMsg:%s\n", $errorItem->getReceiptHandle(), $errorItem->getErrorCode(), $errorItem->getErrorCode());
                }
            }
        }
    }

    public function run()
    {
        // 在當前線程循環消費消息，建議多開個幾個線程并發消費消息。
        while (True) {
            try {
                // 長輪詢消費消息。
                // 若Topic內沒有消息，請求會在服務端掛起一段時間（長輪詢時間），期間如果有消息可以消費則立即返回客戶端。
                $messages = $this->consumer->consumeMessage(
                    3, // 一次最多消費3條（最多可設置為16條）。
                    3 // 長輪詢時間3秒（最多可設置為30秒）。
                );
            } catch (\MQ\Exception\MessageResolveException $e) {
                // 當出現消息Body存在不合法字符，無法解析的時候，會拋出此異常。
                // 可以正常解析的消息列表。
                $messages = $e->getPartialResult()->getMessages();
                // 無法正常解析的消息列表。
                $failMessages = $e->getPartialResult()->getFailResolveMessages();

                $receiptHandles = array();
                foreach ($messages as $message) {
                    // 處理業務邏輯。
                    $receiptHandles[] = $message->getReceiptHandle();
                    printf("MsgID %s\n", $message->getMessageId());
                }
                foreach ($failMessages as $failMessage) {
                    // 處理存在不合法字符，無法解析的消息。
                    $receiptHandles[] = $failMessage->getReceiptHandle();
                    printf("Fail To Resolve Message. MsgID %s\n", $failMessage->getMessageId());
                }
                $this->ackMessages($receiptHandles);
                continue;
            } catch (\Exception $e) {
                if ($e instanceof MQ\Exception\MessageNotExistException) {
                    // 沒有消息可以消費，繼續輪詢。
                    printf("No message, contine long polling!RequestId:%s\n", $e->getRequestId());
                    continue;
                }

                print_r($e->getMessage() . "\n");

                sleep(3);
                continue;
            }

            print "consume finish, messages:\n";

            // 處理業務邏輯。
            $receiptHandles = array();
            foreach ($messages as $message) {
                $receiptHandles[] = $message->getReceiptHandle();
              
                printf("MessageID:%s TAG:%s BODY:%s \nPublishTime:%d, FirstConsumeTime:%d, \nConsumedTimes:%d, NextConsumeTime:%d,MessageKey:%s\n",
                    $message->getMessageId(), $message->getMessageTag(), $message->getMessageBody(),
                    $message->getPublishTime(), $message->getFirstConsumeTime(), $message->getConsumedTimes(), $message->getNextConsumeTime(),
                    $message->getMessageKey());
                print_r($message->getProperties());
            }

            // $message->getNextConsumeTime()前若不確認消息消費成功，則消息會被重復消費。
            // 消息句柄有時間戳，同一條消息每次消費拿到的都不一樣。
            print_r($receiptHandles);
            $this->ackMessages($receiptHandles);
            print "ack finish\n";
        }

    }
}

$instance = new ConsumerTest();
$instance->run();


?>