joseluisq / gimage
A PHP library for easy image handling.
Installs: 2 883
Dependents: 0
Suggesters: 0
Security: 0
Stars: 152
Watchers: 12
Forks: 11
Open Issues: 2
Requires
- php: >=7.4
- ext-gd: *
Requires (Dev)
README
A PHP library for easy image handling. 🖼
GImage is a simple and small library based on PHP Image Processing and GD for processing images easily.
Presentation card built with GImage - View code example
Features
- Load an image from a local path, URL or image resource.
- Create shapes such as rectangles or ellipses with opacity.
- Resize, scale or crop images proportionally.
- Rotate images, shapes or texts.
- Embed text with custom TTF fonts.
- Compose a pool of images with
Canvas
. - Swap image formats such as JPEG, PNG or GIF.
- Save images locally or output them on the browser.
- Save several copies of the same image.
- Render an image in memory and return its resource.
Requirements
GImage requires PHP 7.4
or a recent PHP version with the latest GD Extension.
Install
composer require joseluisq/gimage
Usage
Load an external PNG image and save it as JPG:
<?php use GImage\Image; // PNG image (600x199) $url = 'https://i.imgur.com/G5MR088.png'; $arch = new Image(); $arch // Load from URL ->load($url) // Scale to 50% (300x99) ->scale(0.5) // Change the format to JPG ->toJPG() // Saving in local path ->save('arch.jpg');
See GImage Website for detailed usage instructions and more advanced examples.
Changelog
Check out the CHANGELOG.md file.
Examples
See code examples directory.
Development
Run tests
Via Composer
composer install
composer run-script test
Via Docker (multi PHP versions test)
make docker-tests
Contribution
Feel free to send some Pull request or file an issue.
License
This work is primarily distributed under the terms of the MIT license.
©2015-present Jose Quintana