告别内容孤岛：如何使用Composer和AcquiaContentHubPHP客户端实现多站点内容同步

<code class="bash">composer require acquia/content-hub-php</code>

<pre class="brush:php;toolbar:false;"><?php

use Acquia\ContentHubClient\ContentHub;
use Acquia\ContentHubClient\Middleware\MiddlewareHmacV1;

// Content Hub 实例的 URL，由 Acquia 提供
$url = 'https://us-east-1.content-hub.acquia.com';

// Acquia 提供的 API Key 和 Secret Key 用于认证
$apiKey    = 'YOUR_API_KEY';
$secretKey = 'YOUR_SECRET_KEY';

// 使用 HMAC 中间件进行认证
$middleware = new MiddlewareHmacV1($apiKey, $secretKey, 'V1');
$client = new ContentHub('', $middleware, ['base_url' => $url]);

// 注册应用程序，参数是可读的应用名称
$clientSite = $client->register('MyAwesomePHPApp');

// 存储 Content Hub 分配的客户端 UUID
$clientId = $clientSite['uuid'];

echo "应用已注册，客户端 UUID: " . $clientId . "\n";

<pre class="brush:php;toolbar:false;"><?php
// ... (之前的 $client 和 $clientId 定义)

// 添加一个 Webhook 接收端点
$webhook = $client->addWebhook('http://your-app.com/content-hub/webhooks');

echo "Webhook 已添加，UUID: " . $webhook['uuid'] . "\n";

// 如果需要，可以删除 Webhook
// $client->deleteWebhook($webhook['uuid']);

<pre class="brush:php;toolbar:false;"><?php

use Acquia\ContentHubClient\ContentHub;
use Acquia\ContentHubClient\Middleware\MiddlewareHmacV1;
use Acquia\ContentHubClient\Entities;
use Acquia\ContentHubClient\Entity;
use Acquia\ContentHubClient\Attribute;
use Acquia\ContentHubClient\Asset;
use Ramsey\Uuid\Uuid; // 推荐使用 ramsey/uuid 库生成 UUID

// ... (之前的 $client 和 $clientId 定义)

// 生成一个唯一的实体 UUID
$uuid = Uuid::uuid4()->toString();

// 构建实体
$entity = new Entity();
$entity->setUuid($uuid);
$entity->setType('product'); // 实体类型，例如 'product', 'article'
$entity->setOrigin($clientId); // 实体来源，即您的应用 UUID
$entity->setCreated(gmdate('Y-m-d\TH:i:s\Z'));
$entity->setModified(gmdate('Y-m-d\TH:i:s\Z'));

// 添加属性：例如产品名称，支持多语言
$nameAttribute = new Attribute(Attribute::TYPE_STRING);
$nameAttribute->setValue('Awesome Product', 'en'); // 英文名称
$nameAttribute->setValue('很棒的产品', 'zh'); // 中文名称
$entity->setAttribute('name', $nameAttribute);

// 添加一个整数属性：例如产品价格
$priceAttribute = new Attribute(Attribute::TYPE_INTEGER);
$priceAttribute->setValue(99);
$entity->setAttribute('price', $priceAttribute);

// 添加资产（Asset）：例如产品图片
$imageAttribute = new Attribute(Attribute::TYPE_STRING);
$imageAttribute->setValue('[product-image-1]'); // 使用 token 引用资产
$entity->setAttribute('image', $imageAttribute);

$asset = new Asset();
$asset->setUrl('http://example.com/images/awesome-product.jpg');
$asset->setReplaceToken('[product-image-1]');
$entity->addAsset($asset);

// 创建一个实体容器，并将实体添加到其中
$entities = new Entities();
$entities->addEntity($entity);

// 将实体数据渲染为 Common Data Format (CDF)
$cdf = $entities->json();

// 异步创建实体：Content Hub 会从提供的 URL 拉取 CDF 数据
$resourceUrl = 'http://your-app.com/path/to/product-cdf/' . $uuid; // 您的应用需要提供这个 URL 来输出 CDF
$client->createEntities($resourceUrl);

echo "实体已提交到 Content Hub，UUID: " . $uuid . "\n";

<pre class="brush:php;toolbar:false;"><?php
// ... (之前的 $client 定义，以及一个已知的 $uuid)

// 从 Content Hub 读取实体
$entity = $client->readEntity($uuid);

// 获取英文名称
$nameEn = $entity->getAttribute('name')->getValue('en');
echo "产品英文名称: " . $nameEn . "\n";

// 获取中文名称
$nameZh = $entity->getAttribute('name')->getValue('zh');
echo "产品中文名称: " . $nameZh . "\n";

// 获取图片 URL
$imageToken = $entity->getAttribute('image')->getValue();
$imageUrl = $entity->getAsset($imageToken)->getUrl();
echo "产品图片 URL: " . $imageUrl . "\n";

<pre class="brush:php;toolbar:false;"><?php
// ... (之前的 $client 定义，以及一个已知的 $uuid)

// 假设我们更新 'price' 属性
$entity = $client->readEntity($uuid); // 先读取现有实体
$priceAttribute = new Attribute(Attribute::TYPE_INTEGER);
$priceAttribute->setValue(109); // 新价格
$entity->setAttribute('price', $priceAttribute);

// 更新实体，同样是异步操作
$resourceUrl = 'http://your-app.com/path/to/product-cdf/' . $uuid; // 您的应用需要提供更新后的 CDF
$client->updateEntity($resourceUrl, $uuid);
echo "实体已提交更新，UUID: " . $uuid . "\n";

// 删除实体
// $client->deleteEntity($uuid);
// echo "实体已提交删除，UUID: " . $uuid . "\n";