Contentful PHP API：如何通过ID获取单个项目条目？

你可以通过两种方式获取指定ID的单个项目：

方式一：直接通过ID获取条目 #

Contentful的PHP SDK提供了getEntry()方法，这是获取单个指定ID内容最直接高效的方式：

// 初始化客户端（与现有代码一致）
$client = new \Contentful\Delivery\Client('xxx-xxx-xxx', 'xxx', 'master');

// 从URL参数中获取项目ID
$projectId = $_GET['project_id'] ?? '';

if ($projectId) {
    try {
        // 直接获取指定ID的条目
        $singleProject = $client->getEntry($projectId);
        // 后续可访问项目字段，示例：$singleProject->getFields()['title']
    } catch (\Contentful\Core\Exception\NotFoundException $e) {
        // 处理项目不存在的情况
        echo "项目不存在";
    }
}

方式二：通过Query筛选ID #

如果需要结合其他筛选条件，也可以用Query的where()方法指定sys.id来精准筛选：

$client = new \Contentful\Delivery\Client('xxx-xxx-xxx', 'xxx', 'master');
$projectId = $_GET['project_id'] ?? '';

if ($projectId) {
    $query = (new Contentful\Delivery\Query())
        ->setContentType('MyPortfolio')
        ->where('sys.id', $projectId);
    
    $entries = $client->getEntries($query);
    // 由于ID唯一，结果集最多包含一个条目
    if ($entries->count() > 0) {
        $singleProject = $entries->first();
    } else {
        echo "项目不存在";
    }
}

注意事项 #

• 务必对$_GET['project_id']做合法性校验，比如过滤非法字符，避免安全风险
• 第一种方式性能更优，因为直接请求单个条目，无需返回集合数据
• 记得处理异常场景，比如ID格式无效或对应项目不存在的情况

内容的提问来源于stack exchange，提问作者Francesco