jdz/image

JDZ Image utils

1.0.2 2026-04-09 13:52 UTC

Requires

• php: >=8.2
• imagine/imagine: ^1.3
• symfony/filesystem: ^7.4
• symfony/finder: ^7.4

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• Joffrey Demetz

• image
• template
• utilities
• JDZ

README

JDZ Image utilities for thumbnail generation, watermark protection, and HTML rendering.

Installation

composer require jdz/image

Requirements

• PHP >= 8.2
• Symfony Filesystem ^7.2
• Symfony Finder ^7.2
• Imagine ^1.3
• GD extension

Usage

Loading and Displaying Images

use JDZ\Image\Image;

$image = new Image('/path/to/files', 'https://mywebsite.com/');
$image->load('media/photo.jpg', 'media/default.jpg');

$pic = $image->getPic('Photo description');
echo (string)$pic;
// <img src="https://mywebsite.com/media/photo.jpg" alt="Photo description" data-orientation="landscape" />

Lazy Loading with Thumbnails

use JDZ\Image\Image;

$image = new Image('/path/to/files', 'https://mywebsite.com/', 'thumbs');
$image->lazy = true;
$image->targetWidth = 800;
$image->cacheLife = 3600;
$image->load('media/photo.jpg');

$pic = $image->getPic('Photo');
echo (string)$pic;
// src points to thumbnail, data-src points to original

Creating Thumbnails

use JDZ\Image\Thumb;

$thumb = new Thumb('/path/to/files', 800, 'thumbs', 3600);
$created = $thumb->thumbImage('media/photo.jpg');

echo $thumb->thumbFile; // 'thumbs/media_photo-800.jpg'

Watermark Protection

use JDZ\Image\Copyright;

$copyright = new Copyright('/path/to/files', 'protect', 'watermark.png', 'repeat');

// Apply watermark (original backed up to protect/ folder)
$copyright->protectImage('media/photo.jpg');

// Restore original
$copyright->unprotectImage('media/photo.jpg');

Filesystem Setup

use JDZ\Image\Fs;

$fs = new Fs('/path/to/files', 'media', 'thumbs', 'protect');
$fs->check(); // Creates media/, thumbs/, protect/ folders if missing

Image Info

use JDZ\Image\Img;

$img = new Img('/path/to/files', 'media/photo.jpg');

if ($img->valid) {
    echo $img->width;       // 1600
    echo $img->height;      // 1200
    echo $img->orientation;  // 'landscape'
    echo $img->ext;          // 'jpg'
}

Testing

composer test
# or
vendor/bin/phpunit

License

This project is licensed under the MIT License - see the LICENSE file for details.