如何高效集成SanityCMS内容到PHP应用中，使用Composer简化开发流程

<code class="bash">composer require sanity/sanity-php</code>

<code class="php">require_once 'vendor/autoload.php';</code>

<pre class="brush:php;toolbar:false;">use Sanity\Client as SanityClient;

$client = new SanityClient([
  'projectId' => 'your-project-id',      // 替换为你的 Sanity 项目ID
  'dataset' => 'your-dataset-name',      // 替换为你的 Sanity 数据集名称
  'useCdn' => true,                      // 生产环境建议开启 CDN 加速查询
  'apiVersion' => '2023-11-20',          // 推荐使用当前 UTC 日期，锁定 API 版本
]);

<pre class="brush:php;toolbar:false;">$client = new SanityClient([
  'projectId' => 'your-project-id',
  'dataset' => 'your-dataset-name',
  'useCdn' => false, // 注意：认证请求不能使用 CDN
  'apiVersion' => '2023-11-20',
  'token' => 'your-sanity-auth-token', // 替换为你的认证 Token
]);

<pre class="brush:php;toolbar:false;">$document = $client->getDocument('someDocumentId');
if ($document) {
    echo "文档标题: " . $document['title'] . "\n";
}

<pre class="brush:php;toolbar:false;">$results = $client->fetch(
  '*[_type == $type && publishedAt < now()][0...5]', // 查询最近发布的5篇博客文章
  ['type' => 'blogPost'] // 查询参数
);

foreach ($results as $post) {
  echo "文章标题: " . $post['title'] . "\n";
  // ... 其他内容
}

<pre class="brush:php;toolbar:false;">// 生产环境：只获取已发布内容
$publishedClient = new SanityClient([
  // ...config...
  'useCdn' => true,
  'perspective' => 'published',
]);
$publishedPosts = $publishedClient->fetch('*[_type == "blogPost"]');

// 预览环境：获取草稿和已发布内容，并优先显示草稿
$previewClient = new SanityClient([
  // ...config...
  'useCdn' => false,
  'perspective' => 'previewDrafts',
]);
$previewPosts = $previewClient->fetch('*[_type == "blogPost"]');

<pre class="brush:php;toolbar:false;">// 创建文档
$newDoc = $client->create([
  '_type' => 'product',
  'name'  => 'Composer Magic Wand',
  'price' => 99.99,
]);
echo "新产品创建成功，ID: " . $newDoc['_id'] . "\n";

// 更新文档 (Patch 操作)
$updatedProduct = $client
  ->patch($newDoc['_id']) // 指定要更新的文档 ID
  ->set(['price' => 89.99]) // 更新价格
  ->inc(['stock' => 10]) // 库存增加10
  ->commit(); // 提交更改

// 删除文档
// $client->delete($newDoc['_id']);
// echo "产品已删除。\n";

// 事务：批量操作
$client->transaction()
  ->create(['_type' => 'category', 'name' => 'Tools'])
  ->delete('oldCategoryId')
  ->patch('someProductId')->set(['isActive' => true])
  ->commit();
echo "事务操作成功！\n";

<pre class="brush:php;toolbar:false;">use Sanity\BlockContent;

$document = $client->getDocument('someArticleId');
$articleContent = $document['body']; // 假设富文本字段名为 'body'

$html = BlockContent::toHtml($articleContent, [
    'projectId'    => 'your-project-id',
    'dataset'      => 'your-dataset-name',
    'imageOptions' => ['w' => 800, 'h' => 600], // 图片渲染选项
    // 还可以通过 serializers 自定义渲染逻辑
    'serializers' => [
        'listItem' => function ($item, $parent, $htmlBuilder) {
            return '<li class="my-custom-list-item">' . implode('', $item['children']) . '</li>';
        },
        // ... 其他自定义类型
    ]
]);
echo $html; // 输出渲染后的 HTML 内容