Photoplacer is a simple PHP application for providing placeholder images for your projects. It allows you to define your own categories for organising your image bank, and also to apply various filters to your images on the fly.
Clone this repository or download the Zip / Tar file before navigating to the new folder and running composer install. This will pull down the Lumen framework and other third party libraries required. You must have either the GD or Imagick PHP extensions for the app to function.
The application is configured by a .env file in the document root. If this has not been created, copy .env.example and rename it ".env".
APP_ENV=local
APP_DEBUG=true
IMAGES_PATH=imagebank
IMAGES_DEFAULT_X=800
IMAGES_DEFAULT_Y=600
IMAGES_MAX_X=1400
IMAGES_MAX_Y=1400
IMAGE_FILTERS=true
IMAGE_FILTERS_BLUR=5
IMAGE_FILTERS_PIXELATE=10
This sets the application environment. It is recommended this is not set to local when in production.
As above, set this to false when not running locally.
This is where your image library is set relative to /storage/app
. From the example above the full path would be:
/storage/app/imagebank
Here you can define the default image width that is returned on certain invalid requests (for example, exceeding the maximum size limits).
Here you can define the default image height that is returned on certain invalid requests (for example, exceeding the maximum size limits).
Due to memory limitations, you may wish to control how large an image is able to be created by the application. This value prevents users from exceeding a defined width.
Due to memory limitations, you may wish to control how large an image is able to be created by the application. This value prevents users from exceeding a defined height.
This setting allows you to globally disable filters from being applied. Existing images will still work, but will lose their styling.
Sets the blur filter intensity. Warning: Blur is a resource intensive filter, be careful setting large values as your memory limits may cause image generation to fail.
Sets the pixelation filter intensity.
Photoplacer is open-sourced software licensed under the MIT license