PHP不直接渲染视频字幕，仅动态生成符合规范的.vtt文件路径供HTML5 <video>标签使用；需校验语言参数、确保路径安全、Web服务器正确配置text/vtt MIME类型，并严格遵循WebVTT格式。

PHP 本身不处理视频字幕渲染

PHP 是服务端脚本语言，无法直接控制浏览器中视频的字幕显示。所谓“PHP 支持多语言字幕”，实际是指：用 PHP 动态生成或选择符合 <track> 标签规范的字幕文件路径（如 .vtt），交由 HTML5 <video> 元素在前端加载渲染。

后端用 PHP 输出对应语言的 .vtt 路径

常见做法是根据用户语言偏好（如 URL 参数、session 或 Accept-Language）决定返回哪个字幕文件。关键点在于路径拼接安全和 MIME 类型无关（PHP 不需发送 .vtt 内容，只输出 HTML）。

• $_GET['lang'] 必须白名单校验，避免路径遍历，例如只允许 ['zh', 'en', 'ja']
• 字幕文件必须放在 Web 可访问目录下（如 /subtitles/movie_zh.vtt），不能放在 include/ 或 private/ 等不可直链目录
• 不要用 PHP readfile() 输出 .vtt 内容再设 header——这会破坏浏览器对 <track> 的原生解析，导致字幕不显示

<video controls>
  <source src="movie.mp4" type="video/mp4">
  <track kind="subtitles" label="中文" srclang="zh" src="/subtitles/<?php echo htmlspecialchars($lang === 'zh' ? 'movie_zh.vtt' : 'movie_en.vtt'); ?>" default>
  <track kind="subtitles" label="English" srclang="en" src="/subtitles/movie_en.vtt">
</video>

注意 Web 服务器对 .vtt 文件的 MIME 配置

如果字幕不显示，大概率是 Web 服务器未正确返回 text/vtt 类型。Nginx 和 Apache 默认可能不识别 .vtt 后缀。

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

• Nginx：在 http 或 server 块中添加 types { text/vtt vtt; }
• Apache：确保 mime_module 已启用，并在 .htaccess 或配置中加入 AddType text/vtt .vtt
• 验证方式：直接访问 https://yoursite.com/subtitles/test.vtt，用浏览器开发者工具看响应头中 Content-Type 是否为 text/vtt

字幕文件内容必须严格符合 WebVTT 格式

哪怕一个空格或换行错误，整个字幕都会失效。PHP 不负责生成内容，但若动态生成（如从数据库读取翻译后拼接），必须遵守规范：

立即学习“PHP免费学习笔记（深入）”；

• 首行必须是 WEBVTT（全大写，无空格）
• 每个 cue 块之间需有空行
• 时间格式为 HH:MM:SS.mmm --> HH:MM:SS.mmm，毫秒必须三位
• 禁止 UTF-8 BOM；推荐用 UTF-8 without BOM 编码保存

WEBVTT

1
00:00:01.000 --> 00:00:04.000
你好，欢迎观看。

2
00:00:05.000 --> 00:00:08.000
This is an English subtitle.

字幕逻辑看似简单，但卡在 MIME 类型、路径权限、VTT 格式三处就几乎占掉全部调试时间。别让 PHP 背锅——它只是把正确路径塞进 HTML，剩下的全是前端和服务器的事。