대용량 파일의 중단점 재개 업로드를 달성하기 위해 PHP에서 TUS 프로토콜을 사용하는 방법

【관련 학습 권장 사항: php 그래픽 튜토리얼】

                                                        文 대용량 파일 업로드가 걱정되셨나요? 어떤 이유로 파일 업로드 프로세스가 중단된 경우 전체 파일을 다시 업로드하지 않고 중단된 지점부터 계속 업로드할 수 있나요? 혼란스러우시다면 아래 내용을 계속 읽어보시기 바랍니다.

현대 웹사이트 애플리케이션에서는 파일 업로드가 매우 일반적입니다. 어떤 언어에서든 일부 도구를 사용하면 파일 업로드 기능을 구현할 수 있습니다. 그러나 대용량 파일을 업로드해야 하는 필요성을 처리하는 것은 여전히 ​​약간 번거롭습니다.

이 시점에서 대용량 파일을 업로드 중이라고 가정해 보겠습니다. 약 1시간이 지났으며 진행률은 90%입니다. 갑자기 인터넷 연결이 끊기거나 브라우저가 충돌하면 업로드된 프로그램이 종료되고 처음부터 다시 시작해야 합니다. 정말 불편하지 않나요? 더욱 실망스러운 점은 인터넷 속도가 매우 느리면 몇 번을 다시 시도해도 업로드에 성공할 수 없다는 것입니다.

PHP에서는 이 문제를 해결하기 위해 tus 프로토콜의 중단점 재개 기능을 사용해 볼 수 있습니다.

tus란 무엇인가요?

Tus는 HTTP 기반의 파일 재개를 위한 개방형 프로토콜입니다. 업로드 재개는 사용자에 의해 중단되거나 네트워크 또는 기타 이유로 예기치 않게 업로드가 중단된 경우에도 다시 시작하지 않고 중단된 위치부터 업로드를 재개할 수 있음을 의미합니다.

Tus 프로토콜은 2017년 5월 Vimeo에 채택되었습니다.

tus를 사용하는 이유?

Vimeo 블로그 인용:

우리가 tus를 사용하기로 결정한 이유는 파일 업로드 프로세스를 간결하고 개방적인 형식으로 표준화할 수 있기 때문입니다. 이러한 표준화는 API 개발자가 파일 업로드 프로세스보다는 애플리케이션 자체의 논리에 더 집중하는 데 도움이 됩니다.

이 방법으로 업로드하는 또 다른 이점은 노트북에서 파일 업로드를 시작한 다음 휴대폰이나 다른 장치로 이동하여 동일한 파일을 계속 업로드할 수 있어 사용자 경험을 크게 향상시킬 수 있다는 것입니다.

사진: Tus 대략적인 작업 흐름

Start

첫 번째 단계는 종속성을 로드하는 것입니다.

$ composer require ankitpokhrel/tus-php

tus-php

는 tus 이력서 프로토콜 v1.0.0을 위한 순수 PHP 프레임워크로, 서버와 클라이언트 간의 상호 작용을 완벽하게 구현합니다.

Update

: Vimeo 공식 PHP 라이브러리 v3에서는 이제 TusPHP를 사용합니다.

요청을 처리할 서버 만들기

다음과 같이 서버를 만들 수 있습니다.

// server.php

$server   = new \TusPhp\Tus\Server('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.를 통해 액세스할 수 있습니다. RESTful 스타일 엔드포인트 구성:

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

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

# 创建\
POST /files

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

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

라우팅에 대한 자세한 내용은 프로토콜 세부정보를 참조하세요.

Laravel과 유사한 프레임워크를 사용하는 경우 구성 파일에서 이를 정의할 필요가 없으며 tus의 기본 엔드포인트에 액세스하기 위한 경로를 직접 정의할 수 있습니다. 관련 내용은 다른 튜토리얼에서 소개하겠습니다.

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>

양식을 제출한 후 업로드를 처리하려면 몇 가지 단계를 따라야 합니다.

tus-php 클라이언트 객체 만들기

1. // Tus client
   
   $client = new \TusPhp\Tus\Client('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);

모든 파일이 업로드된 후 기본적으로 서버는

를 사용하여 파일 합계를 확인하여 누락된 파일이 없는지 확인합니다.

使用 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]
})

更多细节可以查看 uppy 的文档， 这里 还有些例子可以供你参考。

分块上传

tus-php 服务器支持 concatenation 扩展，可以把多次上传的文件合为一个文件。因此，我们可以在客户端支持并行上传以及非连续的分块文件上传。

使用 tus-php 实现分块上传

tus-partial-upload.php

<?php

// 文件唯一标识码
$uploadKey = uniqid();

$client->setKey($uploadKey)->file('/path/to/file', 'chunk_a.ext');

// 从第 1000  个字节开始上传 10000 字节
$bytesUploaded = $client->seek(1000)->upload(10000);
$chunkAkey     = $client->getKey();

// 从 第 0 个字节开始上传 10000 字节
$bytesUploaded = $client->setFileName('chunk_b.ext')->seek(0)->upload(1000);
$chunkBkey     = $client->getKey();

// 从第 11000 个字节  (10000 +  1000) 开始上传剩余的字节
$bytesUploaded = $client->setFileName('chunk_c.ext')->seek(11000)->upload();
$chunkCkey     = $client->getKey();

// 把分块上传的文件组合起来
$client->setFileName('actual_file.ext')->concat($uploadKey, $chunkAkey, $chunkBkey, $chunkCkey);

分块上传的完整例子 在这里.

总结

由于 tus-php 项目 本身还出于初级阶段，后面可能还会有一些改动。在 example 文件夹里，有三个不同的例子供你参考。如果任何问题或者建议，欢迎留言交流。

Happy Coding!

相关学习推荐：php编程（视频）

위 내용은 대용량 파일의 중단점 재개 업로드를 달성하기 위해 PHP에서 TUS 프로토콜을 사용하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!