buglinjo / laravel-webp
Laravel package for WebP image formatting.
Installs: 155 059
Dependents: 3
Suggesters: 0
Security: 0
Stars: 150
Watchers: 4
Forks: 33
Open Issues: 1
Requires
- php: ^8.0|^8.1
- ext-gd: *
- laravel/framework: ^10.0|^11.0
Requires (Dev)
- phpunit/phpunit: >=5.4.3
- squizlabs/php_codesniffer: ^2.3|^3.6
README
WebP (.webp) comes to Laravel
About
WebP is a modern image format that provides superior lossless and lossy compression for images on the web. Using WebP, webmasters and web developers can create smaller, richer images that make the web faster.
WebP lossless images are 26% smaller in size compared to PNGs. WebP lossy images are 25-34% smaller than comparable JPEG images at equivalent SSIM quality index.
Lossless WebP supports transparency (also known as alpha channel) at a cost of just 22% additional bytes. For cases when lossy RGB compression is acceptable, lossy WebP also supports transparency, typically providing 3× smaller file sizes compared to PNG.
cwebp
compresses an image using the WebP format. Input format can be either PNG
, JPEG
, TIFF
, WebP
or
raw Y'CbCr
samples.
Before Installation
New Driver Is Available: php-gd
Currently, supports 2 drivers:
php-gd
- Only needsgd
- PHP extension to be installedcwebp
- uses Google nativecwebp
cli command
Note: If you choose to use cwebp driver you will need to install WebP before installing this package.
For more information you can visit this page
Install
Via Composer
$ composer require buglinjo/laravel-webp
For Laravel <= 5.4
After updating composer, add the ServiceProvider to the providers array in config/app.php
Buglinjo\LaravelWebp\WebpServiceProvider::class,
You can use the facade for shorter code. Add this to your aliases:
'Webp' => Buglinjo\LaravelWebp\Facades\Webp::class,
Publish config file
You will need to publish config file to add cwebp
global path.
php artisan vendor:publish --provider="Buglinjo\LaravelWebp\WebpServiceProvider" --tag=config
In config/laravel-webp.php
config file you should set cwebp
global path.
return [ /* |-------------------------------------------------------------------------- | Default Quality |-------------------------------------------------------------------------- | | This is a default quality unless you provide while generation of the WebP | */ 'default_quality' => 70, /* |-------------------------------------------------------------------------- | Default Driver |-------------------------------------------------------------------------- | | This is a default image processing driver. Available: ['cwebp', 'php-gd'] | */ 'default_driver' => 'php-gd', /* |-------------------------------------------------------------------------- | Drivers |-------------------------------------------------------------------------- | | Available drivers which can be selected | */ 'drivers' => [ /* |-------------------------------------------------------------------------- | Cwebp Driver |-------------------------------------------------------------------------- | | If you choose cwebp driver it is required to specify the path to the executable. | */ 'cwebp' => [ 'path' => '/usr/local/bin/cwebp', ], /* |-------------------------------------------------------------------------- | Cwebp Driver |-------------------------------------------------------------------------- | | If you choose PHP GD driver no configuration is necessary. | */ 'php-gd' => [ // ], ], ];
Usage
Webp::make(<UploadedFile image>)->save(<output path>, <quality :optional>);
Note: UploadedFile
class instance is created when file is retrieved using laravel request.
Example:
$webp = Webp::make($request->file('image')); if ($webp->save(public_path('output.webp'))) { // File is saved successfully }
where <quality>
is 0 - 100 integer. 0 - lowest quality, 100 - highest quality.
Default quality
is 70
Also you can set quality
by chaining ->quality(<quality>)
between WebP::make(<UploadedFile image>)
and ->save(<output path>);
License
The MIT License (MIT). Please see License File for more information.