/resized-php-laravel

Laravel 5 package for resized.co - the on-demand image resizing service.

Primary LanguagePHPMIT LicenseMIT

Resized

Latest Version on Packagist Software License Build Status Total Downloads

This is the Laravel 5 package for resized.co, an on-demand image resize manipulation service.

Install

Via Composer

$ composer require square1/resized-laravel

To use the Resized Service Provider, you must register the provider when bootstrapping your Laravel application.

Find the providers key in your config/app.php and register the Resized Service Provider.

    'providers' => array(
        // ...
        Square1\Laravel\Resized\ResizedServiceProvider::class,
    )

Find the aliases key in your config/app.php and add the Resized facade alias.

    'aliases' => array(
        // ...
        'Resized' => Square1\Laravel\Resized\ResizedFacade::class,
    )

Configuration

By default, the package uses the following environment variables to auto-configure the plugin without modification:

RESIZED_KEY
RESIZED_SECRET
RESIZED_DEFAULT_IMAGE

Usage

Set the default failover image.

	Resized::setDefaultImage('http://www.example.com/no-image.jpg');

Generate a 300x500 resized image URL.

    $url = Resized::process('http://www.example.com/some-image-to-resize.jpg', '300', '500');

Generate an image URL that is contrained to 300 width whilst mantaining aspect ratio.

    $url = Resized::process('http://www.example.com/some-image-to-resize.jpg', '300', '');

Generate an image URL that is contrained to 500 height whilst mantaining aspect ratio.

    $url = Resized::process('http://www.example.com/some-image-to-resize.jpg', '', '500');

Override image slug.

    $url = Resized::process('http://www.example.com/some-image-to-resize.jpg', '300', '500', 'A nice image name');

Testing

$ composer test

License

The MIT License (MIT). Please see License File for more information.