基于Drupal变量调用Vimeo API遇问题：传参无响应

我之前在项目里也碰到过类似的第三方API调用坑，结合你的描述，问题大概率出在从Drupal字段获取的ID值不符合API要求上，咱们一步步排查和解决：

可能的原因及排查步骤 #

1. Drupal字段内容不是纯Vimeo ID #

很多时候用户会把完整的Vimeo链接（比如https://vimeo.com/249687303）或者带额外字符的ID存在字段里，而Vimeo API只需要纯数字ID。

• 先打印出从字段获取的变量值，看看实际内容：

  $vimeo_id = $node->field_vimeo_id->value;
  var_dump($vimeo_id); // 或者用Drupal的kint($vimeo_id)（需要装Devel模块）
  

• 如果是带链接的情况，需要提取ID：

  // 从链接中提取ID的示例
  preg_match('/vimeo\.com\/(\d+)/', $vimeo_id, $matches);
  $clean_id = $matches[1] ?? '';
  

• 如果ID前后有空格/换行，用trim()清理：

  $clean_id = trim($vimeo_id);
  

2. Drupal字段取值方式错误 #

Drupal 8/9/10的实体字段是对象形式，直接调用字段名拿到的是字段对象，不是实际值：

• 错误示例：$vimeo_id = $node->field_vimeo_id;（拿到的是FieldItemList对象）
• 正确取值：

  // 文本字段取value属性
  $vimeo_id = $node->field_vimeo_id->value;
  // 如果是实体引用字段，需要取目标实体的某个字段（比如引用的媒体实体里的ID）
  $vimeo_id = $node->field_vimeo_media->entity->field_vimeo_id->value;
  

3. 变量为空或未加载字段 #

如果节点字段没填充，或者在获取字段时节点未完全加载，会导致变量为空，API自然无响应：

• 加个非空判断再调用API：

  if (!empty($clean_id)) {
      $response = $lib->request("/videos/{$clean_id}");
      // 后续处理
  } else {
      drupal_set_message('Vimeo ID字段未填写', 'warning');
  }
  

4. 变量类型不匹配 #

Vimeo API接受字符串或整数类型的ID，但如果Drupal字段返回的是其他类型（比如对象），会导致请求失败：

• 强制转换为字符串确保兼容：

  $clean_id = (string) $node->field_vimeo_id->value;
  

完整示例代码 #

// 假设$node是已加载的节点对象
$raw_id = $node->field_vimeo_id->value;
$clean_id = trim($raw_id);

// 从链接提取ID（如果字段存的是完整链接）
if (strpos($clean_id, 'vimeo.com') !== false) {
    preg_match('/vimeo\.com\/(\d+)/', $clean_id, $matches);
    $clean_id = $matches[1] ?? '';
}

if (!empty($clean_id)) {
    // 调用Vimeo API
    $response = $lib->request("/videos/{$clean_id}");
    
    // 检查响应状态
    if ($response['status'] === 200) {
        // 处理返回的视频数据
        $video_data = $response['body'];
        // 比如输出视频标题
        echo $video_data['name'];
    } else {
        // 输出错误信息方便调试
        drupal_set_message("Vimeo API请求失败: {$response['status']} - {$response['body']['error']}", 'error');
    }
} else {
    drupal_set_message('无效的Vimeo ID', 'warning');
}

核心思路就是：先确保从Drupal拿到的ID是纯数字、非空、格式正确的，再传给API。绝大多数这类问题都是字段取值或内容格式的小问题，排查清楚变量值就解决了。

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