Laravel 阿里云 OSS 视频上传完整方案

一、环境准备

1.1 安装 OSS SDK

composer require aliyuncs/oss-sdk-php

1.2 环境配置

在 .env 文件中添加：

OSS_ACCESS_KEY_ID=你的AccessKeyId
OSS_ACCESS_KEY_SECRET=你的AccessKeySecret
OSS_ENDPOINT=oss-cn-hangzhou.aliyuncs.com
OSS_BUCKET=你的Bucket名称
OSS_IS_PRIVATE=false

1.3 创建配置文件

创建 config/oss.php：

 env('OSS_ACCESS_KEY_ID'),
    'access_key_secret' => env('OSS_ACCESS_KEY_SECRET'),
    'endpoint' => env('OSS_ENDPOINT'),
    'bucket' => env('OSS_BUCKET'),
    'is_private' => env('OSS_IS_PRIVATE', false),
];

二、分片上传大视频

2.1 基础分片上传代码

ossClient = new OssClient(
            config('oss.access_key_id'),
            config('oss.access_key_secret'),
            config('oss.endpoint')
        );
        $this->bucket = config('oss.bucket');
    }

    /**
     * 分片上传视频文件
     */
    public function multipartUpload($filePath, $objectName)
    {
        try {
            // 初始化分片上传
            $uploadId = $this->ossClient->initiateMultipartUpload($this->bucket, $objectName);

            $partSize = 5 * 1024 * 1024; // 每片5MB
            $uploadFileSize = filesize($filePath);
            $pieces = $this->ossClient->generateMultiuploadParts($uploadFileSize, $partSize);
            $uploadParts = [];

            // 逐个上传分片
            foreach ($pieces as $i => $piece) {
                $fromPos = $piece[$this->ossClient::OSS_SEEK_TO];
                $toPos = $piece[$this->ossClient::OSS_LENGTH];
                
                $uploadPart = fopen($filePath, 'r');
                fseek($uploadPart, $fromPos);
                
                $eTag = $this->ossClient->uploadPart($this->bucket, $objectName, $uploadId, [
                    'partNumber' => ($i + 1),
                    'uploadPart' => $uploadPart,
                    'length' => $toPos,
                ]);
                
                fclose($uploadPart);
                
                $uploadParts[] = [
                    'PartNumber' => ($i + 1),
                    'ETag' => $eTag,
                ];
            }

            // 完成分片上传
            $result = $this->ossClient->completeMultipartUpload(
                $this->bucket, 
                $objectName, 
                $uploadId, 
                $uploadParts
            );

            return [
                'success' => true,
                'url' => $this->getPublicUrl($objectName),
                'etag' => $result
            ];

        } catch (OssException $e) {
            return [
                'success' => false,
                'error' => $e->getMessage()
            ];
        }
    }

    private function getPublicUrl($objectName)
    {
        return "https://{$this->bucket}." . config('oss.endpoint') . "/{$objectName}";
    }
}

2.2 优化版本（带进度回调）

public function multipartUploadWithProgress($filePath, $objectName, $progressCallback = null)
{
    try {
        $uploadId = $this->ossClient->initiateMultipartUpload($this->bucket, $objectName);
        $partSize = 5 * 1024 * 1024;
        $uploadFileSize = filesize($filePath);
        $pieces = $this->ossClient->generateMultiuploadParts($uploadFileSize, $partSize);
        $uploadParts = [];

        foreach ($pieces as $i => $piece) {
            $fromPos = $piece[$this->ossClient::OSS_SEEK_TO];
            $toPos = $piece[$this->ossClient::OSS_LENGTH];
            
            $uploadPart = fopen($filePath, 'r');
            fseek($uploadPart, $fromPos);
            
            $eTag = $this->ossClient->uploadPart($this->bucket, $objectName, $uploadId, [
                'partNumber' => ($i + 1),
                'uploadPart' => $uploadPart,
                'length' => $toPos,
            ]);
            
            fclose($uploadPart);
            
            $uploadParts[] = [
                'PartNumber' => ($i + 1),
                'ETag' => $eTag,
            ];

            // 进度回调
            if ($progressCallback) {
                $progress = round(($i + 1) / count($pieces) * 100, 2);
                call_user_func($progressCallback, $progress, $i + 1, count($pieces));
            }
        }

        $result = $this->ossClient->completeMultipartUpload(
            $this->bucket, 
            $objectName, 
            $uploadId, 
            $uploadParts
        );

        return ['success' => true, 'url' => $this->getPublicUrl($objectName), 'etag' => $result];

    } catch (OssException $e) {
        return ['success' => false, 'error' => $e->getMessage()];
    }
}

三、视频截图功能

3.1 生成第一帧截图

/**
 * 获取视频第一帧截图
 */
public function getVideoSnapshot($objectName, $width = 800, $height = 600, $time = 0)
{
    $process = "video/snapshot,t_{$time},f_jpg,w_{$width},h_{$height},m_fast";
    
    // 公共读取的 Bucket
    if (!config('oss.is_private')) {
        $endpoint = config('oss.endpoint');
        return "https://{$this->bucket}.{$endpoint}/{$objectName}?x-oss-process={$process}";
    }
    
    // 私有 Bucket，需要签名
    return $this->ossClient->signUrl($this->bucket, $objectName, 3600, 'GET', [
        'x-oss-process' => $process
    ]);
}

3.2 多种截图参数

/**
 * 生成多种规格的截图
 */
public function generateMultipleSnapshots($objectName, $configs = [])
{
    $defaultConfigs = [
        'thumbnail' => ['width' => 200, 'height' => 150, 'time' => 0],
        'medium' => ['width' => 600, 'height' => 400, 'time' => 0],
        'large' => ['width' => 1200, 'height' => 800, 'time' => 0],
    ];
    
    $configs = array_merge($defaultConfigs, $configs);
    $snapshots = [];
    
    foreach ($configs as $name => $config) {
        $snapshots[$name] = $this->getVideoSnapshot(
            $objectName,
            $config['width'],
            $config['height'],
            $config['time']
        );
    }
    
    return $snapshots;
}

四、控制器实现

4.1 视频上传控制器

videoUploader = new VideoUploader();
    }

    /**
     * 上传视频
     */
    public function upload(Request $request): JsonResponse
    {
        $request->validate([
            'video' => 'required|file|mimes:mp4,avi,mov,wmv,flv,webm|max:2048000' // 最大2GB
        ]);

        $file = $request->file('video');
        $extension = $file->getClientOriginalExtension();
        
        // 生成存储路径
        $objectName = 'videos/' . date('Y/m/d/') . Str::uuid() . '.' . $extension;

        // 执行上传
        $result = $this->videoUploader->multipartUpload($file->getRealPath(), $objectName);

        if ($result['success']) {
            // 生成截图
            $snapshotUrl = $this->videoUploader->getVideoSnapshot($objectName);
            
            return response()->json([
                'success' => true,
                'data' => [
                    'url' => $result['url'],
                    'object_name' => $objectName,
                    'snapshot_url' => $snapshotUrl,
                    'size' => $file->getSize(),
                ]
            ]);
        }

        return response()->json([
            'success' => false,
            'message' => $result['error']
        ], 500);
    }

    /**
     * 获取视频截图
     */
    public function getSnapshot(Request $request): JsonResponse
    {
        $request->validate([
            'object_name' => 'required|string',
            'width' => 'integer|min:100|max:1920',
            'height' => 'integer|min:100|max:1080',
            'time' => 'integer|min:0',
        ]);

        $objectName = $request->input('object_name');
        $width = $request->input('width', 800);
        $height = $request->input('height', 600);
        $time = $request->input('time', 0);

        $snapshotUrl = $this->videoUploader->getVideoSnapshot($objectName, $width, $height, $time);

        return response()->json([
            'success' => true,
            'data' => ['snapshot_url' => $snapshotUrl]
        ]);
    }
}

五、路由配置

5.1 API 路由

在 routes/api.php 中添加：

Route::prefix('video')->group(function () {
    Route::post('upload', [VideoController::class, 'upload']);
    Route::post('snapshot', [VideoController::class, 'getSnapshot']);
});

六、前端调用示例

6.1 JavaScript 上传

// 上传视频
async function uploadVideo(file) {
    const formData = new FormData();
    formData.append('video', file);

    try {
        const response = await fetch('/api/video/upload', {
            method: 'POST',
            body: formData,
            headers: {
                'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').getAttribute('content')
            }
        });

        const result = await response.json();
        
        if (result.success) {
            console.log('上传成功:', result.data);
            // 显示视频和截图
            showVideo(result.data.url, result.data.snapshot_url);
        } else {
            console.error('上传失败:', result.message);
        }
    } catch (error) {
        console.error('上传错误:', error);
    }
}

// 显示视频
function showVideo(videoUrl, snapshotUrl) {
    const videoHtml = `
        
        视频截图
    `;
    document.getElementById('video-container').innerHTML = videoHtml;
}

6.2 带进度条的上传

function uploadVideoWithProgress(file, progressCallback) {
    const formData = new FormData();
    formData.append('video', file);

    const xhr = new XMLHttpRequest();
    
    // 监听上传进度
    xhr.upload.addEventListener('progress', (e) => {
        if (e.lengthComputable) {
            const progress = (e.loaded / e.total) * 100;
            progressCallback(Math.round(progress));
        }
    });

    xhr.addEventListener('load', () => {
        if (xhr.status === 200) {
            const result = JSON.parse(xhr.responseText);
            console.log('上传完成:', result);
        }
    });

    xhr.open('POST', '/api/video/upload');
    xhr.setRequestHeader('X-CSRF-TOKEN', document.querySelector('meta[name="csrf-token"]').getAttribute('content'));
    xhr.send(formData);
}

七、最佳实践

7.1 错误处理

try {
    $result = $this->videoUploader->multipartUpload($filePath, $objectName);
} catch (Exception $e) {
    Log::error('视频上传失败', [
        'file' => $objectName,
        'error' => $e->getMessage(),
        'trace' => $e->getTraceAsString()
    ]);
    
    return response()->json([
        'success' => false,
        'message' => '上传失败，请稍后重试'
    ], 500);
}

7.2 文件验证

public function validateVideoFile($file)
{
    $allowedMimes = ['video/mp4', 'video/avi', 'video/mov', 'video/wmv'];
    $maxSize = 2 * 1024 * 1024 * 1024; // 2GB

    if (!in_array($file->getMimeType(), $allowedMimes)) {
        throw new InvalidArgumentException('不支持的视频格式');
    }

    if ($file->getSize() > $maxSize) {
        throw new InvalidArgumentException('文件大小超过限制');
    }

    return true;
}

7.3 性能优化

  • 分片大小建议 5-10MB
  • 并发上传时控制同时上传的分片数量
  • 使用 CDN 加速访问
  • 对于小文件可以直接使用简单上传

7.4 安全考虑

  • 验证文件类型和大小
  • 使用随机文件名避免冲突
  • 私有 Bucket 使用签名 URL
  • 设置合理的 URL 过期时间

八、常见问题

8.1 上传失败重试

public function uploadWithRetry($filePath, $objectName, $maxRetries = 3)
{
    for ($i = 0; $i < $maxRetries; $i++) {
        $result = $this->multipartUpload($filePath, $objectName);
        
        if ($result['success']) {
            return $result;
        }
        
        if ($i < $maxRetries - 1) {
            sleep(pow(2, $i)); // 指数退避
        }
    }
    
    return $result;
}

8.2 清理未完成的分片上传

public function cleanupIncompleteUploads()
{
    try {
        $listResult = $this->ossClient->listMultipartUploads($this->bucket);
        
        foreach ($listResult->getUploads() as $upload) {
            // 清理超过24小时的未完成上传
            if (time() - strtotime($upload->getInitiated()) > 86400) {
                $this->ossClient->abortMultipartUpload(
                    $this->bucket,
                    $upload->getKey(),
                    $upload->getUploadId()
                );
            }
        }
    } catch (OssException $e) {
        Log::error('清理未完成上传失败: ' . $e->getMessage());
    }
}

你可能感兴趣的:(phplavarel)

  • Nginx 解决api跨域问题 天下皆白_唯我独黑 nginx运维
    环境:nginx1.22.1宝塔8.0phplavarel在nginx里加入下面的设置#这里填*就是任何域名都允许跨域add_headerAccess-Control-Allow-Origin"*";#CORS请求默认不发送Cookie和HTTP认证信息。但是如果要把Cookie发到服务器，要服务器同意，指定#Access-Control-Allow-Credentials字段。add_heade
  • 继之前的线程循环加到窗口中运行 3213213333332132 javathreadJFrameJPanel
    之前写了有关java线程的循环执行和结束，因为想制作成exe文件，想把执行的效果加到窗口上，所以就结合了JFrame和JPanel写了这个程序，这里直接贴出代码，在窗口上运行的效果下面有附图。 package thread; import java.awt.Graphics; import java.text.SimpleDateFormat; import java.util
  • linux 常用命令 BlueSkator linux命令
    1.grep 相信这个命令可以说是大家最常用的命令之一了。尤其是查询生产环境的日志，这个命令绝对是必不可少的。 但之前总是习惯于使用 （grep -n 关键字 文件名 ）查出关键字以及该关键字所在的行数，然后再用 （sed -n  '100,200p' 文件名），去查出该关键字之后的日志内容。 但其实还有更简便的办法，就是用（grep  -B n、-A n、-C n 关键
  • php heredoc原文档和nowdoc语法 dcj3sjt126com PHPheredocnowdoc
    <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>Current To-Do List</title> </head> <body> <?
  • overflow的属性 周华华 JavaScript
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml&q
  • 《我所了解的Java》——总体目录 g21121 java
            准备用一年左右时间写一个系列的文章《我所了解的Java》，目录及内容会不断完善及调整。         在编写相关内容时难免出现笔误、代码无法执行、名词理解错误等，请大家及时指出，我会第一时间更正。    &n
  • [简单]docx4j常用方法小结 53873039oycg docx
            本代码基于docx4j-3.2.0，在office word 2007上测试通过。代码如下:         import java.io.File; import java.io.FileInputStream; import ja
  • Spring配置学习 云端月影 spring配置
    首先来看一个标准的Spring配置文件 applicationContext.xml <?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi=&q
  • Java新手入门的30个基本概念三 aijuans java新手java 入门
    17.Java中的每一个类都是从Object类扩展而来的。　　18.object类中的equal和toString方法。　　equal用于测试一个对象是否同另一个对象相等。　　toString返回一个代表该对象的字符串,几乎每一个类都会重载该方法,以便返回当前状态的正确表示.(toString 方法是一个很重要的方法)　　 19.通用编程:任何类类型的所有值都可以同object类性的变量来代替。　
  • 《2008 IBM Rational 软件开发高峰论坛会议》小记 antonyup_2006 软件测试敏捷开发项目管理IBM活动
    我一直想写些总结,用于交流和备忘,然都没提笔,今以一篇参加活动的感受小记开个头,呵呵! 其实参加《2008 IBM Rational 软件开发高峰论坛会议》是9月4号,那天刚好调休.但接着项目颇为忙,所以今天在中秋佳节的假期里整理了下. 参加这次活动是一个朋友给的一个邀请书,才知道有这样的一个活动,虽然现在项目暂时没用到IBM的解决方案,但觉的参与这样一个活动可以拓宽下视野和相关知识.
  • PL/SQL的过程编程,异常,声明变量,PL/SQL块 百合不是茶 PL/SQL的过程编程异常PL/SQL块声明变量
    PL/SQL;    过程; 符号; 变量; PL/SQL块; 输出; 异常;     PL/SQL 是过程语言(Procedural Language)与结构化查询语言(SQL)结合而成的编程语言PL/SQL 是对 SQL 的扩展,sql的执行时每次都要写操作
  • Mockito(三)--完整功能介绍 bijian1013 持续集成mockito单元测试
            mockito官网：http://code.google.com/p/mockito/，打开documentation可以看到官方最新的文档资料。 一.使用mockito验证行为 //首先要import Mockito import static org.mockito.Mockito.*; //mo
  • 精通Oracle10编程SQL(8)使用复合数据类型 bijian1013 oracle数据库plsql
    /* *使用复合数据类型 */ --PL/SQL记录 --定义PL/SQL记录 --自定义PL/SQL记录 DECLARE TYPE emp_record_type IS RECORD( name emp.ename%TYPE, salary emp.sal%TYPE, dno emp.deptno%TYPE ); emp_
  • 【Linux常用命令一】grep命令 bit1129 Linux常用命令
    grep命令格式   grep [option] pattern [file-list]     grep命令用于在指定的文件(一个或者多个,file-list)中查找包含模式串(pattern)的行,[option]用于控制grep命令的查找方式。   pattern可以是普通字符串，也可以是正则表达式，当查找的字符串包含正则表达式字符或者特
  • mybatis3入门学习笔记 白糖_ sqlibatisqqjdbc配置管理
    MyBatis 的前身就是iBatis，是一个数据持久层(ORM)框架。  MyBatis 是支持普通 SQL 查询，存储过程和高级映射的优秀持久层框架。MyBatis对JDBC进行了一次很浅的封装。   以前也学过iBatis，因为MyBatis是iBatis的升级版本，最初以为改动应该不大，实际结果是MyBatis对配置文件进行了一些大的改动，使整个框架更加方便人性化。
  • Linux 命令神器：lsof 入门 ronin47 lsof
           lsof是系统管理/安全的尤伯工具。我大多数时候用它来从系统获得与网络连接相关的信息，但那只是这个强大而又鲜为人知的应用的第一步。将这个工具称之为lsof真实名副其实，因为它是指“列出打开文件（lists openfiles）”。而有一点要切记，在Unix中一切（包括网络套接口）都是文件。 有趣的是，lsof也是有着最多
  • java实现两个大数相加，可能存在溢出。 bylijinnan java实现
    import java.math.BigInteger; import java.util.regex.Matcher; import java.util.regex.Pattern; public class BigIntegerAddition { /** * 题目：java实现两个大数相加，可能存在溢出。 * 如123456789 + 987654321
  • Kettle学习资料分享，附大神用Kettle的一套流程完成对整个数据库迁移方法 Kai_Ge Kettle
    Kettle学习资料分享   Kettle 3.2 使用说明书 目录 概述..........................................................................................................................................7 1.Kettle 资源库管
  • [货币与金融]钢之炼金术士 comsci 金融
           自古以来,都有一些人在从事炼金术的工作.........但是很少有成功的        那么随着人类在理论物理和工程物理上面取得的一些突破性进展......        炼金术这个古老
  • Toast原来也可以多样化 dai_lm androidtoast
    Style 1： 默认 Toast def = Toast.makeText(this, "default", Toast.LENGTH_SHORT); def.show(); Style 2： 顶部显示 Toast top = Toast.makeText(this, "top", Toast.LENGTH_SHORT); t
  • java数据计算的几种解决方法3 datamachine javahadoopibatisr-languer
    4、iBatis     简单敏捷因此强大的数据计算层。和Hibernate不同，它鼓励写SQL，所以学习成本最低。同时它用最小的代价实现了计算脚本和JAVA代码的解耦，只用20%的代价就实现了hibernate 80%的功能,没实现的20%是计算脚本和数据库的解耦。     复杂计算环境是它的弱项，比如：分布式计算、复杂计算、非数据
  • 向网页中插入透明Flash的方法和技巧 dcj3sjt126com htmlWebFlash
    将 Flash 作品插入网页的时候，我们有时候会需要将它设为透明，有时候我们需要在Flash的背面插入一些漂亮的图片，搭配出漂亮的效果……下面我们介绍一些将Flash插入网页中的一些透明的设置技巧。 　　一、Swf透明、无坐标控制　　首先教大家最简单的插入Flash的代码，透明，无坐标控制： 　　注意wmode="transparent"是控制Flash是否透明
  • ios UICollectionView的使用 dcj3sjt126com
    UICollectionView的使用有两种方法，一种是继承UICollectionViewController，这个Controller会自带一个UICollectionView；另外一种是作为一个视图放在普通的UIViewController里面。 个人更喜欢第二种。下面采用第二种方式简单介绍一下UICollectionView的使用。 1.UIViewController实现委托，代码如
  • Eos平台java公共逻辑 蕃薯耀 Eos平台java公共逻辑Eos平台java公共逻辑
     Eos平台java公共逻辑 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 蕃薯耀 2015年6月1日 17:20:4
  • SpringMVC4零配置--Web上下文配置【MvcConfig】 hanqunfeng springmvc4
    与SpringSecurity的配置类似，spring同样为我们提供了一个实现类WebMvcConfigurationSupport和一个注解@EnableWebMvc以帮助我们减少bean的声明。   applicationContext-MvcConfig.xml <!-- 启用注解，并定义组件查找规则 ，mvc层只负责扫描@Controller --> <
  • 解决ie和其他浏览器poi下载excel文件名乱码 jackyrong Excel
       使用poi,做传统的excel导出，然后想在浏览器中，让用户选择另存为，保存用户下载的xls文件，这个时候，可能的是在ie下出现乱码（ie,9,10,11),但在firefox,chrome下没乱码， 因此必须综合判断，编写一个工具类：      /** * * @Title: pro
  • 挥洒泪水的青春 lampcy 编程生活程序员
    2015年2月28日，我辞职了，离开了相处一年的触控，转过身--挥洒掉泪水，毅然来到了兄弟连，背负着许多的不解、质疑——”你一个零基础、脑子又不聪明的人，还敢跨行业，选择Unity3D？“，”真是不自量力••••••“，”真是初生牛犊不怕虎•••••“，••••••我只是淡淡一笑，拎着行李----坐上了通向挥洒泪水的青春之地——兄弟连！ 这就是我青春的分割线，不后悔，只会去用泪水浇灌——已经来到
  • 稳增长之中国股市两点意见-----严控做空，建立涨跌停版停牌重组机制 nannan408
       对于股市，我们国家的监管还是有点拼的，但始终拼不过飞流直下的恐慌，为什么呢？    笔者首先支持股市的监管。对于股市越管越荡的现象，笔者认为首先是做空力量超过了股市自身的升力，并且对于跌停停牌重组的快速反应还没建立好，上市公司对于股价下跌没有很好的利好支撑。    我们来看美国和香港是怎么应对股灾的。美国是靠禁止重要股票做空，在
  • 动态设置iframe高度(iframe高度自适应) Rainbow702 JavaScriptiframecontentDocument高度自适应局部刷新
    如果需要对画面中的部分区域作局部刷新，大家可能都会想到使用ajax。 但有些情况下，须使用在页面中嵌入一个iframe来作局部刷新。 对于使用iframe的情况，发现有一个问题，就是iframe中的页面的高度可能会很高，但是外面页面并不会被iframe内部页面给撑开，如下面的结构： <div id="content"> <div id=&quo
  • 用Rapael做图表 tntxia rap
    function drawReport(paper,attr,data){          var width = attr.width;     var height = attr.height;          var max = 0;   &nbs
  • HTML5 bootstrap2网页兼容（支持IE10以下） xiaoluode html5bootstrap
    <!DOCTYPE html> <html> <head lang="zh-CN"> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge">
按字母分类： ABCDEFGHIJKLMNOPQRSTUVWXYZ其他