虚拟主机大文件分块上传设置

虚拟主机支持大文件分块上传，需在后台或配置文件中启用相关功能（如PHP的upload_max_filesize、post_max_size、max_execution_time等参数调优），并配合前端js分片逻辑与后端合并处理，部分主机面板（如cPanel）提供可视化设置选项，注意检查服务器是否限制单次请求大小及超时时间，确保分块上传的稳定性与完整性。

虚拟主机环境下大文件分块上传的实用配置指南

在Web开发与内容管理实践中，用户常需上传几十MB甚至上百MB的媒体文件（如高清视频、设计素材包、数据库备份等），但传统虚拟主机受限于PHP默认配置、服务器超时机制及内存限制，直接上传极易触发“500错误”“413 Request Entity Too Large”或“上传超时”。分块上传（Chunked Upload） 成为兼顾兼容性与稳定性的优选方案——它不依赖高端服务器权限，而是通过前端切片 + 后端拼接的轻量逻辑,在共享虚拟主机约束下实现可靠的大文件传输。

为什么虚拟主机必须用分块上传？
主流虚拟主机（如阿里云虚拟主机、腾讯云WAF版、BlueHost、SiteGround等）通常禁用exec()、Shell_exec()等高危函数，且无法修改Nginx/Apache主配置，其PHP.ini参数普遍设为：

  • upload_max_filesize = 64M
  • post_max_size = 64M
  • max_execution_time = 30s
  • memory_limit = 128M

这些硬性限制使单次上传超过50MB几乎必然失败，而分块上传将文件拆为多个≤2MB的小块并行提交，每块独立校验、断点续传，规避了单请求超限问题,也显著降低因网络抖动导致的整体失败率。

核心设置三步走（无需服务器root权限）

  1. 前端分片控制（JavaScript）
    使用原生File API或轻量库（如Dropzone.js、Uppy）实现切片，关键配置示例： 

    const chunkSize = 2 * 1024 * 1024; // 每块2MB  
const file = document.getElementById('file').files[0];  
for (let start = 0; start < file.size; start += chunkSize) {  
const blob = file.slice(start, start + chunkSize);  
const formData = new FormData();  
formData.append('chunk', blob);  
formData.append('filename', file.name);  
formData.append('chunkIndex', Math.floor(start / chunkSize));  
formData.append('totalChunks', Math.ceil(file.size / chunkSize));  
// 发送至upload.php  
await fetch('upload.php', { method: 'POST', body: formData });  
}

    ⚠️ 注意：避免使用multipart/form-data自动编码大Blob，改用fetch直接提交二进制流更稳定。

  2. 后端接收与拼接（PHP脚本）
    创建upload.php，采用无状态设计，不依赖Session： 

    $uploadDir = 'uploads/chunks/';  
if (!is_dir($uploadDir)) mkdir($uploadDir, 0755, true);

$chunk = $_FILES['chunk']['tmp_name'];
$filename = basename($_POST['filename']);
$index = (int)$_POST['chunkIndex'];
$total = (int)$_POST['totalChunks'];

// 安全校验（关键！）
if (!$chunk || $index < 0 || $index >= $total || !is_uploaded_file($chunk)) {
http_response_code(400); exit('Invalid chunk');
}

$chunkPath = $uploadDir . "{$filename}.part{$index}";
if (move_uploaded_file($chunk, $chunkPath)) {
// 检查是否所有分片已就位
$allReceived = true;
for ($i = 0; $i < $total; $i++) {
if (!file_exists($uploadDir . "{$filename}.part{$i}")) {
$allReceived = false; break;
}
}
if ($allReceived) {
$finalPath = 'uploads/' . $filename;
$fp = fopen($finalPath, 'ab');
for ($i = 0; $i < $total; $i++) {
fwrite($fp, file_get_contents($uploadDir . "{$filename}.part{$i}"));
unlink($uploadDir . "{$filename}.part{$i}");
}
fclose($fp);
echo json_encode(['success' => true, 'url' => $finalPath]);
} else {
echo json_encode(['success' => false, 'message' => 'Chunk received']);
}
} 


3. **虚拟主机适配性优化**  
- ✅ 关闭`output_buffering`（在`.user.ini`中添加`output_buffering=Off`），避免响应截断；  
- ✅ 使用`set_time_limit(0)`临时延长脚本执行时间（仅对当前请求生效）；  
- ✅ 启用`session_write_close()`（若需记录进度）释放Session锁；  
- ❌ 避免`ini_set('memory_limit')`——多数虚拟主机禁止动态修改。  
三、避坑提醒  
- 不要依赖`$_SERVER['HTTP_RANGE']`做断点续传：虚拟主机通常不支持HTTP Range头解析；  
- 文件名务必`basename()`过滤，防止路径遍历攻击；  
- 生产环境必须增加MD5校验（前端计算每块哈希，后端比对）；  
- 上传目录需设置`chmod 755`，禁止`.php`执行（可通过`.htaccess`添加`<Files "*.php">Deny from all</Files>`）。  
分块上传本质是“以时间换空间”的智慧妥协——它不追求极致性能，而是在资源受限的虚拟主机生态中，用可落地的代码逻辑，把不可靠的大文件传输变成可预期、可恢复、可审计的操作，当您下次面对客户上传120MB课程视频却收到“上传失败”提示时，这套轻量方案，或许就是最务实的答案。