https://github.com/willwashburn/fasterimage
:racehorse: find the size of an image without downloading the whole file. Supports batch requests.
https://github.com/willwashburn/fasterimage
image image-analysis image-size php size
Last synced: about 1 month ago
JSON representation
:racehorse: find the size of an image without downloading the whole file. Supports batch requests.
- Host: GitHub
- URL: https://github.com/willwashburn/fasterimage
- Owner: willwashburn
- License: mit
- Created: 2015-05-06T20:45:29.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2019-05-25T14:35:30.000Z (almost 6 years ago)
- Last Synced: 2025-03-31T04:07:57.356Z (about 2 months ago)
- Topics: image, image-analysis, image-size, php, size
- Language: PHP
- Homepage:
- Size: 73.2 KB
- Stars: 62
- Watchers: 6
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# FasterImage [](https://circleci.com/gh/willwashburn/fasterimage) [](https://coveralls.io/github/willwashburn/fasterimage) [](https://php.net/) [](https://packagist.org/packages/fasterimage/fasterimage) [](https://packagist.org/packages/fasterimage/fasterimage/stats) [](https://github.com/willwashburn/fasterimage/LICENSE)
FasterImage finds the dimensions or filetype of a remote image file given its uri by fetching as little as needed, based on the excellent [Ruby implementation by Stephen Sykes](https://github.com/sdsykes/fastimage) and [PHP implementation by Tom Moor](https://github.com/tommoor/fastimage).
FasterImage uses the curl_muli* suite to run requests in parallel. Currently supports JPG, GIF, PNG, WEBP, BMP, PSD, TIFF, SVG, and ICO files.
## Usage
```php
$client = new \FasterImage\FasterImage();
$images = $client->batch([
'http://wwww.example.com/image1.jpg',
'http://wwww.example.com/image2.gif',
'http://wwww.example.com/image3.png',
'http://wwww.example.com/image4.bmp',
'http://wwww.example.com/image5.tiff',
'http://wwww.example.com/image6.psd',
'http://wwww.example.com/image7.webp',
'http://wwww.example.com/image8.ico',
'http://wwww.example.com/image9.cur',
'http://wwww.example.com/image10.svg'
]);
foreach ($images as $image) {
list($width,$height) = $image['size'];
}
```
## Install
```composer require fasterimage/fasterimage```
Alternatively, add ```"fasterimage/fasterimage": "~1.5"``` to your composer.json
## Changelog
* v1.5.0 - Fallback support when curl_multi_init() is not available
* v1.4.0 - Add support for parsing dimensions from SVG images
* v1.3.0 - Add ability for user agent, buffer size, and SSL host/peer verification to be overridden
* v1.2.1 - Limit isRotated to only check for valid orientation values
* v1.2.0 - Add option to include content-length in result set
* v1.1.2 - Update Accept header to accept images
* v1.1.1 - Properly handle jpeg's with corrupted Exif tags
* v1.1.0 - Return message in return array when curl fails
* v1.0.3 - Use external stream package
* v1.0.2 - Fail invalid image exceptions gracefully when using batch requests
* v1.0.1 - Support PHP v5.4+
* v1.0.0 - **Stable Release** - Support for `.PSD`, `.ICO` + `.CUR`
* v0.0.7 - Remove support for PHP v5.4
* v0.0.6 - Add option to set timeout of requests, support for EXIF in .jpgs, better support for .bmp (including negative height bitmaps) and normalized response indexes for all file types
* v0.0.5 - Support for `.webp`
* v0.0.4 - Support for `.tiff` and exceptions for unknown file types
* v0.0.3 - Force curl to follow redirects so you get less bad responses
* v0.0.2 - Update curl headers to mimic browser so you get less bad responses
* v0.0.1 - Support for `.jpg`, `.bmp`, `.gif`, `.png` and parallel requests
## References
* https://github.com/sdsykes/fastimage
* https://github.com/tommoor/fastimage
* http://pennysmalls.com/find-jpeg-dimensions-fast-in-pure-ruby-no-ima
* http://snippets.dzone.com/posts/show/805
* http://www.anttikupila.com/flash/getting-jpg-dimensions-with-as3-without-loading-the-entire-file/
* http://imagesize.rubyforge.org/