ZipStream PHP

ZipStream-PHP

불안정한 가지

main 지점이 안정적이지 않습니다. 안정적인 버전은 릴리스를 참조하세요.

개요

빠르고 간단한 PHP용 스트리밍 zip 파일 다운로더. 이 라이브러리를 사용하면 Zip을 디스크에 쓸 필요가 없습니다. 사용자에게 직접 보낼 수 있어 훨씬 빠릅니다. S3 버킷 또는 모든 PSR7 Stream에서 작동할 수 있습니다.

라이선스 및 보증 정보는 LICENSE 파일을 참조하세요.

설치

Composer를 사용하여 프로젝트의 종속성을 관리하는 경우 프로젝트의 composer.json 파일에 maennchen/zipstream-php에 대한 종속성을 추가하기만 하면 됩니다. 다음 명령을 사용하여 프로젝트의 종속성에 패키지를 추가합니다.

composer require maennchen/zipstream-php

용법

자세한 지침은 설명서를 확인하세요.

 // Autoload the dependencies
require ' vendor/autoload.php ' ;

// create a new zipstream object
$ zip = new ZipStream  ZipStream (
    outputName: ' example.zip ' ,

    // enable output of HTTP headers
    sendHttpHeaders: true ,
);

// create a file named 'hello.txt'
$ zip -> addFile (
    fileName: ' hello.txt ' ,
    data: ' This is the contents of hello.txt ' ,
);

// add a file named 'some_image.jpg' from a local file 'path/to/image.jpg'
$ zip -> addFileFromPath (
    fileName: ' some_image.jpg ' ,
    path: ' path/to/image.jpg ' ,
);

// finish the zip stream
$ zip -> finish ();

버전 3.0.0으로 업그레이드

일반적인

• 최소 PHP 버전: 8.1
• 64비트 아키텍처만 지원됩니다.
• ZipStreamOptionMethod 클래스는 Enum ZipStreamCompressionMethod 로 대체되었습니다.
• 대부분의 클래스는 @internal 로 플래그가 지정되어 있으므로 외부에서 사용하면 안 됩니다. 내부 리소스를 사용하여 이 라이브러리를 확장하는 경우 깨끗한 인터페이스를 추가하고 게시할 수 있도록 이슈를 열어주세요. 외부에서 사용 가능한 클래스 및 열거형은 다음과 같습니다.
  • ZipStreamCompressionMethod
  • ZipStreamException*
  • ZipStreamZipStream

아카이브 옵션

• ZipStreamOptionArchive 클래스는 ZipStreamZipStream 생성자의 명명된 인수로 대체되었습니다.
• 아카이브 옵션 largeFileSize 및 largeFileMethod 제거되었습니다. 파일 크기에 따라 다른 compressionMethods 원하는 경우 이를 직접 구현해야 합니다.
• 아카이브 옵션 httpHeaderCallback 유형을 callable 에서 Closure 로 변경했습니다.
• 아카이브 옵션 zeroHeader defaultEnableZeroHeader 옵션으로 대체되었으며 모든 파일에 대해 재정의될 수 있습니다. 기본값이 false 에서 true 로 변경되었습니다.
• 라이브러리가 더 이상 이런 방식으로 파일 크기를 확인하지 않기 때문에 아카이브 옵션 statFiles 제거되었습니다.
• 아카이브 옵션 deflateLevel defaultDeflateLevel 옵션으로 대체되었으며 모든 파일에 대해 재정의될 수 있습니다.
• ZipStreamZipStream 생성자의 첫 번째 인수( name )는 명명된 인수 outputName 으로 대체되었습니다.
• 이제 outputName 이 비어 있는 경우에도 헤더가 전송됩니다. http 헤더를 자동으로 보내지 않으려면 sendHttpHeaders false 로 설정하세요.

파일 옵션

• ZipStreamOptionFile 클래스는 ZipStreamZipStream->addFile* 함수의 명명된 인수를 대신하여 대체되었습니다.
• 파일 옵션 method 이름이 compressionMethod 으로 변경되었습니다.
• 파일 옵션 time 이름이 lastModificationDateTime 으로 변경되었습니다.
• 파일 옵션 size 이름이 maxSize 로 변경되었습니다.

버전 2.0.0으로 업그레이드

https://github.com/maennchen/ZipStream-PHP/tree/2.0.0#upgrade-to-version-200

버전 1.0.0으로 업그레이드

https://github.com/maennchen/ZipStream-PHP/tree/2.0.0#upgrade-to-version-100

기여

ZipStream-PHP는 공동 프로젝트입니다. .github/CONTRIBUTING.md 파일을 살펴보세요.

버전 지원

아래 표에 따라 버전이 지원됩니다.

현재 버전 지원 상태와 모순되는 풀 요청을 열지 마십시오.

주의: 항상 최신 정보를 보려면 main 의 README 확인하세요.

버전	새로운 기능	버그수정	보안
3
2
1
0

이 라이브러리는 PHP 핵심 지원에 맞춰져 있습니다. 새로운 기능과 버그 수정은 현재 상태에 따라 PHP 버전만을 대상으로 합니다.

참조: https://www.php.net/supported-versions.php

저자 소개

• 폴 던컨 [email protected] - https://pablotron.org/
• 요나탄 맨첸 [email protected] - https://maennchen.dev
• 제시 G. 도나트 [email protected] - https://donatstudios.com
• 니콜라스 CARPi [email protected] - https://www.deltablot.com
• 닉 바햄 [email protected] - https://www.brokencube.co.uk