PHP中如何使用TUS协议来实现大文件的断点续传

【相关学习推荐：php图文教程】

你是否曾经为大文件上传而苦恼？如果文件上传的过程中，因为某种原因中断了，是否可以从中断的位置继续上传，而不用重新上传整个文件？如果你有这样的困惑，那么请继续阅读下面的内容。

在现代网站应用中，上传文件是非常常见的。在任何语言中，通过使用一些工具，都可以实现文件上传的功能。但是，如果处理大文件上传的需求，还是有点麻烦的。

假如你此时正在上传一个很大的文件，大约一个小时过去了，进度是 90%。突然断网了或者浏览器崩溃了，上传的程序退出，你要再全部重新来过。真的很不爽，对不对？还有更让人郁闷的是，如果你的网速很慢，那么，无论你重来多少次，你都不可能上传成功。

在 PHP 中，我们可以尝试利用 tus 协议的断点续传功能来解决这个问题。

什么是 tus?

Tus 是一个基于 HTTP 的 文件断点续传开放协议。 断点续传的意思是不管是用户自行中断，还是由于网络等原因的意外中断，都可以从中断的地方继续上传，而不用重新开始。

为什么用 tus?

引用 Vimeo 的博客:

使用这种方式上传的另一个好处是，你可以在笔记本上开始上传文件，然后又转到手机或者其他设备继续上传同一个文件，这可以极大地提升用户体验。

图片: Tus 大致的工作流程

开始

第一步，加载依赖。

$ composer require ankitpokhrel/tus-php

tus-php 是用于 tus 断点续传协议 v1.0.0 的一个的纯 PHP 框架，完美实现了 服务端与客户端的交互 。

创建一个处理请求的服务端

你可以像下面这样创建一个服务端.

// server.php

$server   = new TusPhpTusServer('redis');
$response = $server->serve();

$response->send();

exit(0); // 退出当前 PHP 进程

你需要配置你的服务器以便能对特定的终端进行响应. 如果使用 Nginx 的话你可以像下面这样配置:

# nginx.conf

location /files {
    try_files $uri $uri/ /path/to/server.php?$query_string;
}

假设我们服务端的 URL 是 http://server.tus.local. 因此, 基于我们上面的 Nginx 配置，我们可以通过 http://server.tus.local/files. 来访问到我们的 tus 终端.

基于 RESTful 风格的端点配置:

# 获取有关服务器目前配置的信息
OPTIONS /files

# 检查上传的文件是否合法
HEAD /files/{upload-key}

# 创建
POST /files

# 修改
PATCH /files/{upload-key}

# 删除
DELETE /files/{upload-key}

查看 协议细则 获取更多关于路由的信息。

使用 tus-php 客户端处理上传

服务器到位后，客户端可以块的形式上传文件。 让我们首先创建一个简单的HTML表单来获取用户的输入。

<form action="upload.php" method="post" enctype="multipart/form-data">
    <input type="file" name="tus_file" id="tus-file" />
    <input type="submit" value="Upload" />
</form>

提交表单后，我们需要按照几个步骤来处理上传。

1. 创建一个 tus-php 客户端对象

// Tus client

$client = new TusPhpTusClient('http://server.tus.local');

上面代码中的第一个参数是你的tus服务器地址。

2. 使用文件元数据初始化客户端

为了确保上传文件的唯一性，我们需要给每个上传的文件以唯一标识。这样在文件中断后续传的时候，服务器就可以很清晰地辨识出，哪几个片段是属于同一个文件得。这个标识码可以自己指定，也可以由系统生成。

// 设置标识码和文件元数据

$client->setKey($uploadKey)
    ->file($_FILES['tus_file']['tmp_name'], 'your file name');

如果不想指定标识码，可以这样写，由系统会自动生成：

$client->file($_FILES['tus_file']['tmp_name'], 'your file name');

$uploadKey = $client->getKey(); // Unique upload key

3. 分块上传文件

// $chunkSize 是以字节为单位的，例如 5000000 等于 5 MB

$bytesUploaded = $client->upload($chunkSize);

当你想要续传下一块的时候，就可以带上同样的标识码参数来续传。

// 在下一个请求中续传文件

$bytesUploaded = $client->setKey($uploadKey)->upload($chunkSize);

文件全部上传完成后，默认情况下，服务器会使用 sha256 来校验文件总和，以确保不会有丢失的文件。

使用 tus-js-client 客户端处理文件上传

tus 协议的团队还开发了一个模块化的文件上传插件 Uppy。这个插件可以在官方 tus-js-client 和 tus-php 服务器之间建立连接。也就是说我们可以使用 php 配合 js 来实现文件上传了。

uppy.use(Tus, {
  endpoint: 'https://server.tus.local/files/', // 你的 tus 服务器
  resume: true,
  autoRetry: true,
  retryDelays: [0, 1000, 3000, 5000]
})

最后

以上就是冷艳康乃馨为你收集整理的PHP中如何使用TUS协议来实现大文件的断点续传的全部内容，希望文章能够帮你解决PHP中如何使用TUS协议来实现大文件的断点续传所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。

本图文内容来源于网友提供，作为学习参考使用，或来自网络收集整理，版权属于原作者所有。