Awesome Open Source
Awesome Open Source

Image Upload

API based service that allow to save, resize and read images


  • [x] Save on Filesystem
  • [x] Save on AWS
  • [x] Possibility to add Validators
  • [x] Possibility to add Filters
  • [x] PHP7 strict mode
  • [x] Link with public Postman collection
  • [ ] Unit testing
  • [ ] Submit on packagist (composer)
  • [ ] Host the demo somewhere
  • [ ] Auth token API protection


Environment variables allowed:

  • SAVE_HANDLER: (filesystem|aws) where you will save the images
  • OPTIMIZE: (0|1) strip exif data in order to reduce image size
  • MAX_DIMENSIONS: (example: 4096x4096) maximum allowed dimensions
  • MAX_SIZE: (example: 10240) maximum allowed size in kb
  • ALLOWED_DIMENSIONS: (example: 1400x460;1280x460;800x600) dimensions allowed when requesting a resize version of a previously uploaded image

Usage via API

Run in Postman

In order to receive a JSON response, you should add the following headers:

  • Content-Type: application/json
  • Accept: application/json; charset=utf-8

We are supposing that you uploaded this application on


Return info about a previously uploaded image


  • id: (optional: integer) id of a previously uploaded image

Example GET data: {}

Example response:

    "ping": "pong"

Example GET data: {"id": "5897209a9325f7-78554697"}

Example response:

    "status_code": 200,
    "id": "5897209a9325f7-78554697",
    "url": "",
    "url_dynamic": "",
    "width": null,
    "height": null


Upload an image


  • source: (required: url|base64 string|uploaded file) you can send a remote url, an image base64 encoded (without new lines in JSON) or upload a file (see an example in the public/upload.php
  • width: (optional: integer) if specified, the original image will be resized to the specified width before uploading it
  • height: (optional: integer) if specified, the original image will be resized to the specified height before uploading it

Note: if you specify only the width or the height param, the image will be proportionally resized

Example POST data: {"source": "...very long base64 string..."}

Example response:

    "status_code": 200,
    "id": "5898c96c4a2d62-52410036",
    "url": "",
    "url_dynamic": "",
    "width": null,
    "height": null


Hosting in progress...


If you want to use directly the Image object in your application (and not as a standalone API service), you can find some examples inside the public/examples directory.

Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Php (284,330
Amazon Web Services (38,094
Upload (14,332
Filesystem (7,642
Uploader (2,589
Image Uploader (172
Save Handlers (3