Idiomatic PHP client forCloud Pub/Sub.

NOTE: This repository is part ofGoogle Cloud PHP. Anysupport requests, bug reports, or development contributions should be directed tothat project.

A fully-managed real-time messaging service that allows you to send and receive messages between independent applications.

Installation

To begin, install the preferred dependency manager for PHP,Composer.

Now install this component:

$ composer require google/cloud-pubsub

This component supports both REST over HTTP/1.1 and gRPC. In order to take advantage of the benefits offered by gRPC (such as streaming methods)please see ourgRPC installation guide.

Authentication

Please see ourAuthentication guide for more informationon authenticating your client. Once authenticated, you'll be ready to start making requests.

Sample

use Google\ApiCore\ApiException;use Google\Cloud\PubSub\V1\Client\PublisherClient;use Google\Cloud\PubSub\V1\GetTopicRequest;use Google\Cloud\PubSub\V1\Topic;// Create a client.$publisherClient = new PublisherClient();// Prepare the request message.$request = (new GetTopicRequest())    ->setTopic($formattedTopic);// Call the API and handle any network failures.try {    /** @var Topic $response */    $response = $publisherClient->getTopic($request);    printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());} catch (ApiException $ex) {    printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());}

Debugging

Please see ourDebugging guidefor more information about the debugging tools.

Version

This component is considered GA (generally available). As such, it will not introduce backwards-incompatible changes inany minor or patch releases. We will address issues and requests with the highest priority.

Please see themigration guide to upgrade fromV1 of the library toV2.

Next Steps

1. Understand theofficial documentation.
2. Take a look atin-depth usage samples.