Download the PHP package tomkirsch/superimage without Composer
On this page you can find all versions of the php package tomkirsch/superimage. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package superimage
SuperImage - Responsive Images for CodeIgniter 4
A modern responsive image library for CodeIgniter 4 with on-the-fly resizing, versioned cache filenames, and modern HTML output (<picture> / <img srcset>). By default (cacheBustingMethod = 'mtime'), stale requests are redirected (301) to the current versioned URL.
Install
Create app\config\SuperImage.php
These are some basic values. See vendor/tomkirsch/superimage/src/SuperImageConfig.php for all settings.
.htaccess serving (default)
True htaccess serving requires cached files to be in public. Add to .gitignore:
Paste this after RewriteEngine ON:
NOTE!
You might need to change the path to the DOCUMENT_ROOT above to match your setup.
config/Services.php
config/Routes.php
controllers/Home.php
View
The src parameter must be a relative base filename with extension:
The source path is resolved from your config's $sourcePath setting.
Supported render() options (current SuperImage class)
src is an alias for file.
src/fileoutputExtwidths('full','half','third','quarter','two-thirds', array, or decimal fraction)gutter,static,maxResolution,resolutionStepmaxWidth,maxHeight(supports'source')loading('lazy' | 'eager' | 'auto')fetchPriority('high' | 'low' | 'auto')alt,cacheVersion,pictureAttr,imgAttr,prettyPrint
Set loading behavior carefully to avoid writing too many variants during a single page load. Above-fold:
Below-fold:
Resizer utility methods
From \Config\Services::resizer():
serve(string $requestPath): voidcleanExpired(): intcleanImage(string $basePath): intcleanAll(): int
Testing .htaccess serving
Bring up an image in the browser, so it writes the cache file. Verify file is written. Comment out the CI rewrite, clear cache, and refresh the browser. You should NOT see X-Superimage-Cache in development a env - this means the file is being served by .htaccess!
If you still see X-Superimage-Cache header...
Mess with the DOCUMENT_ROOT paths until it goes away.
View Examples
Hero — above the fold, full width
Product grid — three columns with gutter
Responsive layout — full → half → third across breakpoints
Use SuperImageWidths when the image occupies different fractions of the viewport at different screen sizes. Each at() call is a min-width, matching CSS media query logic.
Raw decimals and gutter also work: