samcrosoft / placeholder
The Simple PHP Image Placeholder Package
dev-master / 0.1.x-dev
2015-06-03 11:10 UTC
Requires
- php: >=5.0.0
Requires (Dev)
- phpunit/phpunit: ~4.0
This package is not auto-updated.
Last update: 2024-12-11 10:22:42 UTC
README
This is a simple package that creates image placeholders using the GD Library. It makes it possible to self host a service to create an imge placeholder just like (placehold.it)
Requirements
- PHP GD
How To Install
composer require samcrosoft/placeholder:"dev-master"
Usage
To create a simple image placeholder that would be returned as an http response is simple as described below
<?php
require 'vendor/autoload.php';
use Samcrosoft\Placeholder\Placeholder;
header ("Content-type: image/png");
/*
* Generate an image object
*/
$oPlaceholder = new Placeholder();
/*
* Make a placeholder using parameters from the url
*/
$oImage = $oPlaceholder->makePlaceholderFromURL();
// Render image
imagepng($oImage);
URL Parameters
- width -> [w] (default is
Placeholder::DEFAULT_IMAGE_WIDTH
), this should be an integer - height -> [h] (default is
Placeholder::DEFAULT_IMAGE_HEIGHT
), this should be an integer also - Background Color -> [b] (default is
#000
which is black), note that when passing the background color as a querystring, the#
character in the URL should be omitted - Foreground Color -> [f] (default is
#fff
which is white), This represents the color of the text - Displayed Text -> [t] (default is
width
xheight
Note : Both foreground and Background colors are expected in hex format e.g (#090, #FFFFFF, #F00) without the (#
)
Sample URL
http://path_to_endpoint?w=100&h=150&b=090&f=ffffff&t=Sample+Message+To+Show
Implementations
Placeholder PHP is implemented using a series of php frameworks, or in other languages, the links are listed below
- PHP Placeholder Lumen - This is an implementation of the php placeholder using laravel Lumen