Idiomatic PHP client forCloud Datastore.

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

A NoSQL document database built for automatic scaling, high performance, andease of application development. While the Cloud Datastore interface has many ofthe same features as traditional databases, as a NoSQL database it differs fromthem in the way it describes relationships between data objects.

Installation

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

Now install this component:

$ composer require google/cloud-datastore

Authentication

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

Sample

require 'vendor/autoload.php';use Google\Cloud\Datastore\DatastoreClient;$datastore = new DatastoreClient();// Create an entity$bob = $datastore->entity('Person');$bob['firstName'] = 'Bob';$bob['email'] = 'bob@example.com';$datastore->insert($bob);// Update the entity$bob['email'] = 'bobV2@example.com';$datastore->update($bob);// If you know the ID of the entity, you can look it up$key = $datastore->key('Person', '12345328897844');$entity = $datastore->lookup($key);

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.

Compatibility with Google App Engine

This component is compatible with PHP projects on Google App Engine in the Standard or Flexible environments. To maximize the performance of datastore operations in your app, we recommend the following configuration:

1. PHP 7 runtime
2. Enable grpc.so and protobuf.so in your php.ini file
3. Set your DatastoreClient object's 'transport' option to 'grpc'

You are likely to experience less optimal datastore performance using the PHP 5 runtime on App Engine standard due to the lack of the protobuf extension.

Next Steps

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