在Web开发中，让用户通过浏览器把本地视频发布到服务器是常见需求，比如课程录播、短视频分享等。PHP作为成熟的服务端语言，自带了完整的文件接收机制，但如果照搬处理头像、附件的方式，很容易在上传大体积视频时失败。下面从运行环境配置到具体代码，把整套流程拆开说明。
一、修改PHP运行配置
视频文件通常几十兆甚至上吉字节，而PHP默认仅允许上传最大两兆的文件，且脚本执行时间很短。第一步必须调整php.ini中的几个关键参数，否则后面写再多代码也没用。你需要找到PHP安装目录下的php.ini，用文本编辑器打开。
其中upload_max_filesize决定单个文件上限，post_max_size限制整个表单提交大小，二者都应大于视频实际体积；max_execution_time和max_input_time要适当拉长，避免大文件传输中被强制中断。修改后重启Web服务才能生效。
; php.ini 关键配置示例 upload_max_filesize = 200M post_max_size = 210M max_execution_time = 600 max_input_time = 600 file_uploads = On
二、前端上传表单设计
浏览器端需要使用multipart/form-data编码类型的表单，才能把二进制视频数据正确打包发给PHP。普通文本表单会丢弃文件内容，这一点初学者经常忽略。同时必须设置MAX_FILE_SIZE隐藏域作为前端软限制，虽然它能被绕过，但可提升用户体验。
为了支持大文件，表单不需要特殊属性，但建议加上accept="video/*"让系统调起合适的文件选择器。以下代码给出一个最简可用页面，其中input的name为upfile，后端将靠它取值。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>视频上传</title>
</head>
<body>
<form action="upload.php" method="post" enctype="multipart/form-data">
<input type="hidden" name="MAX_FILE_SIZE" value="209715200">
<input type="file" name="upfile" accept="video/*">
<button type="submit">上传视频</button>
</form>
</body>
</html>
三、PHP后端接收与保存
当用户提交后，PHP会把文件信息填入超全局变量$_FILES。数组里tmp_name是服务器上的临时路径，error为状态码，type和size可供校验。视频不能信任前端给的类型，应在后端用finfo扩展检测真实MIME，防止伪装成视频的恶意脚本。
通过校验后，调用move_uploaded_file()把临时文件移到目标目录。该函数会验证文件确由HTTP上传，比直接rename更安全。下面脚本演示了完整判断逻辑，并用时间戳重命名避免覆盖。
<?php
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
exit('仅支持POST提交');
}
$file = $_FILES['upfile'] ?? null;
if (!$file || $file['error'] !== UPLOAD_ERR_OK) {
exit('上传出错，错误码：' . ($file['error'] ?? '未知'));
}
// 校验真实类型
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($file['tmp_name']);
$allow = ['video/mp4', 'video/quicktime', 'video/x-msvideo'];
if (!in_array($mime, $allow, true)) {
exit('不支持的视频格式');
}
$saveDir = __DIR__ . '/uploads/';
if (!is_dir($saveDir)) {
mkdir($saveDir, 0755, true);
}
$ext = pathinfo($file['name'], PATHINFO_EXTENSION);
$newName = date('Ymd_His') . '_' . uniqid() . '.' . $ext;
$target = $saveDir . $newName;
if (move_uploaded_file($file['tmp_name'], $target)) {
echo '上传成功，保存为：' . htmlspecialchars($newName);
} else {
echo '移动文件失败';
}
四、常见错误与排查
实际部署中，经常会遇到返回错误码1（超过upload_max_filesize）或2（超过表单MAX_FILE_SIZE）。这类问题九成以上源于php.ini未重载，可通过phpinfo()函数确认当前生效值。另外，目标文件夹若没有写权限，move_uploaded_file也会返回false。
在Nginx等环境下，还要检查Web服务器自身的客户端最大上传体限制，例如Nginx的client_max_body_size指令，否则请求根本到不了PHP就被拒。建议开发阶段打开error_reporting(E_ALL)，结合日志快速定位是哪一层拦截了视频。
| 错误码 | 含义 | 处理方式 |
|---|---|---|
| 1 | 文件超过php.ini限制 | 调大upload_max_filesize |
| 7 | 磁盘写入失败 | 检查目录权限与剩余空间 |
| 0 | 成功 | 无需处理 |
五、进阶：大视频分块上传思路
当视频超过几百兆，单次POST在弱网环境极易失败。此时可引入分块上传：前端用JS把文件切为小块，每块带序号调用接口，后端按序号暂存，全部到达后合并。PHP端用file_put_contents以FILE_APPEND模式写同一文件即可。
分块方案虽增加复杂度，但能断点续传、显示进度。后端需维护一个任务ID映射临时分片目录，并校验每片大小与哈希。下例展示接收单分片并追加的精简写法。
<?php
// 接收分片：?task=xxx&index=0
$task = $_GET['task'] ?? '';
$index = (int)($_GET['index'] ?? 0);
$part = $_FILES['chunk']['tmp_name'] ?? '';
if (!$task || !is_uploaded_file($part)) {
exit('参数错误');
}
$dir = __DIR__ . '/parts/' . $task;
if (!is_dir($dir)) {
mkdir($dir, 0755, true);
}
$save = $dir . '/part_' . str_pad($index, 5, '0', STR_PAD_LEFT);
move_uploaded_file($part, $save);
echo '分片' . $index . '已接收';
通过上述配置、表单、接收脚本与排错方法，PHP上传视频到服务器不再神秘。从环境调优到代码落地，只要按流程走，就能在多数项目中稳定运行视频发布功能。
PHP文件上传video_upload修改时间：2026-08-08 16:48:39