PHP实现视频播放记录方法详解

今天golang学习网给大家带来了《PHP实现视频播放历史记录方法》，其中涉及到的知识点包括等等，无论你是小白还是老手，都适合看一看哦~有好的建议也欢迎大家在评论留言，若是看完有所收获，也希望大家能多多点赞支持呀！一起加油学习~

播放历史记录需服务端存储+前端上报，数据库表应含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 接口需做基础校验：

• 检查 $_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），需统一清洗格式（去空格、转小写），否则相同视频被记为不同条目

好了，本文到此结束，带大家了解了《PHP实现视频播放记录方法详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！