PHP调用B站API获取用户视频列表方法

本文深入解析了PHP调用B站开放平台API获取用户视频列表的核心难点与实战要点：重点强调access_token必须严格置于Authorization请求头（Bearer格式），而非URL或请求体中，否则必返401；同时提醒token仅2小时有效、需配合refresh_token刷新，以及WBI签名在搜索类接口中的强制性与实现复杂度；此外还纠正了视频发布时间因时区未设为Asia/Shanghai导致的8小时偏差问题，并明确指出绕过过时SDK、直接使用curl手动构造请求才是当前最稳定可靠的方案。

curl 请求 B 站 OpenAPI 时返回 401 或 “invalid access_token”

根本原因不是 token 没传，而是 access_token 必须放在请求头（Authorization: Bearer {token}），不能塞在 URL 参数或 POST body 里——B 站 OpenAPI 严格校验这个位置。

• 错误写法：https://api.bilibili.com/x/v2/space/video?access_token=xxx&mid=123 → 会被无视
• 正确写法：用 curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer xxx'])
• 注意：access_token 是短期有效的（默认 2 小时），过期后必须用 refresh_token 换新，不能硬编码或缓存太久
• 如果用 file_get_contents()，它不支持自定义 header，必须切到 curl

调用 x/v2/space/video 接口拿用户投稿列表的最小可行 PHP 示例

别碰 SDK，B 站官方没维护 PHP SDK，第三方库大多过期或漏签名逻辑。直接 curl 最稳。

• 必须带 mid（目标用户的 UID），不是昵称或 UID 字符串，是纯数字（如 202324）
• 分页靠 pn（页码）和 ps（每页数量），最大 ps=30，超过会截断
• 响应是 JSON，用 json_decode($res, true) 解析，检查 ['code'] === 0 再取 ['data']['list']['vlist']
• 示例片段：

  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, 'https://api.bilibili.com/x/v2/space/video?mid=202324&pn=1&ps=20');
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $access_token]);
  $res = curl_exec($ch);
  curl_close($ch);
  $data = json_decode($res, true);
  if ($data['code'] === 0) {
      foreach ($data['data']['list']['vlist'] as $v) {
          echo $v['title'] . "\n";
      }
  }
  

PHP 中处理 B 站返回的视频发布时间（created 字段）

created 是 Unix 时间戳（秒级），但 PHP 的 date() 默认按本地时区解析，而 B 站所有时间都基于东八区（UTC+8）——不显式设时区，时间会差 8 小时。

• 别用 date('Y-m-d', $v['created']) 直接格式化
• 先设时区：date_default_timezone_set('Asia/Shanghai')，再 date()
• 或者更稳妥：用 DateTime 显式指定时区：(new DateTime())->setTimestamp($v['created'])->setTimezone(new DateTimeZone('Asia/Shanghai'))
• 注意：B 站接口不返回 ISO 格式时间字符串，别指望自动识别时区

为什么用 file_get_contents() 调 x/space/wbi/arc/search 会失败

这个接口强制要求 WBI 签名（即 URL 中的 wts 和 w_rid 参数），而签名依赖动态生成的 img_key 和 sub_key，它们得先从 https://api.bilibili.com/x/web-interface/nav 或 /x/web-interface/wbi/img 拿到——file_get_contents() 无法做两步请求 + 拼参数。

• WBI 签名不是简单哈希，要拼接字符串、base64、md5，还涉及固定 salt，PHP 里得手写逻辑（B 站没公开完整规则，得逆向 JS）
• 目前稳定可用的 PHP 实现集中在 GitHub 上几个活跃仓库（搜 “bilibili-wbi-php”），但要注意它们是否更新了 2024 年的新 salt
• 如果你只是查自己账号的视频，绕开 WBI：用 x/v2/space/video（需登录态）；想搜别人公开视频，才必须上 WBI

实际跑通的关键，是把 token 生命周期、WBI 签名必要性、时区这三件事拎清楚——其他都是 curl 配置细节。

好了，本文到此结束，带大家了解了《PHP调用B站API获取用户视频列表方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！