README

This package provides Bzip2 compression support for the Pinimize compression and archive package for Laravel.

Requirements

PHP 8.2 or higher
Laravel 11 or higher
The ext-bz2 PHP extension must be installed and enabled

Installation

First, ensure that the Bzip2 PHP extension is installed. You can check this by running:

php -m | grep bz2

If you don't see 'bz2' in the output, you'll need to install the extension before proceeding.

Once the Bzip2 extension is installed, you can install the package via composer:

composer require pinimize/laravel-bz2-compresssion

Prerequisites

This package is an extension of the Pinimize Compression and Archive package. The main Pinimize package will be automatically installed as a dependency for this package.

Configuration

After installation, you need to add the Bzip2 driver configuration to your config/pinimize.php file. If you haven't published th main config file, you can do so by running this command:

php artisan vendor:publish --provider="Pinimize\PinimizeServiceProvider" --tag="config"

Add the following to the drivers array:

'bz2' => [
    'disk' => env('COMPRESSION_DISK', null),
],

Your complete compression configuration should look something like this:

'compression' => [
    'default' => env('COMPRESSION_DRIVER', 'gzip'),
    'mixin' => env('COMPRESSION_REGISTER_MIXIN', true),
    'drivers' => [
        ... // Other drivers
        'bz2' => [
            'disk' => env('COMPRESSION_DISK', null),
        ],
    ],
],

Usage

Once configured, you can use the Bzip2 driver just like any other compression driver in Pinimize. All methods available in the main Pinimize package are fully supported with the Bzip2 driver. For example:

use Illuminate\Support\Str;
use Illuminate\Support\Facades\Storage;
use Pinimize\Facades\Compression;
use Pinimize\Facades\Decompression;

// When you have made bz2 the default driver in your configuration:
$compressedStringZlib = Str::compress($originalString);
$decompressedStringGzip = Str::decompress($compressedStringGzip);

// By specifying the driver:
$compressedStringZlib = Str::compress($originalString, 'bz2');
$decompressedStringGzip = Str::decompress($compressedStringGzip, 'bz2');

// Or with the Storage facade:
Storage::compress('/path/to/original.json', '/path/to/compressed.json.bz2');
Storage::decompress('/path/to/compressed.json.bz2', '/path/to/decompressed.json');

// Compress a string using Bzip2
$compressed = Compression::driver('bz2')->string('Hello, World!');

// Default driver
$compressed = Compression::string('Hello, World!');
Compression::put('path/to/compressed.csv.bz2', '/path/to/original.csv');

For more detailed usage instructions and a full list of available methods, please refer to the Pinimize Compression and Archive documentation.

Important Notes

The Bzip2 compression algorithm does not support compression levels. The level parameter in the configuration is ignored for the Bzip2 driver.
The Bzip2 extension must be installed on your server for this package to work. If you're using a managed hosting service, you may need to contact your hosting provider to have it installed.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Testing

Run the tests with:

composer test

pinimize / laravel-bz2-compresssion

Maintainers

Details