Convert JPEG & PNG to WebP with PHP
This library enables you to do webp conversion with PHP using cwebp, vips, gd, imagick, gmagick, ewww cloud converter or the open source wpc cloud converter. It also allows you to try a whole stack – useful if you do not have control over the environment, and simply want the library to do everything it can to convert the image to webp.
In addition to converting, the library also has a method for serving converted images, and we have instructions here on how to set up a solution for automatically serving webp images to browsers that supports webp.
NOTE: This master branch contains code for the upcoming 2.0 release. It is not stable yet ()- but very close!)
Require the library with Composer, like this:
composer require rosell-dk/webp-convert
To convert an image using a stack of converters, you can use the WebPConvert::convert method.
Here is a minimal example of converting using the WebPConvert::convert method:
<?php
// Initialise your autoloader (this example is using Composer)
require 'vendor/autoload.php';
use WebPConvert\WebPConvert;
$source = __DIR__ . '/logo.jpg';
$destination = $source . '.webp';
$options = [];
WebPConvert::convert($source, $destination, $options);The WebPConvert::convert method comes with a bunch of options. The following introduction is a must-read: docs/convert-introduction.md.
If you are migrating from 1.3.9, read this
The WebPConvert::serveConverted method tries to serve a converted image. If there already is an image at the destination, it will take that, unless the original is newer or smaller. If the method cannot serve a converted image, it will serve original image, a 404, or whatever the 'fail' option is set to - and return false. It also adds a X-WebP-Convert-Status header, which allows you to inspect what happened.
Example (API 2.0):
<?php
require 'vendor/autoload.php';
use WebPConvert\WebPConvert;
$source = __DIR__ . '/logo.jpg';
$destination = $source . '.webp';
WebPConvert::serveConverted($source, $destination, [
'fail' => 'original', // If failure, serve the original image (source).
//'fail' => '404', // If failure, respond with 404. Other options include 'throw' and 'report'
//'show-report' => true, // Generates a report instead of serving an image
// Besides the specific options for serving, you can also use the options for convert()
]);The following introduction is a must-read (for 2.0): docs/convert-introduction.md.
The old introduction (for 1.3.9) is available here: docs/serving/v1.3/convert-and-serve.md
The library can be used to create a WebP On Demand solution, which automatically serves WebP images instead of jpeg/pngs for browsers that supports WebP. To set this up, follow what's described in this tutorial (not updated for 2.0 yet).
WebP Convert is used in the following projects:
Wordpress integration
A cloud service based on WebPConvert
Kirby CMS integration
Bread on the table don't come for free, even though this library does, and always will. I enjoy developing this, and supporting you guys, but I kind of need the bread too. Please make it possible for me to have both: