B站视频解析3步走：一个PHP工具帮你快速拿到视频直链

【免费下载链接】bilibili-parsebilibili Video API项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-parse

上周，一位做短视频账号的朋友找我诉苦：收藏夹里存了两百多个B站教程，想剪进自己的课程素材库，可视频既没法直接下载，网页右键又查不到真实地址。我给他推荐了 bilibili-parse——一个用PHP写的B站视频解析工具，扔进去一个BV号，几秒就拿到视频真实播放地址，画质、格式、返回方式还能自己定。

这篇就带你认识它，顺便说清楚：这东西到底怎么用、能玩出什么花样、哪些坑值得提前绕开。

为什么视频直链获取这么难

先聊一个反常识的事实：B站在网页上给你看视频，但你拿不到它。播放器播放的那串地址往往带着临时签名，过段时间就失效；直接抓包复制出来的链接，换台电脑、换个网络环境就 404。

bilibili-parse 干的活，相当于给你配了一位同声传译：它听懂你给的 AV 号或 BV 号，替你向B站的接口发起请求，再把返回的加密信息翻译成人话——一条可以直接用的播放地址。

它解决的就是三个高频场景：

• 自媒体运营：拆解热门视频做逐帧分析，把官方教程片段剪辑进自己的内容里；
• 企业内训负责人：把B站上的公开课批量搬运到内部学习平台，员工不用跳出系统去刷网页；
• 独立开发者：把解析能力当成现成的 B站视频 API，给自己的小工具、小程序接上"输入ID出地址"的功能。

3分钟上手：三步拿到B站视频直链

整个流程就三步，没有隐藏菜单。

第一步：确认你手上的视频ID

视频地址栏里那一串BV1xx4y1x7zz就是 BV 号，也可以用老的 AV 号（纯数字）或者番剧的 EP 编号。三选一，交给工具即可。

第二步：告诉它你要什么

工具默认返回 JSON 数据，想调整也很简单，两个参数就够了：

第三步：跑起来看结果

最简单的用法，直接在浏览器里拼一个地址：

index.php?av=14661594&p=1&q=64&otype=json

返回的 JSON 里就带着url字段，那就是视频直链，复制到下载工具里就能存。

如果是在自己的 PHP 项目里调用，写法更直观：

require 'src/Bilibili.php'; use Injahow\Bilibili; $bp = new Bilibili('video'); $bp->bvid('BV1xx4y1x7zz') // 指定视频 ->page(1) // 选集 ->quality(64) // 清晰度 ->format('mp4') // 输出格式 ->cache(true) // 开启缓存 ->cache_time(3600); // 缓存1小时 $result = json_decode($bp->result(), true);

依赖只有 PHP 5.4+ 和 Curl、OpenSSL 扩展，绝大多数虚拟主机都满足，部署几乎没有门槛。

进阶玩法：把PHP视频解析工具用出花来

跑通基础流程只是开始，下面几个用法才是它值钱的地方。

返回方式选哪种

• otype=json：程序化处理的首选，字段干净，适合二次开发；
• otype=url：直接吐出一行纯文本地址，配合命令行下载脚本最顺手，也算一条轻量的 B站视频下载方案；
• otype=dplayer：直接返回一个带 DPlayer 播放器的页面，把地址丢进浏览器就能试播，不用自己搭前端。

项目里public/dplayer.html就是现成的播放器演示页，接上自己的解析地址即可预览效果。

画质参数到底怎么选

清晰度按等级映射，工具会自动向下修正：你请求 80，视频只支持到 64，它就给你 64，不会返回空。日常建议：

• 在线预览选 32，加载快不卡顿；
• 离线收藏选 64 或 80，画质和文件体积的平衡点在这里；
• 想追求极限画质，还有 112、116、120 等更高档位可试，但部分画质需要会员权限。

另外注意，mp4 格式目前上限是 80，想拿更高画质就切回 flv 或 dash。

缓存开起来，别重复挨打

同一视频反复解析会白白消耗请求次数。工具内置文件缓存，一行cache(true)就能开启，还可以指定缓存介质（文件或 APCu）和时长。批量处理课程列表时建议开着，配合失败重试和日志，一套完整的抓取任务就能稳定跑完：

try { $result = json_decode($bp->result(), true); if ($result['code'] != 0) { // 记日志、换备用方案 } } catch (Exception $e) { // 记录错误，稍后重试 }

番剧和课程也能解

工具不止处理普通视频：type=bangumi走番剧接口，type=cheese走课程接口，配合 EP 编号即可。解析会员专享内容时，可以把账号 Cookie 传进去——当然，前提是你自己具备观看权限。

踩坑记录：解析失败先别慌

用了一段时间，最常见的坑就这几个，对号入座就好。

提示"无访问权限"或"视频清晰度受限，可能需要会员"大概率是视频本身设置了权限，或者你要求的画质超出了当前账号能看到的等级。先降一档画质试试，仍不行就检查是否传了有效 Cookie。

返回"unknown cid"视频ID没解析出分集信息，通常是 AV/BV 号写错或接口临时抽风，换成另一套编号再试一次。

解析慢得像蜗牛优先检查缓存有没有开；再就是避开晚高峰，或者给工具指定一个可用代理。代码里预留了proxy()方法，懂的都懂。

直链拿到手却放不出来先确认这条地址在浏览器里能不能直接打开，很多情况是本地网络访问B站 CDN 受限，换个网络环境往往就好了。

开始你的第一次解析吧

到这里，你已经掌握了这个工具的核心玩法。想动手的话，流程很轻：

1. 克隆项目：git clone https://gitcode.com/gh_mirrors/bi/bilibili-parse；
2. 上传到任意支持 PHP 的服务器，浏览器访问index.php，页面会先展示说明文档；
3. 拼一个带av或bv参数的地址，验证返回结果；
4. 有兴致再翻翻src/Bilibili.php源码，看它如何伪装请求、如何剥出地址——这也是了解视频流媒体协议的一份不错的活教材。

最后提醒一句：解析工具是中性技术，请把下载能力用在个人学习、备份素材这类正当场景，尊重创作者的劳动，别拿它去做搬运牟利的事。用得好，它是你数字收藏夹的"最后一公里"；用得歪，只会给自己惹麻烦。

技术从来都是放大器，放大什么，取决于你。

学习提示：项目自带的public/readme.html是使用文档入口，遇到参数记不清时可以直接打开对照，比翻代码快得多。

【免费下载链接】bilibili-parsebilibili Video API项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-parse