tzsk/collage

Generate Image Collage with Laravel 5

:gift: PHP Collage Maker

, _(*1)

, _(*2)

Create Image Collage with ease now with PHP. This package uses intervention/image package to leverage image manipulation., _(*3)

Using this package is very easy and creating Beautiful Collages are not tough anymore., _(*4)

NOTE: Currently this package only supports 4 images. You can write your own generator to add 5 if you like., _(*5)

:package: Installation

This is a composer package. So just run the below composer command inside your project directory to get it installed., _(*6)

composer require tzsk/collage

:gear: Configure

If you are using this package outside laravel then you don't need to do this step., _(*7)

config/app.php

This package supports Package Auto-Discovery. And the latest version only supports Laravel >= 7.x, _(*8)

If you want to use any other driver besides 'gd' then you have to publish the configuration file:, _(*9)

php artisan collage:publish

You will then have a file in your config directory: config/collage.php, _(*10)

If you are using 'imagick' then you can change it., _(*11)

:fire: Usage

First you need to have a set of images to make collage of. This package can except many kinds of Targets., _(*12)

$images = [
    // List of images
    'images/some-image.jpg',
];

There are other kinds of image targets supported:, _(*13)

$images = [
    // 1. File Contents
    file_get_contents('some/image/path/or/url'),

    // 2. Direct URLs
    'https://some/image/url',

    // 3. Absolute & Relative Path
    '/some/image/somewhere/on/disk',

    // 4. Intervention\Image\Image Object
    ImageManagerStatic::make('...'),
    // It's Intervention\Image\ImageManagerStatic

    // 5. Or if you are Using Laravel
    Image::make('...'),
    // It's Intervention\Image\Facades\Image
];

Depending upon the number of images in the array this package will automatically use the right Generator., _(*14)

:globe_with_meridians: Examples Outside Laravel

Firstly, use the Class Namespace at the top., _(*15)

use Tzsk\Collage\MakeCollage;

$collage = new MakeCollage($driver); // Default: 'gd'

The Driver is either 'gd' or 'imagick'. Depending upon which library you are using with PHP. You can customize that. The default is 'gd'., _(*16)

Create collage with 1 Image

Supported, yes., _(*17)

$image = $collage->make(400, 400)->from($images);

// Add Padding:
$image = $collage->make(400, 400)->padding(10)->from($images);

// Add Background Color:
$image = $collage->make(400, 400)->padding(10)->background('#000')->from($images);

Create collage with 2 images

$image = $collage->make(400, 400)->from($images); // Default Alignment: vertical

// Change Alignment:
$image = $collage->make(400, 400)->from($images, function($alignment) {
    $alignment->vertical(); // Default, no need to have the Closure at all.
    // OR...
    $alignment->horizontal();
});

You can also add padding() and background() here., _(*18)

Create collage with 3 images

$image = $collage->make(400, 400)->from($images); // Default Alignment: twoTopOneBottom

// Change Alignment:
$image = $collage->make(400, 400)->from($images, function($alignment) {
    $alignment->twoTopOneBottom(); // Default, no need to have the Closure at all.
    // OR...
    $alignment->oneTopTwoBottom();
    // OR...
    $alignment->oneLeftTwoRight();
    // OR...
    $alignment->twoLeftOneRight();
    // OR...
    $alignment->vertical();
    // OR...
    $alignment->horizontal();
});

You can also add padding() and background() here., _(*19)

Create collage with 4 images

$image = $collage->make(400, 400)->from($images); // Default Alignment: grid

// Change Alignment:
$image = $collage->make(400, 400)->from($images, function($alignment) {
    $alignment->grid(); // Default, no need to have the Closure at all.
    // OR...
    $alignment->vertical();
    // OR...
    $alignment->horizontal();
});

You can also add padding() and background() here., _(*20)

:heart_eyes: Examples in Laravel

In laravel you already have the Alias for the Collage Maker, _(*21)

use Tzsk\Collage\Facade\Collage;

$image = Collage::make(400, 400)->from($images);

The rest of the Features are same as when using in normal php., _(*22)

Create collage with 1 Image

$image = Collage::make(400, 400)->from($images);

// Add Padding:
$image = Collage::make(400, 400)->padding(10)->from($images);

// Add Background Color:
$image = Collage::make(400, 400)->padding(10)->background('#000')->from($images);

Create collage with 2 images

$image = Collage::make(400, 400)->from($images); // Default Alignment: vertical

// Change Alignment:
$image = Collage::make(400, 400)->from($images, function($alignment) {
    $alignment->vertical(); // Default, no need to have the Closure at all.
    // OR...
    $alignment->horizontal();
});

You can also add padding() and background() here., _(*23)

Create collage with 3 images

$image = Collage::make(400, 400)->from($images); // Default Alignment: twoTopOneBottom

// Change Alignment:
$image = Collage::make(400, 400)->from($images, function($alignment) {
    $alignment->twoTopOneBottom(); // Default, no need to have the Closure at all.
    // OR...
    $alignment->oneTopTwoBottom();
    // OR...
    $alignment->oneLeftTwoRight();
    // OR...
    $alignment->twoLeftOneRight();
    // OR...
    $alignment->vertical();
    // OR...
    $alignment->horizontal();
});

You can also add padding() and background() here., _(*24)

Create collage with 4 images

$image = Collage::make(400, 400)->from($images); // Default Alignment: grid

// Change Alignment:
$image = Collage::make(400, 400)->from($images, function($alignment) {
    $alignment->grid(); // Default, no need to have the Closure at all.
    // OR...
    $alignment->vertical();
    // OR...
    $alignment->horizontal();
});

You can also add padding() and background() here., _(*25)

:trophy: Return Value

The reaturned $image is the instance of Intervention\Image\Image object., _(*26)

You can do multiple things with it., _(*27)

• You can save the final collage.
• You can just use it as a plain response.
• You can crop/resize/colorize and more.

Read more about what you can do in the Official Documentation., _(*28)

:electric_plug: Create Custom Generators

Creating a generator is very easy. Create a class that extends the abstract class: Tzsk\Collage\Contracts\CollageGenerator., _(*29)

Example:

use Tzsk\Collage\Contracts\CollageGenerator;

class FiveImage extends CollageGenerator
{
    /**
     * @param Closure $closure
     * @return \Intervention\Image\Image
     */
    public function create($closure = null)
    {
        // Your code to generate the Intervention\Image\Image object
    }
}

NOTE: Take a look at src/Contracts/CollageGenerator.php for details about all the things you have access to in the generator class. Also, if you need a reference consider looking into: src/Generators/FourImage.php., _(*30)

Extend outside laravel

$image = $collage->with([5 => Your\Class\Namespace\FiveImage::class]);
// Here the key is the number of file your generator accepts.
// After this you can continue chaining methods like ->padding()->from() as usual.

You can also override existing generators. Let's say you want to have the FourImage generator to behave differently. You can make your own MyFourImage class and add it., _(*31)

$image = $collage->with([4 => Your\Class\Namespace\MyFourImage::class]);
// It will replace the existing Generator with your own.
// After this you can continue chaining methods like ->padding()->from() as usual.

Extend in laravel

$image = Collage::with([5 => Your\Class\Namespace\FiveImage::class]);
// Here the key is the number of file your generator accepts.
// After this you can continue chaining methods like ->padding()->from() as usual.

You can also override existing generators. Let's say you want to have the FourImage generator to behave differently. You can make your own MyFourImage class and add it., _(*32)

$image = Collage::with([4 => Your\Class\Namespace\MyFourImage::class]);
// It will replace the existing Generator with your own.
// After this you can continue chaining methods like ->padding()->from() as usual.

You can also do this from the config/collage.php config file., _(*33)

There is a generators array which is currently empty. You can add your own generators there like below to Replace or add new generators., _(*34)

'generators' => [
    // It will replace the current FourImage generator.
    4 => Your\Class\Namespace\MyFourImage::class,

    // It will add a new generator.
    5 => Your\Class\Namespace\FiveImage::class,
]

:microscope: Testing

composer test

:date: Changelog

Please see CHANGELOG for more information on what has changed recently., _(*35)

:heart: Contributing

Please see CONTRIBUTING for details., _(*36)

:lock: Security

If you discover any security related issues, please email mailtokmahmed@gmail.com instead of using the issue tracker., _(*37)

:crown: Credits

• Kazi Ahmed
• All Contributors

:policeman: License

The MIT License (MIT). Please see License File for more information., _(*38)