Download the PHP package rosell-dk/webp-on-demand without Composer
On this page you can find all versions of the php package rosell-dk/webp-on-demand. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package webp-on-demand
WebP on demand
This library is now part of WebP Convert and thus obsolete!
This is a solution for automatically serving WebP images instead of jpeg/pngs for browsers that supports WebP (Google Chrome, that is).
Once set up, it will automatically convert images, no matter how they are referenced. It for example also works on images referenced in CSS. As the solution does not require any change in the HTML, it can easily be integrated into any website / framework (A Wordpress adaptation was recently published on wordpress.org - its also on github)
NOTE: This library will be part of WebP Convert soon (depreciated, that is)
Overview
A setup consists of these parts:
-
Redirect rules that redirects JPG/PNG images to a PHP script.
-
A PHP script that serves a converted image - by calling WebPOnDemand::convert() method of this library.
- WebPOnDemand::convert(). Detects if an existing converted image can be served. If yes, serves it (unless the original has been modified). Otherwise it converts the image using the webp-convert-and-serve library.
Requirements
- Apache or LiteSpeed web server. Can be made to work with NGINX as well. Documentation is on the roadmap.
- PHP >= 5.6 (we are only testing down to 5.6. It should however work in 5.5 as well)
- That one of the webp-convert converters are working (these have different requirements)
Installation
The first two steps are whether you are going to use composer or not. Not using composer? - Follow me!
1. Require this library with composer
composer require rosell-dk/webp-on-demand
2. Create the script
Create a file webp-on-demand.php, and place it in webroot, or where-ever you like in you web-application.
Here is a minimal example to get started with:
3. Add redirect rules
Place the following rewrite rules in a .htaccess file in the directory you want webp-on-demand to do its magic:
If you have placed webp-on-demand.php in a subfolder, you will need to change the rewrite rule accordingly.
4. Validate that it works
Browse to an JPEG image. Instead of an image, you should see a conversion report. Hopefully, you get a success. Otherwise, you need to hook up to a cloud converter or try to meet the requirements for cwebp, gd or imagick. You can learn more about available options at the github page for webp-convert
Once you get a successful conversion, you can uncomment the "show-report" option in the script.
It should work now, but to be absolute sure:
- Visit a page on your site with an image on it, using Google Chrome.
- Right-click the page and choose "Inspect"
- Click the "Network" tab
- Reload the page
- Find a jpeg or png image in the list. In the "type" column, it should say "webp". There should also be a X-WebP-On-Demand header on the image.
5. Customizing and tweaking
Basic customizing is done by setting options in the $options array:
- Check out the API for webp-on-demand specific options.
- Check out webp-convert for conversion options.
- Check out webp-convert-and-serve for options on how to respond on failures.
Other tweaking is described in docs/tweaks.md:
- Store converted images in separate folder
- CDN
- Make .htaccess route directly to existing images
- Forward the query string
Troubleshooting
The redirect rule doesn't seem to be working
If images are neither routed to the converter or a 404, it means that the redirect rule isn't taking effect. Common reasons for this includes:
- Perhaps there are other rules in your .htaccess that interfere with the rules?
- Perhaps your site is on Apache, but it has been configured to use Nginx to serve image files. You then need to reconfigure your server setup. Or create Nginx rules. There are some here.
- Perhaps the server isn't configured to allow .htaccess files? Try inserting rubbish in the top of the .htaccess file and refresh. You should now see an Internal Server Error error page. If you don't, your .htaccess file is ignored. Probably you will need to set AllowOverride All in your Virtual Host. Look here for more help
Related
- WebP Express. A Wordpress adaptation of this library.
- https://www.maxcdn.com/blog/how-to-reduce-image-size-with-webp-automagically/
