播放历史记录需服务端存储+前端上报，数据库表应含user_id、video_id、last_position等字段并建联合索引；php接口须校验登录态、参数合法性，用on duplicate key update避免重复；前端在timeupdate等事件中节流上报，并在加载时读取进度恢复播放。
PHP 本身不直接控制前端视频播放，所谓“播放历史记录”本质是「服务端存储 + 前端主动上报」的组合方案。核心在于：用户每次观看（或观看到某个时间点）时，前端通过 AJAX 把 video_id、user_id、played_at、duration、position 等数据发给 PHP 接口，PHP 将其写入数据库；后续加载页面时再查出该用户的历史记录并渲染到前端。
如何设计数据库表结构
历史记录不是简单存个 ID，要支持「断点续播」和「最近观看排序」，至少需以下字段：
-
id：主键 -
user_id：关联用户（必须有登录态，不能靠 session_id 或 cookie 伪造） -
video_id：视频唯一标识（如数据库videos.id或平台视频号） -
last_position：整数，单位为秒（例如 127 表示看到第 2 分 7 秒） -
total_duration：视频总时长（秒），用于判断是否已看完 -
updated_at：最后更新时间（用作「最近观看」排序依据）
建议加联合索引：INDEX(user_id, updated_at) 和 INDEX(user_id, video_id)，避免查询慢。
PHP 后端接收并保存播放进度
前端通常在 timeupdate 事件中节流上报（如每 30 秒一次），或在 ended、visibilitychange 时强制提交。PHP 接口需做基础校验：
立即学习“PHP免费学习笔记（深入）”；
- 检查
$_SESSION['user_id']是否存在且合法（不能仅依赖 cookie） - 过滤
$_POST['video_id']为字符串或整数，防止 SQL 注入 - 校验
$_POST['position']是非负数字且 ≤$_POST['duration'] - 使用
INSERT ... ON DUPLICATE KEY UPDATE（MySQL）或UPSERT（PostgreSQL）避免重复插入
INSERT INTO play_history (user_id, video_id, last_position, total_duration, updated_at)
VALUES (?, ?, ?, ?, NOW())
ON DUPLICATE KEY UPDATE
last_position = VALUES(last_position),
total_duration = VALUES(total_duration),
updated_at = NOW();
前端如何触发并读取历史记录
PHP 不负责播放器逻辑，但可输出初始状态。例如在视频页 PHP 模板中：
<?php
$history = get_user_video_history($user_id, $video_id); // 自定义函数，查出该视频的 last_position
$position = $history ? (int)$history['last_position'] : 0;
?>
<video id="player" data-video-id="<?= htmlspecialchars($video_id) ?>">
<source src="/videos/<?= htmlspecialchars($video_id) ?>.mp4">
</video>
<script>
const player = document.getElementById('player');
const savedPosition = <?= $position ?>;
if (savedPosition > 0) {
player.currentTime = savedPosition;
}
player.addEventListener('timeupdate', throttle(() => {
fetch('/api/save-progress.php', {
method: 'POST',
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
body: `video_id=<?= urlencode($video_id) ?>&position=${Math.floor(player.currentTime)}&duration=${Math.floor(player.duration)}`
});
}, 30000)); // 30 秒节流
</script>
注意：throttle 需自行实现或引入轻量工具函数；player.duration 可能为 NaN，应监听 loadedmetadata 后再读取。
容易被忽略的关键点
真实场景下这几个细节常导致功能失效：
- 未区分「游客」和「登录用户」——PHP 必须拒绝未认证请求，不能 fallback 到 session_id 存储
- 前端未处理页面卸载（
beforeunload）或 tab 切走（visibilitychange），导致最后 20 秒进度丢失 - 数据库未设
user_id + video_id唯一约束，同一用户反复点击同一视频会生成多条冗余记录 - 移动端 Safari 对
localStorage的限制较严，不要把关键进度只存在前端 - 视频 ID 若来自第三方（如 YouTube ID），需统一清洗格式（去空格、转小写），否则相同视频被记为不同条目
