Laravel 视频文件上传失败并存入临时路径问题的完整解决方案-php教程-PHP中文网

Laravel 视频文件上传失败并存入临时路径问题的完整解决方案

Laravel 视频上传失败、数据库写入 /tmp/phpxxx 临时文件名，通常由 PHP 配置限制（如 upload_max_filesize、post_max_size、max_execution_time）或 Laravel 文件处理逻辑缺陷导致，需系统性排查与修复。

laravel 视频上传失败、数据库写入 `/tmp/phpxxx` 临时文件名，通常由 php 配置限制（如 `upload_max_filesize`、`post_max_size`、`max_execution_time`）或 laravel 文件处理逻辑缺陷导致，需系统性排查与修复。

在 Laravel 5.8 中处理视频上传时，若数据库中存储的是类似 /tmp/phpsMPjG1 的临时路径而非真实文件名，说明文件根本未成功移动，而是 $request->file('prd_video') 返回了一个已失效或未正确解析的 UploadedFile 实例——这几乎总是 PHP 层面上传流程中断的表征，而非 Laravel 代码逻辑错误本身。

? 根本原因分析

该现象绝非 Laravel “自动保存临时路径”，而是 PHP 在接收大文件时因配置超限，导致：

文件未被真正上传到 $_FILES 的 tmp_name 目录（或上传中途被截断）；
getClientOriginalName() 仍可调用（因原始请求头含 filename），但 move() 实际操作的是一个已不存在或权限不足的临时文件；
move() 失败时 Laravel 默认不抛出异常（尤其在生产环境 APP_DEBUG=false 下），静默返回 false，而后续 $findpro->save() 仍执行，导致空/脏数据写入。

✅ 正确且健壮的上传实现（推荐 Laravel 原生方式）

use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;

// 在控制器中（确保已验证请求）
if ($request->hasFile('prd_video') && $request->file('prd_video')->isValid()) {
    /** @var UploadedFile $video */
    $video = $request->file('prd_video');

    // 1. 生成唯一文件名，避免覆盖 & 注入风险
    $extension = $video->getClientOriginalExtension();
    $safeName = uniqid('video_') . '.' . strtolower($extension);

    // 2. 使用 Storage（推荐：更安全、可适配本地/S3等）
    $path = $video->storeAs('upload/video/products', $safeName, 'public');

    // 3. 保存相对路径（如：upload/video/products/video_xxx.mp4）
    $findpro = Product::find($stored->prd_id);
    $findpro->prd_video = $path; // 或 $safeName，取决于你字段定义
    $findpro->save();
} else {
    // 显式捕获上传失败原因
    $error = $request->file('prd_video')?->getError();
    \Log::error("Video upload failed. Error code: {$error}, Input: " . json_encode($request->all()));
    throw new \Exception("视频上传失败，请检查文件大小与格式。");
}

⚠️ 注意：使用 Storage::disk('public') 前，请确认 config/filesystems.php 中 'public' 磁盘已正确配置，并运行 php artisan storage:link 创建软链接。

? 必须检查的 PHP 与服务器配置

配置项	推荐最小值	检查位置
upload_max_filesize	256M	php.ini
post_max_size	300M（需 ≥ upload_max_filesize）	php.ini
max_execution_time	300（300秒，适应大视频上传）	php.ini 或 .htaccess / Nginx config
max_input_time	300	php.ini
memory_limit	512M	php.ini

✅ 验证方式：创建 phpinfo.php 访问，搜索上述关键词；修改后务必重启 Web 服务（Apache/Nginx + PHP-FPM）。

? 表单与前端注意事项

确保 HTML 表单包含：

enctype="multipart/form-data" 不可省略；
accept="video/*" 提升用户体验，但服务端仍需校验 MIME 类型（见下方）。

? 安全增强：MIME 类型与扩展名校验

if (!$request->file('prd_video')->isValid()) {
    throw new \Exception('上传文件无效，请重试。');
}

$allowedMimes = ['video/mp4', 'video/avi', 'video/mov', 'video/webm'];
$allowedExts = ['mp4', 'avi', 'mov', 'webm'];

$mimeType = $video->getMimeType();
$ext = strtolower($video->getClientOriginalExtension());

if (!in_array($mimeType, $allowedMimes) || !in_array($ext, $allowedExts)) {
    throw new \Exception('仅支持 MP4、AVI、MOV、WEBM 格式视频。');
}