Google Cloud PHP Client

Idiomatic PHP client for Google Cloud Platform services.

CI Status

PHP Version	Status
PHP 7.2

• Homepage
• API Documentation

This client supports the following Google Cloud Platform services at a General Availability quality level:

• Cloud AutoML
• Cloud Firestore
• Cloud Spanner
• Google BigQuery
• Google Bigtable
• Google Cloud Asset
• Google Cloud BigQuery Data Transfer
• Google Cloud BigQuery Storage
• Google Cloud Billing
• Google Cloud Container
• Google Cloud Dataproc
• Google Cloud Datastore
• Google Cloud Data Catalog
• Google Cloud IoT
• Google Cloud KMS
• Google Cloud OsLogin
• Google Cloud Pub/Sub
• Google Cloud Recaptcha Enterprise
• Google Cloud Redis
• Google Cloud Scheduler
• Google Cloud Security Command Center
• Google Cloud Speech
• Google Cloud Storage
• Google Cloud Tasks
• Google Cloud Text-to-Speech
• Google Cloud Translation
• Google Cloud Video Intelligence
• Google Cloud Vision
• Google Cloud Web Risk
• Google DLP
• Google Stackdriver Debugger
• Google Stackdriver Logging
• Google Stackdriver Monitoring
• Google Stackdriver Trace
• Recommender
• Secret Manager

This client supports the following Google Cloud Platform services at a Beta quality level:

• Dialogflow API
• Google Analytics Admin
• Google Analytics Data
• Google Certificate Authority Service
• Google Cloud Assured Workloads
• Google Cloud BigQuery Connection
• Google Cloud BigQuery Reservation
• Google Cloud Channel
• Google Cloud Datastore Admin
• Google Cloud Natural Language
• Google Cloud Retail
• Google Cloud Talent Solution
• Google Cloud Web Security Scanner
• Google Cloud Workflows
• Google Service Directory
• Google Stackdriver Error Reporting
• Memorystore for Memcached
• Recommendations AI

This client supports the following Google Cloud Platform services in development:

• Compute API

If you need support for other Google APIs, please check out the Google APIs Client Library for PHP.

Quick Start

We recommend installing individual component packages when possible. A list of available packages can be found on Packagist.

For example:

$ composer require google/cloud-bigquery
$ composer require google/cloud-datastore

We also provide the google/cloud package, which includes all Google Cloud clients.

$ composer require google/cloud

Authentication

Authentication is handled by the client library automatically. You just need to provide the authentication details when creating a client. Generally, authentication is accomplished using a Service Account. For more information on obtaining Service Account credentials, see our Authentication Guide.

Once you've obtained your credentials file, it may be used to create an authenticated client.

require 'vendor/autoload.php';

use Google\Cloud\Core\ServiceBuilder;

// Authenticate using a keyfile path
$cloud = new ServiceBuilder([
    'keyFilePath' => 'path/to/keyfile.json'
]);

// Authenticate using keyfile data
$cloud = new ServiceBuilder([
    'keyFile' => json_decode(file_get_contents('/path/to/keyfile.json'), true)
]);

If you do not wish to embed your authentication information in your application code, you may also make use of Application Default Credentials.

require 'vendor/autoload.php';

use Google\Cloud\Core\ServiceBuilder;

putenv('GOOGLE_APPLICATION_CREDENTIALS=/path/to/keyfile.json');

$cloud = new ServiceBuilder();

The GOOGLE_APPLICATION_CREDENTIALS environment variable may be set in your server configuration.

gRPC and Protobuf

Many clients in Google Cloud PHP offer support for gRPC, either as an option or a requirement. gRPC is a high-performance RPC framework created by Google. To use gRPC in PHP, you must install the gRPC PHP extension on your server. While not required, it is also recommended that you install the protobuf extension whenever using gRPC in production.

$ pecl install grpc
$ pecl install protobuf

• gRPC Installation Instructions
• Protobuf Installation Instructions

Caching Access Tokens

By default the library will use a simple in-memory caching implementation, however it is possible to override this behavior by passing a PSR-6 caching implementation in to the desired client.

The following example takes advantage of Symfony's Cache Component.

require 'vendor/autoload.php';

use Google\Cloud\Storage\StorageClient;
use Symfony\Component\Cache\Adapter\ArrayAdapter;

// Please take the proper precautions when storing your access tokens in a cache no matter the implementation.
$cache = new ArrayAdapter();

$storage = new StorageClient([
    'authCache' => $cache
]);

This library provides a PSR-6 implementation with the SystemV shared memory at Google\Auth\Cache\SysVCacheItemPool. This implementation is only available on *nix machines, but it's the one of the fastest implementations and you can share the cache among multiple processes. The following example shows how to use it.

require __DIR__ . '/vendor/autoload.php';

use Google\Cloud\Spanner\SpannerClient;
use Google\Auth\Cache\SysVCacheItemPool;

$cache = new SysVCacheItemPool();

$spanner = new SpannerClient([
    'authCache' => $cache
]);

Versioning

This library follows Semantic Versioning.

Please note it is currently under active development. Any release versioned 0.x.y is subject to backwards incompatible changes at any time.

GA: Libraries defined at a GA quality level are stable, and will not introduce backwards-incompatible changes in any minor or patch releases. We will address issues and requests with the highest priority. Please note, for any components which include generated clients the GA guarantee will only apply to clients which interact with stable services. For example, in a component which hosts V1 and V1beta1 generated clients, the GA guarantee will only apply to the V1 client as the service it interacts with is considered stable.

Beta: Libraries defined at a Beta quality level are expected to be mostly stable and we're working towards their release candidate. We will address issues and requests with a higher priority.

Contributing

Contributions to this library are always welcome and highly encouraged.

See CONTRIBUTING for more information on how to get started.

License

Apache 2.0 - See LICENSE for more information.