PHP不直接保存播放进度,需前后端协同:前端JS采集并防抖上报进度,PHP接口校验身份后存入数据库,关键在采集时机、幂等设计和存储精度。
PHP 是服务端语言,无法直接读取浏览器中 video 元素的当前播放时间(currentTime),也不能监听 timeupdate 事件。所谓“PHP 实现进度保存”,实际是 PHP 提供接口接收前端传来的进度值,并存入数据库或文件;前端 JS 负责采集、上报、恢复。混淆这一点,容易在服务端写一堆无用逻辑。
用户拖拽、暂停、关闭页面都可能影响进度准确性。单纯每秒发一次请求既浪费又不可靠。推荐策略:
timeupdate 事件监听,但用 setTimeout 防抖,例如 10 秒内只上报最后一次值ended 事件,上报 progress=100 或特殊标记(如 is_finished=1)beforeunload,同步触发一次最终上报(注意:此操作需是同步 AJAX 或 fetch(..., { keepalive: true }))/api/get-progress.php?video_id=123),再设置 video.currentTime = response.progress
必须校验用户身份,否则任何人都能伪造进度覆盖他人记录。假设使用 session 登录,且视频用 video_id 标识:
'not_logged_in']);
exit;
}
$video_id = (int)$_POST['video_id'] ?? 0;
$progress = (float)$_POST['progress'] ?? 0.0;
if ($video_id <= 0 || $progress < 0 || $progress > 100) {
http_response_code(400);
echo json_encode(['error' => 'invalid_params']);
exit;
}
// 假设用 PDO 操作 MySQL,表结构:user_id, video_id, progress, updated_at
$stmt = $pdo->prepare("INSERT INTO video_progress (user_id, video_id, progress, updated_at)
VALUES (?, ?, ?, NOW())
ON DUPLICATE KEY UPDATE progress = VALUES(progress), updated_at = NOW()");
$stmt->execute([$_SESSION['user_id'], $video_id, $progress]);
echo json_encode(['success' => true]);
?>
注意:video_progress 表必须有联合唯一索引 (user_id, video_id),否则 ON DUPLICATE KEY 不生效。
几个真实项目中高频出问题的点:
h
eader('Cache-Control: no-store');
Access-Control-Allow-Origin 和 Access-Control-Allow-Credentials: true
FLOAT 类型,小数精度丢失(如 99.9999999 变成 100)—— 改用 DECIMAL(5,2) 存百分比,或直接存毫秒级整数(INT)updated_at 时间戳比对)或改用 Redis + SETNX 控制写入频次进度保存看着简单,真正稳定跑一年不出错,关键不在 PHP 写几行,而在前端采集时机、后端幂等设计、存储字段精度这三处细节是否抠到位。