【관련 학습 권장 사항: php 그래픽 튜토리얼】
현대 웹사이트 애플리케이션에서는 파일 업로드가 매우 일반적입니다. 어떤 언어에서든 일부 도구를 사용하면 파일 업로드 기능을 구현할 수 있습니다. 그러나 대용량 파일을 업로드해야 하는 필요성을 처리하는 것은 여전히 약간 번거롭습니다.
이 시점에서 대용량 파일을 업로드 중이라고 가정해 보겠습니다. 약 1시간이 지났으며 진행률은 90%입니다. 갑자기 인터넷 연결이 끊기거나 브라우저가 충돌하면 업로드된 프로그램이 종료되고 처음부터 다시 시작해야 합니다. 정말 불편하지 않나요? 더욱 실망스러운 점은 인터넷 속도가 매우 느리면 몇 번을 다시 시도해도 업로드에 성공할 수 없다는 것입니다.
PHP에서는 이 문제를 해결하기 위해 tus 프로토콜의 중단점 재개 기능을 사용해 볼 수 있습니다.
tus란 무엇인가요?
tus를 사용하는 이유?
이 방법으로 업로드하는 또 다른 이점은 노트북에서 파일 업로드를 시작한 다음 휴대폰이나 다른 장치로 이동하여 동일한 파일을 계속 업로드할 수 있어 사용자 경험을 크게 향상시킬 수 있다는 것입니다.
사진: Tus 대략적인 작업 흐름
Start
$ composer require ankitpokhrel/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 클라이언트를 사용하여 업로드 처리
<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 client
$client = new \TusPhp\Tus\Client('http://server.tus.local');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 协议的团队还开发了一个模块化的文件上传插件 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 중국어 웹사이트의 기타 관련 기사를 참조하세요!
![[웹 프런트엔드] Node.js 빠른 시작](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
