Download the PHP package cleup/pixie without Composer

Pixie - Modern PHP Image Manipulation Library

A powerful, flexible, and easy-to-use image manipulation library for PHP with support for both GD and Imagick drivers. Perfect for handling image processing tasks with excellent quality preservation and animation support.

Features

• 🖼️ Dual Driver Support - Choose between GD or Imagick based on your needs
• 🎞️ Animation Support - Full animated GIF support
• 🎯 High Quality - Excellent quality preservation with optimized algorithms
• 📐 Multiple Operations - Resize, crop, rotate, flip, filters, and more
• 💧 Transparency Support - Full alpha channel support for PNG and GIF
• 🚀 Performance Optimized - Efficient memory usage and processing

Installation

Requirements

• PHP 8.1 or higher
• GD extension (for GD driver)
• Imagick extension (for Imagick driver - recommended for advanced features)
• Gifsicle for better optimization of GIF images

Recommendation

If you plan to work with GIF images and want to optimize them or add animation support, it is recommended that you install Gifsicle. This tool can help you work with GIFs more efficiently and add animations where they are not currently supported, such as in conjunction with the GD library.

Quick Start

Using ImageManager (Recommended)

Using Image Class Directly

Driver Comparison

GD Driver

• ✅ Built-in PHP extension
• ✅ Good performance for basic operations
• ✅ Lower memory usage
• ❌ Does not support animated GIFs without Gifsicle
• ❌ Lower quality for some operations

Imagick Driver (Recommended)

• ✅ Excellent quality output
• ✅ Full animated GIF support
• ✅ Advanced image processing features
• ❌ Requires separate extension
• ❌ Higher memory usage

For most production applications, especially those that require support for animated GIF files or high-quality data output, we recommend using the Imagick driver in combination with the Gifsicle utility for optimal results.

Basic Usage

Loading Images

Saving Images

Image Operations

Resizing

Cropping

Transformations

Filters and Effects

Utility Methods

Error Handling

API Reference

ImageManager Static Methods

• createFromPath(string $path, string $driver = 'auto'): Image
• createFromString(string $data, string $driver = 'auto'): Image
• getInfo(string $path): array
• isSupportedFormat(string $path): bool
• getAvailableDrivers(): array
• isDriverAvailable(string $driver): bool
• getRecommendedDriver(): string

Image Instance Methods

Loading & Saving

• load(string $path): self
• loadFromString(string $data): self
• save(string $path, ?int $quality = null, ?string $format = null): bool
• toString(?string $format = null, ?int $quality = null): string
• output(?string $format = null, ?int $quality = null): void

Information

• getWidth(): int
• getHeight(): int
• getAspectRatio(): float
• getType(): string
• getMimeType(): string
• isAnimated(): bool
• getDriver(): DriverInterface

Transformations

• resize(int $width, ?int $height = null, bool $preserveAspectRatio = true): self
• resizeToWidth(int $width): self
• resizeToHeight(int $height): self
• resizeToFit(int $maxWidth, int $maxHeight): self
• resizeToFill(int $width, int $height): self
• scale(float $ratio): self
• crop(int $x, int $y, int $width, int $height): self
• fit(int $width, int $height): self
• rotate(float $angle, string $backgroundColor = 'transparent'): self
• flip(string $mode = 'horizontal'): self
• flipHorizontal(): self
• flipVertical(): self

Filters & Effects

• blur(int $amount = 1): self
• sharpen(int $amount = 1): self
• brightness(int $level): self
• contrast(int $level): self
• gamma(float $correction): self
• colorize(int $red, int $green, int $blue): self
• greyscale(): self
• sepia(): self
• pixelate(int $size): self
• invert(): self
• watermark($watermark, string $position = 'bottom-right', int $offsetX = 10, int $offsetY = 10): self

License

MIT License. See LICENSE file for details.