PHPackages                             google/cloud-datastore - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database &amp; ORM](/categories/database)
4. /
5. google/cloud-datastore

ActiveLibrary[Database &amp; ORM](/categories/database)

google/cloud-datastore
======================

Cloud Datastore Client for PHP

v2.0.5(2mo ago)241.2M—9.3%1117Apache-2.0PHPPHP ^8.1CI passing

Since Mar 10Pushed 2mo ago51 watchersCompare

[ Source](https://github.com/googleapis/google-cloud-php-datastore)[ Packagist](https://packagist.org/packages/google/cloud-datastore)[ RSS](/packages/google-cloud-datastore/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (18)Versions (109)Used By (17)

Google Cloud PHP Datastore
==========================

[](#google-cloud-php-datastore)

> Idiomatic PHP client for [Cloud Datastore](https://cloud.google.com/datastore/).

[![Latest Stable Version](https://camo.githubusercontent.com/61990ab60fcf73c9ae047557d70ffc9fa027434c3e9700c036c3226816f2171c/68747470733a2f2f706f7365722e707567782e6f72672f676f6f676c652f636c6f75642d6461746173746f72652f762f737461626c65)](https://packagist.org/packages/google/cloud-datastore) [![Packagist](https://camo.githubusercontent.com/7726621376c8fdc9c6201314b697244c1edae0eec60985ea6033fae031f36c58/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f676f6f676c652f636c6f75642d6461746173746f72652e737667)](https://packagist.org/packages/google/cloud-datastore)

- [API documentation](https://cloud.google.com/php/docs/reference/cloud-datastore/latest)

**NOTE:** This repository is part of [Google Cloud PHP](https://github.com/googleapis/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

[](#installation)

To begin, install the preferred dependency manager for PHP, [Composer](https://getcomposer.org/).

Now install this component:

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

### Authentication

[](#authentication)

Please see our [Authentication guide](https://github.com/googleapis/google-cloud-php/blob/main/AUTHENTICATION.md) for more information on authenticating your client. Once authenticated, you'll be ready to start making requests.

### Sample

[](#sample)

```
use Google\ApiCore\ApiException;
use Google\Cloud\Datastore\V1\BeginTransactionRequest;
use Google\Cloud\Datastore\V1\BeginTransactionResponse;
use Google\Cloud\Datastore\V1\Client\DatastoreClient;

// Create a client.
$datastoreClient = new DatastoreClient();

// Prepare the request message.
$request = (new BeginTransactionRequest())
    ->setProjectId($projectId);

// Call the API and handle any network failures.
try {
    /** @var BeginTransactionResponse $response */
    $response = $datastoreClient->beginTransaction($request);
    printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
} catch (ApiException $ex) {
    printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
}
```

### Debugging

[](#debugging)

Please see our [Debugging guide](https://github.com/googleapis/google-cloud-php/blob/main/DEBUG.md)for more information about the debugging tools.

### Version

[](#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

[](#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

[](#next-steps)

1. Understand the [official documentation](https://cloud.google.com/datastore/docs/).
2. Take a look at [in-depth usage samples](https://github.com/GoogleCloudPlatform/php-docs-samples/tree/master/datastore).

###  Health Score

69

—

FairBetter than 100% of packages

Maintenance87

Actively maintained with recent releases

Popularity50

Moderate usage in the ecosystem

Community40

Growing community involvement

Maturity89

Battle-tested with a long release history

 Bus Factor3

3 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~30 days

Recently: every ~25 days

Total

108

Last Release

62d ago

Major Versions

v0.1.0 → v1.0.02017-03-31

v1.34.2 → v2.0.0-RC12025-10-10

PHP version history (3 changes)v1.21.0PHP &gt;=7.4

v1.27.2PHP ^8.0

v1.33.1PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/a8713415b20b4be4cec8f8b22741e3cd05f76eee9e38de1de5bf32727349b7c5?d=identicon)[bshaffer](/maintainers/bshaffer)

![](https://www.gravatar.com/avatar/3901206952845568d7557a60855b097f6d1bafaa7a24020cfcf5bb8de74f9d28?d=identicon)[google-cloud](/maintainers/google-cloud)

---

Top Contributors

[![release-please[bot]](https://avatars.githubusercontent.com/in/40688?v=4)](https://github.com/release-please[bot] "release-please[bot] (63 commits)")[![jdpedrie](https://avatars.githubusercontent.com/u/89034?v=4)](https://github.com/jdpedrie "jdpedrie (49 commits)")[![bshaffer](https://avatars.githubusercontent.com/u/103941?v=4)](https://github.com/bshaffer "bshaffer (43 commits)")[![gcf-owl-bot[bot]](https://avatars.githubusercontent.com/in/99011?v=4)](https://github.com/gcf-owl-bot[bot] "gcf-owl-bot[bot] (38 commits)")[![dwsupplee](https://avatars.githubusercontent.com/u/2079879?v=4)](https://github.com/dwsupplee "dwsupplee (22 commits)")[![yoshi-automation](https://avatars.githubusercontent.com/u/44816363?v=4)](https://github.com/yoshi-automation "yoshi-automation (18 commits)")[![vishwarajanand](https://avatars.githubusercontent.com/u/7369612?v=4)](https://github.com/vishwarajanand "vishwarajanand (17 commits)")[![yash30201](https://avatars.githubusercontent.com/u/54198301?v=4)](https://github.com/yash30201 "yash30201 (5 commits)")[![saranshdhingra](https://avatars.githubusercontent.com/u/1038319?v=4)](https://github.com/saranshdhingra "saranshdhingra (4 commits)")[![Hectorhammett](https://avatars.githubusercontent.com/u/9062626?v=4)](https://github.com/Hectorhammett "Hectorhammett (3 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (2 commits)")[![ajupazhamayil](https://avatars.githubusercontent.com/u/14087896?v=4)](https://github.com/ajupazhamayil "ajupazhamayil (2 commits)")[![daniswrong](https://avatars.githubusercontent.com/u/226809130?v=4)](https://github.com/daniswrong "daniswrong (1 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (1 commits)")[![danielgsims](https://avatars.githubusercontent.com/u/695933?v=4)](https://github.com/danielgsims "danielgsims (1 commits)")[![vam-google](https://avatars.githubusercontent.com/u/25311427?v=4)](https://github.com/vam-google "vam-google (1 commits)")[![chingor13](https://avatars.githubusercontent.com/u/32483?v=4)](https://github.com/chingor13 "chingor13 (1 commits)")[![calsmith](https://avatars.githubusercontent.com/u/8541915?v=4)](https://github.com/calsmith "calsmith (1 commits)")[![jeromegamez](https://avatars.githubusercontent.com/u/67554?v=4)](https://github.com/jeromegamez "jeromegamez (1 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/google-cloud-datastore/health.svg)

```
[![Health](https://phpackages.com/badges/google-cloud-datastore/health.svg)](https://phpackages.com/packages/google-cloud-datastore)
```

###  Alternatives

[google/cloud-bigquery

BigQuery Client for PHP

8917.2M41](/packages/google-cloud-bigquery)[google/cloud-firestore

Cloud Firestore Client for PHP

1804.1M31](/packages/google-cloud-firestore)[google/cloud-translate

Cloud Translation Client for PHP

20215.9M84](/packages/google-cloud-translate)[google/cloud-pubsub

Cloud PubSub Client for PHP

9017.1M63](/packages/google-cloud-pubsub)[google/cloud-spanner

Cloud Spanner Client for PHP

20551.5k5](/packages/google-cloud-spanner)[google/cloud-vision

Cloud Vision Client for PHP

1075.2M24](/packages/google-cloud-vision)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
