Google Cloud PHP Datastore
Idiomatic PHP client for Cloud Datastore.
NOTE: This repository is part of Google Cloud PHP. Any support requests, bug reports, or development contributions should be directed to that project.
A NoSQL document database built for automatic scaling, high performance, and ease of application development. While the Cloud Datastore interface has many of the same features as traditional databases, as a NoSQL database it differs from them in the way it describes relationships between data objects.
Installation
To begin, install the preferred dependency manager for PHP, Composer.
Now to install just this component:
$ composer require google/cloud-datastore
Or to install the entire suite of components at once:
$ composer require google/cloud
Authentication
Please see our Authentication guide for more information on 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'] = '[email protected]';
$datastore->insert($bob);
// Update the entity
$bob['email'] = '[email protected]';
$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 in any 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:
- PHP 7 runtime
- Enable grpc.so and protobuf.so in your php.ini file
- 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
- Understand the official documentation.
- Take a look at in-depth usage samples.
4 Nov 17, 2022
6 Sep 14, 2022
1.1k Dec 22, 2022
3 Dec 22, 2022
4 Oct 3, 2022
1 Oct 26, 2021
1 Nov 19, 2021
17 Dec 27, 2022
6 Jan 19, 2022
8.4k Dec 30, 2022
63 Feb 14, 2022
6 Jun 14, 2023
25 Dec 5, 2022
665 Dec 23, 2022
2k Jan 7, 2023
5 Feb 24, 2022
96 Jan 6, 2023
52 Dec 23, 2022