Repository navigation
Added
- Support for all 84 imgproxy 4.0.x processing options, including
blurAreas(),cropObjects()andpreserveHdr(). Imgproxy::createInfo()for/infoURLs with all 32 image-info options, andnextPipeline()for chained pipelines (both imgproxy Pro).- Server URL settings:
argumentsSeparator(),onlyPresets(),optionAlias(),sourceChunkSize(),sourceFilename()andtrustedSignature().
Changed
Existing signed URLs stay valid, except encrypted ones (see Fixed), but the same builder calls may now produce different URLs.
- Breaking: Require PHP 8.4 or later.
- Breaking: Options and presets follow call order instead of alphabetical order, and repeated calls append instead of replacing.
OptionName::ordered()is removed. - Breaking: The builder constructor takes
optionsas an orderedlist<Option|null>and dropsdefaultExtension. - Breaking:
format()no longer sets the source extension; usebuild($source, extension: 'png'). - Breaking:
padding()takes integer pixels, andcachebuster()values are URL-safe Base64-encoded. - Breaking: Arguments that would produce an invalid URL and custom IVs that are not 16 bytes throw
InvalidArgumentException;EncryptionConfigkeys that are not 16, 24 or 32 bytes throwInvalidConfig.
Fixed
- Encrypted sources are padded once. Rebuild encrypted URLs from earlier versions.
- Omitted arguments keep their separators, decimal arguments are accepted where documented, and floats keep full precision.
- Correct URL encoding for
filename()andcolorProfile().