Download the PHP package rcsofttech/php-image-guard without Composer
On this page you can find all versions of the php package rcsofttech/php-image-guard. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rcsofttech/php-image-guard
More information about rcsofttech/php-image-guard
Files in rcsofttech/php-image-guard
Package php-image-guard
Short Description SSIM-based image quality verification with auto-retry compression loop for PHP 8.4+
License MIT
Informations about the package php-image-guard
php-image-guard
SSIM-based image quality verification with auto-retry compression loop for PHP 8.4+
This package does ONE job: guard image quality. It does not compress, resize, or upload images. It verifies that a compression result meets your quality threshold — and retries if not.
Requirements
- PHP 8.4+
ext-gd(required)ext-imagick(optional — enables higher-precision SSIM via float pixel data)
Installation
Quick Start
Minimal — check one image
Standalone SSIM score (no retry)
Full Fluent API
Quality Presets
| String | SSIM Threshold |
|---|---|
'strict' |
0.97 |
'balanced' |
0.92 |
'loose' |
0.85 |
Custom numeric thresholds are typically used in the 0.0 to 1.0 range.
Failure Behaviors
OnFailBehavior |
Action |
|---|---|
RECOMPRESS |
Retry up to maxQuality, then accept best result |
WARN |
Return passed=false + add $result->warnings |
ABORT |
Throw exception holding the full PipelineResult |
Batch API
Compressor Examples
The compressor callable receives a quality integer and the originalPath
string, and must return the path to the compressed file. This decouples
php-image-guard from any specific tool.
Plain GD
With spatie/image-optimizer
With intervention/image
PipelineResult Shape
SSIM Accuracy
These are practical expectations aligned with the current test suite and generated fixtures (not universal guarantees for every image set).
| Scenario | Expected |
|---|---|
| Identical images | SSIM = 1.000000 |
| White vs black | SSIM < 0.05 |
| JPEG quality 95 | SSIM > 0.98 |
| JPEG quality 10 | SSIM < 0.92 |
| PNG vs 50% WebP | 0.85–0.995 |
License
MIT — see LICENSE.
All versions of php-image-guard with dependencies
ext-gd Version *