ministryofweb / image-fix-exif-orientation
Automatically rotates an image based on its orientation stored in Exif data. Supports GD and ImageMagick/IMagick.
Installs: 1 901
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 0
Open Issues: 0
Requires
- php: ^7.3 || ^8.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.16
- phpunit/phpunit: ^9.0
- squizlabs/php_codesniffer: ^3.5
- vimeo/psalm: ^4.0
Suggests
- ext-gd: *
- ext-imagick: *
README
This library automatically rotates an image based on its orientation stored in Exif data. Supports GD and ImageMagick/IMagick.
Requirements
- PHP 7.3+ compiled with
--enable-exif
- at least one of the GD or IMagick extensions
License
This library is licensed under the MIT License.
Installation
composer require mjaschen/image-fix-exif-orientation
Usage
The following example is also located in the examples
sub-directory and can directly be run from there.
<?php declare(strict_types=1); use MinistryOfWeb\ImageFixExifOrientation\Fixer\Gd; use MinistryOfWeb\ImageFixExifOrientation\Fixer\ImageMagick; use MinistryOfWeb\ImageFixExifOrientation\Image; use MinistryOfWeb\ImageFixExifOrientation\OrientationFixer; use MinistryOfWeb\ImageFixExifOrientation\Output\Filesystem; use MinistryOfWeb\ImageFixExifOrientation\Output\ImageString; // please initialize Composer vendor directory first (by running `composer install`) require_once dirname(__DIR__) . '/vendor/autoload.php'; // (1) load existing image from file system; it's possible to initialize an Image // instance from a string as well $image = new Image(dirname(__DIR__) . '/tests/fixtures/Landscape_3.jpg'); //$image = Image::fromString($imageData); // (2) initialize Fixer class, can be either GD oder ImageMagick, // depending on what image manipulation extension is preferred. $fixer = new Gd(90); //$fixer = new ImageMagick(90); // (3) initialize output class, in this case we write to a temporary file // in the file system; getting the image data as a string is also possible $output = new Filesystem(tempnam(sys_get_temp_dir(), 'ministryofweb-exif-fix') . '.jpg'); //$output = new ImageString(); // (4) initialize the fixer $fixer = new OrientationFixer($fixer, $output); // (5) fix the image $fixer->fix($image); echo 'Fixed image: ' . $output->getFile() . PHP_EOL;
Development
Run unit tests with:
./vendor/bin/phpunit
There are some tests which actually work with test images and create corrected versions. It's possible to inspect those images after running the tests by opening the tests/fixtures/fixtures.html
with a web browser.
There are two sets of images (landscape, portrait), each set provides one image for each of the nine possible Exif orientation values (0-8). So in total there are 18 test images.
Test Images
For testing the images from Dave Perret (https://github.com/recurser/exif-orientation-examples) are used. They're licensed under the MIT License.