PHP cURL 上传视频失败主因是Content-Type未显式设置、Expect: 100-continue未禁用、签名参数未urlencode及排序错误、大文件未流式处理或分片；需用stream_get_contents()读二进制、rawurlencode()编码、curl_file_create()或fread()分块、指数退避轮询。
PHP cURL 调用视频上传接口时返回 400 或空响应
多数第三方视频平台（如七牛云、腾讯云 VOD、阿里云点播）的上传接口要求严格遵循 Content-Type 和认证头，PHP 默认 curl_setopt($ch, CURLOPT_POSTFIELDS, $data) 会自动设为 multipart/form-data，但若传的是原始二进制流（如 fopen('video.mp4', 'r')），必须显式设置 Content-Type 并禁用自动 header。否则服务端解析失败，直接返回 400。
- 用
fopen()读取文件后，务必用stream_get_contents()获取完整二进制内容，不能直接传 resource - 手动设置
Content-Type: video/mp4（根据实际格式调整），并关闭CURLOPT_HTTPHEADER中的Expect: 100-continue（某些 CDN 会拦截） - 避免用
file_get_contents()加载大视频——内存溢出风险高；改用curl_file_create()（PHP 5.5+）或分块流式上传
curl_setopt($ch, CURLOPT_URL, 'https://vod.tencentcloudapi.com/');
curl_setopt($ch, CURLOPT_POST, true);
$videoData = file_get_contents('/tmp/demo.mp4'); // 小文件可接受
$postFields = [
'Action' => 'CommitUpload',
'Version' => '2018-07-17',
'VideoName' => 'test.mp4',
'VideoType' => 'mp4',
'Content' => base64_encode($videoData), // 注意：部分接口要求 base64 编码体
];
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postFields));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: '.$authHeader]);签名参数生成错误导致 “InvalidSignature”
腾讯云、阿里云等强制要求请求签名，PHP 常见坑是没对参数 key/value 做 urlencode() 再拼接，或忽略参数排序规则（字典序升序）。比如 Timestamp=1717023456 和 Nonce=abc123 必须按 key 名排序后拼，且所有 value 都要 urlencode()，最后用 hash_hmac('sha256', $stringToSign, $secretKey) 计算。
- 不要用
http_build_query()直接拼签名原文——它默认不编码=和&，会导致签名失效 - 注意时区：
time()返回的是 Unix 时间戳（UTC），但部分平台校验时会对比服务器本地时间，误差超 5 分钟即拒收 - PHP 7.4+ 推荐用
rawurlencode()替代urlencode()，更符合 RFC 3986
处理大视频分片上传（如七牛云 resumable upload）
单次上传超过 100MB 通常需走分片流程：先调 mkblk 创建块，再多次 bput 上传切片，最后 mkfile 合并。PHP 关键是控制每片大小（建议 4MB）、记录已上传 offset，并在失败时从断点续传。
- 用
fseek($fp, $offset)+fread($fp, $chunkSize)精确读取片段，别依赖substr()—— 对二进制文件不安全 -
mkblk返回的ctx是 Base64 字符串，后续mkfile必须原样传入，不能额外base64_decode() - 每次
bput请求头必须带X-Reqid和X-CheckCrc（如开启 CRC 校验）
$fp = fopen('/big-video.mp4', 'rb');
fseek($fp, $offset);
$chunk = fread($fp, 4 * 1024 * 1024);
$ctx = base64_encode($chunk); // 注意：不是对整个文件 base64，而是每片单独 base64异步任务状态轮询容易触发限频或丢状态
上传完成后调 DescribeMediaProcessTask（腾讯云）或 GetMediaInfo（阿里云）查转码结果，不能简单 sleep(2) 循环——既浪费资源，又可能被限流（如腾讯云默认 10 QPS）。正确做法是用指数退避 + 最大重试次数。
立即学习“PHP免费学习笔记（深入）”；
- 首次等待 1s，失败后 2s → 4s → 8s，超过 5 次立即退出，记录 task ID 供人工排查
- 轮询前先检查
status字段是否已是finished或failed，避免无谓请求 - 生产环境建议把轮询逻辑移到队列（如 Redis + Laravel Horizon），PHP 主流程只发任务、存 task_id
真正卡住人的往往不是接口调用本身，而是签名生成时少 urlencode 了一个参数值，或是上传大文件忘了关 Expect: 100-continue 导致连接挂起。这些细节不报错，但永远得不到成功响应。
