本文详解如何通过 advanced custom fields（acf）插件在 wordpress 后台添加视频上传功能，并在前端安全、可靠地嵌入播放器，支持 mp4 等常见格式。
本文详解如何通过 advanced custom fields（acf）插件在 wordpress 后台添加视频上传功能，并在前端安全、可靠地嵌入播放器，支持 mp4 等常见格式。
在 WordPress 开发中，ACF 是管理自定义内容字段的首选工具。但需注意：ACF 本身不提供原生“视频上传”字段类型——它没有像“图像”或“文件”那样专为视频优化的独立字段。因此，实现视频上传与展示需采用合理组合方案。
✅ 推荐方案：使用「文件」字段（非「链接」字段）
虽然答案中建议使用 Link 字段，但该方式仅适用于已托管的外部视频 URL（如 YouTube 或自有 CDN 链接），无法真正实现“上传本地视频”。若你希望用户在后台直接上传 .mp4、.webm 等视频文件，应选用 ACF 的「File」字段类型，并启用「限制文件类型」为 video（如 video/mp4, video/webm, video/ogg），确保安全性与语义准确性。
? 后台配置步骤：
- 进入 ACF → 自定义字段组 → 添加新字段；
- 字段标签设为 视频文件，字段名称设为 video_file（推荐英文小写下划线命名）；
- 字段类型选择 File；
- 展开「文件类型」选项，勾选 Only allow these file types，输入：
mp4, webm, ogg - 保存字段组并关联到目标页面/文章类型。
? 前端调用代码（推荐写法）：
<?php $video = get_field('video_file'); // 返回数组，含 url、filename、mime_type 等
if ($video && !empty($video['url'])) :
?><video width="954" height="535" controls class="tm-mb-40" preload="metadata"><source src="<?php%20echo%20esc_url(%24video['url']);%20?>" type="<?php echo esc_attr($video['mime_type'] ?? 'video/mp4'); ?>">
您的浏览器不支持该视频格式。
</source></video><?php endif; ?>
✅ 关键说明：
- 使用 esc_url() 和 esc_attr() 防止 XSS 攻击，符合 WordPress 安全编码规范；
- preload="metadata" 提升首帧加载体验；
- get_field() 返回的是完整附件数组（非纯 URL），便于后续扩展（如获取时长、尺寸等元数据）；
- 若需支持多格式兼容（如同时提供 MP4 + WebM），可配合 ACF 多文件字段或手动上传多个版本后在模板中判断 mime_type 动态输出
标签。
⚠️ 注意事项：
- 视频文件体积较大，请确保服务器 upload_max_filesize 和 post_max_size 已调高（例如 128M）；
- 共享主机可能禁用大文件上传或禁用 video/* MIME 类型，建议在本地/云环境测试；
- 生产环境中，强烈建议将视频转码为 H.264 编码 MP4（最佳兼容性），并生成缩略图（poster 属性）提升用户体验：
<video poster="<?php echo esc_url($video['thumbnail'] ?? ''); ?>" ...></video>
通过以上配置，你即可在 WordPress 后台一键上传视频，在前端以标准 HTML5
