PHP에서 TUS 프로토콜을 사용하여 대용량 파일의 중단점 재개 업로드 구현

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

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

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

PHP에서는 tus 프로토콜의 중단점 재개 기능을 사용하여 이 문제를 해결할 수 있습니다. 투스는 무엇입니까? 업로드 재개는 사용자에 의해 중단되거나 네트워크 또는 기타 이유로 예기치 않게 업로드가 중단된 경우에도 다시 시작하지 않고 중단된 위치부터 업로드를 재개할 수 있음을 의미합니다.

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

tus를 사용하는 이유는 무엇입니까?

Vimeo 블로그 인용:

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

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

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

시작

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

$ composer require ankitpokhrel/tus-php

tus-php

은 서버와 클라이언트 간의 상호 작용을 완벽하게 구현하는 tus 중단점 재개 프로토콜 v1.0.0에 사용되는 순수 PHP 프레임워크입니다.

업데이트: 이제 Vimeo v3 공식 PHP 라이브러리

는

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를 전달합니다. tus 터미널에 액세스하려면

RESTful 스타일을 기반으로 하는 엔드포인트 구성:

# 获取有关服务器目前配置的信息\
OPTIONS /files
# 检查上传的文件是否合法\
HEAD /files/{upload-key}
# 创建\
POST /files
# 修改\
PATCH /files/{upload-key}
# 删除\
DELETE /files/{upload-key}

View

프로토콜 세부 정보 # 🎜🎜# 라우팅에 대한 자세한 정보를 알아보세요.

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 클라이언트 개체 만들기

// 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 .parts에 파일 업로드

#🎜 🎜#

// $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]
})

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

分块上传

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

使用 tus-php 实现分块上传

tus-partial-upload.php

<?php
// 文件唯一标识码
$uploadKey = uniqid();
$client->setKey($uploadKey)->file(&#39;/path/to/file&#39;, &#39;chunk_a.ext&#39;);
// 从第 1000  个字节开始上传 10000 字节
$bytesUploaded = $client->seek(1000)->upload(10000);
$chunkAkey     = $client->getKey();
// 从 第 0 个字节开始上传 10000 字节
$bytesUploaded = $client->setFileName(&#39;chunk_b.ext&#39;)->seek(0)->upload(1000);
$chunkBkey     = $client->getKey();
// 从第 11000 个字节  (10000 +  1000) 开始上传剩余的字节
$bytesUploaded = $client->setFileName(&#39;chunk_c.ext&#39;)->seek(11000)->upload();
$chunkCkey     = $client->getKey();
// 把分块上传的文件组合起来
$client->setFileName(&#39;actual_file.ext&#39;)->concat($uploadKey, $chunkAkey, $chunkBkey, $chunkCkey);

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

总结

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

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