README

云 Pub/Sub 的 PHP 风格客户端。

• API 文档

注意： 此存储库是 Google Cloud PHP 的一个部分。[https://github.com/googleapis/google-cloud-php](https://github.com/googleapis/google-cloud-php)。任何支持请求、错误报告或开发贡献都应指向该项目。

一个完全托管的实时消息服务，允许您在独立应用程序之间发送和接收消息。

安装

首先，安装 PHP 偏好的依赖项管理器 [Composer](https://getcomposer.org.cn/)。

现在安装此组件

$ composer require google/cloud-pubsub

此组件支持通过 HTTP/1.1 的 REST 和 gRPC。为了利用 gRPC 提供的好处（如流式方法），请参阅我们的 [gRPC 安装指南](https://cloud.google.com/php/grpc)。

身份验证

有关客户端身份验证的更多信息，请参阅我们的 [身份验证指南](https://github.com/googleapis/google-cloud-php/blob/main/AUTHENTICATION.md)。一旦身份验证，您就可以开始进行请求。

示例

require 'vendor/autoload.php';

use Google\Cloud\PubSub\PubSubClient;

$pubSub = new PubSubClient();

// Get an instance of a previously created topic.
$topic = $pubSub->topic('my_topic');

// Publish a message to the topic.
$topic->publish([
    'data' => 'My new message.',
    'attributes' => [
        'location' => 'Detroit'
    ]
]);

// Get an instance of a previously created subscription.
$subscription = $pubSub->subscription('my_subscription');

// Pull all available messages.
$messages = $subscription->pull();

foreach ($messages as $message) {
    echo $message->data() . "\n";
    echo $message->attribute('location');
}

版本

此组件被认为是 GA（通用可用）。因此，它不会在任何次要或补丁版本中引入不兼容的更改。我们将以最高优先级解决问题和请求。

请参阅 [迁移指南](https://github.com/googleapis/google-cloud-php-pubsub/blob/HEAD/./MIGRATING.md)，了解如何从库的 V1 迁移到 V2。

下一步

1. 了解 [官方文档](https://cloud.google.com/pubsub/docs/)。
2. 查看 [深入使用示例](https://github.com/GoogleCloudPlatform/php-docs-samples/tree/master/pubsub/)。