2017 © Pedro Peláez
 

library zipstream-php

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

image

maennchen/zipstream-php

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  • Monday, April 2, 2018
  • by donatj
  • Repository
  • 24 Watchers
  • 281 Stars
  • 780,086 Installations
  • PHP
  • 18 Dependents
  • 0 Suggesters
  • 33 Forks
  • 7 Open issues
  • 13 Versions
  • 20 % Grown

The README.md

ZipStream-PHP

Main Branch Coverage Status Latest Stable Version Total Downloads OpenSSF Best Practices OpenSSF Scorecard, (*1)

Unstable Branch

The main branch is not stable. Please see the releases for a stable version., (*2)

Overview

A fast and simple streaming zip file downloader for PHP. Using this library will save you from having to write the Zip to disk. You can directly send it to the user, which is much faster. It can work with S3 buckets or any PSR7 Stream., (*3)

Please see the LICENSE file for licensing and warranty information., (*4)

Installation

Simply add a dependency on maennchen/zipstream-php to your project's composer.json file if you use Composer to manage the dependencies of your project. Use following command to add the package to your project's dependencies:, (*5)

composer require maennchen/zipstream-php

Usage

For detailed instructions, please check the Documentation., (*6)

// 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();

Upgrade to version 3.0.0

General

  • Minimum PHP Version: 8.1
  • Only 64bit Architecture is supported.
  • The class ZipStream\Option\Method has been replaced with the enum ZipStream\CompressionMethod.
  • Most clases have been flagged as @internal and should not be used from the outside. If you're using internal resources to extend this library, please open an issue so that a clean interface can be added & published. The externally available classes & enums are:
    • ZipStream\CompressionMethod
    • ZipStream\Exception*
    • ZipStream\ZipStream

Archive Options

  • The class ZipStream\Option\Archive has been replaced in favor of named arguments in the ZipStream\ZipStream constuctor.
  • The archive options largeFileSize & largeFileMethod has been removed. If you want different compressionMethods based on the file size, you'll have to implement this yourself.
  • The archive option httpHeaderCallback changed the type from callable to Closure.
  • The archive option zeroHeader has been replaced with the option defaultEnableZeroHeader and can be overridden for every file. Its default value changed from false to true.
  • The archive option statFiles was removed since the library no longer checks filesizes this way.
  • The archive option deflateLevel has been replaced with the option defaultDeflateLevel and can be overridden for every file.
  • The first argument (name) of the ZipStream\ZipStream constuctor has been replaced with the named argument outputName.
  • Headers are now also sent if the outputName is empty. If you do not want to automatically send http headers, set sendHttpHeaders to false.

File Options

  • The class ZipStream\Option\File has been replaced in favor of named arguments in the ZipStream\ZipStream->addFile* functions.
  • The file option method has been renamed to compressionMethod.
  • The file option time has been renamed to lastModificationDateTime.
  • The file option size has been renamed to maxSize.

Upgrade to version 2.0.0

https://github.com/maennchen/ZipStream-PHP/tree/2.0.0#upgrade-to-version-200, (*7)

Upgrade to version 1.0.0

https://github.com/maennchen/ZipStream-PHP/tree/2.0.0#upgrade-to-version-100, (*8)

Contributing

ZipStream-PHP is a collaborative project. Please take a look at the .github/CONTRIBUTING.md file., (*9)

Version Support

Versions are supported according to the table below., (*10)

Please do not open any pull requests contradicting the current version support status., (*11)

Careful: Always check the README on main for up-to-date information., (*12)

Version New Features Bugfixes Security
3 ✓ ✓ ✓
2 ✗ ✗ ✓
1 ✗ ✗ ✗
0 ✗ ✗ ✗

This library aligns itself with the PHP core support. New features and bugfixes will only target PHP versions according to their current status., (*13)

See: https://www.php.net/supported-versions.php, (*14)

About the Authors

The Versions

02/04 2018

dev-master

9999999-dev

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan
by András Kolesár

zip stream

02/04 2018

dev-ci

dev-ci

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan
by András Kolesár

zip stream

02/04 2018

v1.0.0-alpha.1

1.0.0.0-alpha1

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan
by András Kolesár

zip stream

09/02 2018

v0.5.2

0.5.2.0

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

  • php >= 7.0
  • ext-mbstring *

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan

zip stream

18/12 2017

v0.5.1

0.5.1.0

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

  • php >= 7.0
  • ext-mbstring *

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan

zip stream

28/08 2017

v0.5.0

0.5.0.0

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

  • php >= 7.0
  • ext-mbstring *

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan

zip stream

13/09 2016

v0.4.1

0.4.1.0

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

  • php >= 5.6
  • ext-mbstring *

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan

zip stream

13/09 2016

v0.4.0

0.4.0.0

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

  • php >= 5.3
  • ext-mbstring *

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan

zip stream

26/07 2016

dev-featrure/refactor_whole_library

dev-featrure/refactor_whole_library

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

  • php >= 7.0
  • ext-mbstring *

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan

zip stream

29/02 2016

dev-develop

dev-develop

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

  • php >= 5.3
  • ext-mbstring *

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan

zip stream

27/02 2016

0.3.1

0.3.1.0

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

  • php >= 5.3
  • ext-mbstring *

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan

zip stream

15/01 2015

0.3.0

0.3.0.0

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

MIT

The Requires

  • php >= 5.3

 

The Development Requires

by Jesse Donat
by Jonatan Männchen
by Paul Duncan

zip stream

13/11 2013

0.2.2

0.2.2.0

ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.

  Sources   Download

All rights reserved

The Requires

  • php >= 5.3

 

by Paul Duncan

zip stream