Laravel Imagekit Laravel Package

✨ New Features

📊 Configurable Return Keys

Added return_keys configuration option to customize what data is returned after saving an image.

Available Keys:

• name - Image filename
• path - Directory path
• full_path - Full path (path + name)
• size - Final file size in KB (after all modifications)
• original_size - Original file size in KB (before modifications)
• url - Full URL to the image
• extension - File extension (jpg, png, webp, etc.)
• mime_type - MIME type (image/jpeg, image/png, etc.)
• width - Image width in pixels
• height - Image height in pixels
• disk - Storage disk name
• hash - MD5 hash of the file
• created_at - Timestamp when saved

Behavior:

• Single key → returns string (or appropriate type)
• Multiple keys → returns array
• Default: ['name'] (backward compatible)

Example:

// config/imagekit.php
'return_keys' => ['name', 'size', 'original_size', 'url'],

// Result:
[
    'name' => 'image_123.jpg',
    'size' => 45.50,           // KB after compression
    'original_size' => 150.25, // KB before compression
    'url' => 'http://example.com/storage/...'
]

🔧 Improvements

• save() and saveImage() now return string|array based on config
• saveGallery() now includes return keys data in results
• Added comprehensive unit tests for return_keys feature

• This is the first stable release, no breaking changes exist.
• Future versions will include presets, queue processing, logging, dashboard, and more.

Release Status: Stable
Version: 1.0.0

🎉 Initial Release (First Public Version)

This is the first official public release of ImageKit, a Laravel package for advanced and fluent image processing.

✨ Highlights of This Release

🚀 Core Features

• Image upload & validation
• Single & multi-size image resizing
• Image compression with adjustable quality
• Watermarking (file path or uploaded file)
• Custom storage disk support (local, public, S3, GCS, Azure, custom)
• Dynamic file naming strategies (default, UUID, hash, timestamp, custom)

🖼️ Gallery Support

• Multiple image upload
• Batch processing
• Auto-generated metadata
• Support for alt text (single or per-image)

🔧 Deletion Tools

• Delete single image
• Delete all size variants
• Batch deletion for galleries

📤 Image Retrieval

• Get image URL
• Get storage path
• Temporary URLs for cloud
• Display image as HTTP response
• Download image

🧩 Fluent API

• Clean, readable, chainable methods
• Multiple aliases for developer convenience

📢 Events System

• ImageSaving
• ImageSaved
• ImageDeleted

🛡️ Error Handling

• Validation errors with descriptive messages
• Custom exception classes
• Graceful failure handling