本文详解在 Laravel 中正确保存上传视频文件至 public 目录的方法，指出误用图像处理库（如 Intervention Image）的常见错误，并提供安全、可靠的标准文件存储方案。
本文详解在 laravel 中正确保存上传视频文件至 `public` 目录的方法，指出误用图像处理库（如 intervention image）的常见错误，并提供安全、可靠的标准文件存储方案。
在 Laravel 中处理视频上传与图像上传有本质区别：Intervention Image 仅支持图像格式（如 JPG、PNG、GIF），无法解析或保存 MP4、AVI、MOV 等视频文件。若强行将视频文件传入 Image::make()，将触发异常（如 Unsupported image type 或 Unable to init from given binary data），导致请求失败。
✅ 正确做法是使用 Laravel 原生的 UploadedFile::move() 方法，将视频文件直接移动到 public 下指定目录（需确保该目录已存在且 Web 服务器有写权限）：
use Illuminate\Http\Request;
// 在控制器方法中
public function store(Request $request)
{
$request->validate([
'video' => 'required|file|mimetypes:video/mp4,video/avi,video/mov,video/webm|max:102400', // 示例：限制为常见视频类型，最大100MB
]);
$video = $request->file('video');
$extension = $video->getClientOriginalExtension();
$vidName = hexdec(uniqid()) . '.' . $extension;
// ✅ 正确：使用 move() 将文件保存至 public_path()
$publicPath = public_path('uploads/about/experience_us/');
if (!is_dir($publicPath)) {
mkdir($publicPath, 0755, true); // 自动创建多级目录
}
$video->move($publicPath, $vidName);
$vidUrl = 'uploads/about/experience_us/' . $vidName;
ExperienceUs::updateOrCreate(
[], // 条件：如需按 ID 更新，请传入 ['id' => $id]
['video' => $vidUrl]
);
return response()->json(['message' => 'Video uploaded successfully', 'url' => $vidUrl]);
}⚠️ 注意事项：
-
不要使用
Image::make()处理视频——它专为图像设计，对视频无意义且必然报错； -
public_path()返回的是绝对服务器路径（如/var/www/html/public/uploads/...），而数据库中应只存相对 URL 路径（如uploads/about/experience_us/abc123.mp4），前端可通过https://yoursite.com/uploads/...直接访问； - 务必验证 MIME 类型和文件大小，防止恶意文件上传；
-
确保
public/uploads/...目录可写（Linux 下常用chmod -R 755 public/uploads）； - 如需更高安全性与可扩展性，推荐后续迁移到 Laravel 的 Storage Facade 配置
public磁盘，并使用storePublicly()方法统一管理。
通过以上方式，即可稳定、高效地将用户上传的视频持久化至 Web 可访问路径，为前端播放、CDN 分发等场景奠定基础。
