README

为 云数据存储 提供的 PHP 习语式客户端。

• API 文档

注意： 此存储库是 Google Cloud PHP 的一部分。有关支持请求、错误报告或开发贡献的任何问题，应直接提交到该项目。

一个为自动扩展、高性能和易于应用程序开发而构建的 NoSQL 文档数据库。虽然云数据存储接口具有许多与传统数据库相同的功能，但作为 NoSQL 数据库，它在描述数据对象之间的关系方面与它们有所不同。

安装

首先，安装 PHP 的首选依赖关系管理器 Composer。

现在安装此组件

$ composer require google/cloud-datastore

身份验证

有关如何对您的客户端进行身份验证的更多信息，请参阅我们的 身份验证指南。一旦认证，您就可以开始进行请求。

示例

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);

版本

此组件被认为是 GA（一般可用）。因此，它不会在任何次要或补丁版本中引入向后不兼容的更改。我们将优先解决问题和请求。

与 Google App Engine 的兼容性

此组件与 Google App Engine 标准或灵活环境中的 PHP 项目兼容。为了最大限度地提高您的应用程序中数据存储操作的性能，我们建议以下配置

1. PHP 7 运行时
2. 在您的 php.ini 文件中启用 grpc.so 和 protobuf.so
3. 将您的 DatastoreClient 对象的 'transport' 选项设置为 'grpc'

由于 App Engine 标准中缺少 protobuf 扩展，您可能会在 App Engine 标准上使用 PHP 5 运行时遇到不太理想的数据存储性能。

下一步

1. 了解 官方文档。
2. 查看 深入使用示例。