Skip to content

Latest commit

 

History

History
75 lines (49 loc) · 2.09 KB

README.md

File metadata and controls

75 lines (49 loc) · 2.09 KB
Raw

Image Host Manager

I like to host my own images on S3. I built this simple web app to front my S3 bucket and help manage the image contents.

The app is built in PHP with the Slim 3 Framework. It uses a handful of php libraries that need to be installed with composer.

Deploy

Features

  • Preview all (up to 1000) images in your bucket, sorted by most recently modified first.
  • Filter the images by keyword (matches on file name).
  • Add a new image by url and provide an optional filename.
  • Click an image preview to copy the url to your clipboard.
  • Update the description and tags meta data of your images.

Setup

Install

$ git clone [email protected]:stevenmaguire/image-host-manager.git
$ cd image-host-manager
$ composer install

Configure

Copy the .env.example file to a new .env file.

$ cp .env.example .env

Open up the .env file in your favorite editor and provide values for the keys.

APP_NAME="My App"
IMAGES_BASE_URL="https://my.images.are.served.from.here.com"
USERS='{"user1":"password1","user2":"password2"}'
AWS_ACCESS_KEY="YOUR-AWS-ACCESS-KEY"
AWS_SECRET_KEY="YOUR-AWS-SECRET-KEY"
AWS_S3_BUCKET="YOUR-S3-BUCKET-WHERE-YOUR-IMAGES-LIVE"
AWS_S3_REGION="REGION-WHERE-YOUR-S3-BUCKET-LIVES"

The app uses Basic Authentication to protect your content from prying eyes. You can add your own user and password combinations to the JSON string associated with the USERS key in the .env file.

Run

$ composer start

Browse to http://localhost:8080/ and enter your user and password to begin using the app.

Testing

$ ./vendor/bin/phpunit

Contributing

Please see CONTRIBUTING for details.

Credits

License

The MIT License (MIT). Please see License File for more information.