Download the PHP package joppuyo/jpeg-xl-encode without Composer
On this page you can find all versions of the php package joppuyo/jpeg-xl-encode. 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 jpeg-xl-encode
JPEG XL Encode
A PHP library for encoding JPEG XL images. Supports JPEG and PNG input. Very much inspired by the excellent WebP Convert library.
It is intended as a plug-and-play solution that covers the most common use cases and it can be used in a wide variety of PHP projects.
Requirements
- PHP 7.2.5 or later.
- Linux, macOS or Windows OS
- One or more of the following methods of encoding JPEG XL images needs to be available:
- The
proc_openPHP function needs to be enabled so the library can execute the cjxl binary on the command line. - The
vipsPHP extension is installed and enabled. VIPS image processing library must be compiled with jxl support - The
imagickPHP extension is installed and enabled. ImageMagick library needs to be compiled with jxl support
- The
Installation
Usage
Options
Encoding
encoding
Selects which encoding to use, lossy for VarDCT and lossless for Modular. Default is lossy for JPEG input and lossless for PNG input.
Quality
quality
Image quality for lossy compression. The quality range goes from 1 to 100. Default is 85.
Effort
effort
Controls how much time is used for image encoding. Longer encoding time means smaller files. Range is from 1 to 9 where 1 is the fastest and 9 is the slowest. Default is 7.
Progressive
progressive
Enables progressive decoding for the image. If a web browser supports progressive rendering, the image will download perceptually faster. In VarDCT mode, progressive decoding does not affect the file size much.
Enabling progressive decoding for Modular images is not recommended since it makes the resulting image file significantly larger. It could be enabled at a later date in a future version when there are browsers that support downloading only part of a modular progressive file.
Default value is true for lossy and false for lossless.
Methods
There are four different methods you can use: cjxl binary, cjxl system binary, ImageMagick extension and Vips extension. The library goes through each of the available methods and tries to use them. If none of the methods are available, an exception will be thrown.
Cjxl binary
This method executes the cjxl binary on the command line. It's the most compatible method and it supports the most features. However, the proc_open function needs to be enabled in the PHP installation since the library executes the binary on the command line. Some web hosts may disable this function for security reasons.
Note: this library comes bundled with statically compiled version of the cjxl binary for Linux, macOS and Windows systems. The binary is bundled with all the required libraries which means it will work out of the box without the need to install any additional dependencies.
Cjxl system binary
This is the same as the previous method but it executes the cjxl binary from system PATH. This means you need to install jpeg xl using your system package manager like homebrew or build jpeg xl from source and add the cjxl binary to your PATH variable.
ImageMagick extension
This method uses the ImageMagick library and its PHP extension Imagick. However, ImageMagick needs to be built with JXL delegate. In practice, this means you will need to install the libjxl library on the server. Then you will need to build ImageMagick from the source with the option --with-jxl=yes. Lastly, you will need to install the Imagick PHP extension. The ImageMagick extension does not support progressive encoding at the time. For an example how to compile ImageMagick with JPEG XL support, see this Dockerfile.
Vips extension
This method uses the vips library and its PHP extension. However, vips needs to be built with JXL support. In practice, this means you will need to install the libjxl library on the server. Then you will need to build vips from the source. Lastly, you will need to install the vips PHP extension. The vips extension does not support progressive encoding at the time. For an example how to compile VIPS with JPEG XL support, see this Dockerfile.
In addition the vips extension, you will also need to install the jcupitt/vips PHP library in your project in addition jpeg-xl-encode, you can do this by using the following command:
License
MIT.
For detailed license information, see the individual file headers and .reuse/dep5.
Maintance level
This project is under active development and it has a number of features currently under development.
All versions of jpeg-xl-encode with dependencies
symfony/process Version ^5.3
rosell-dk/image-mime-type-guesser Version ^0.3.1
respect/validation Version ^2.0.17