FasterImage finds the size or type of a set of images given their uris by fetching as little as needed, in parallel. Originally ported by Tom Moor.

v1.5.0 2019-05-25 14:33 UTC

This package is auto-updated.

Last update: 2021-11-25 19:51:05 UTC


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 and PHP implementation by Tom Moor.

FasterImage uses the curl_muli* suite to run requests in parallel. Currently supports JPG, GIF, PNG, WEBP, BMP, PSD, TIFF, SVG, and ICO files.


        $client = new \FasterImage\FasterImage();
        $images = $client->batch([
        foreach ($images as $image) {
            list($width,$height) = $image['size'];


composer require fasterimage/fasterimage

Alternatively, add "fasterimage/fasterimage": "~1.5" to your composer.json


  • 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