Project repo for the ImageRack PHP lib. Simple PHP image processor and server.
Developed by Diarmuid.
- Resizes images on the fly based on predefined user templates.
- Uses the Intervention image library for easy image manipulation using GD or Imagick.
- Integrates with local or remote (Amazon S3, SFTP, Azure etc.) image stores using the PHP League Flysystem filesystem abstraction library.
- Ability to cache processed images so that subsequent requests are served quickly.
- SEO friendly and easy to use URLs i.e.
example.com/<template>/path/to/source/image.png
. - Supports PNG/JPEG/GIF images.
- Adds
Cache-Control
,ETag
andLast_Modified
headers to response for better browser and CDN caching.
Sample Heroku Setup guide and code: diarmuid.ie/blog/setting-up-a-php-image-server-on-heroku.
To start a new project use the composer create-project
command to install the ImageRack package in a named folder:
composer create-project diarmuidie/imagerack <folder-name>
Once the package is installed you can edit the contents of:
public/index.php
The main file that all requests are handled by.bootstrap/dependencies.local.sample.php
Where the Flysystem and Intervention Image dependencies are configured.templates/
Where your templates for resizing media will be stored.
Ensure the public/
directory is setup as your public-accessible DocumentRoot. The provided .htaccess
file will redirect all requests to the ImageRack server.
The Nginx configuration file should include the following information (in addition to any other settings you require):
root /some/folder/public;
index index.php;
location ~ \.php$ {
...
try_files $uri $uri/ /index.php?$args;
...
}
A single server deploy is the most straight forward configuration. Source images must be stored in the storage/source
folder. Resized images will be cached in storage/cache
.
To use the ImageRack server in a multi-server environment (i.e. more than one web servers sitting behind a load ballancer) you must store the source and cache images in a distributed filesystem.
ImageRack comes with a sample configuration for using AWS S3 for this. To use this configuration you must make sure the Flysystem S3 adapter is installed:
composer require league/flysystem-aws-s3-v3
Then you can edit public/index.php
to load the sample S3 dependencies:
$dependencies = require_once __DIR__.'/../bootstrap/dependencies.s3.sample.php';
You will also have to change the bootstrap/dependencies.s3.sample.php
file to use your S3 Secret and Key and change the bucket names.
ImageRack allows you to configure the server in a number of ways:
You can overwrite the default http cache max age header value (30 days):
$server->setHttpCacheMaxAge(86000); // 86000 seconds = 1 day
Setting the cache duration to zero will disable the cache by setting a Cache-Control:no-cache
header.
Templates are objects that define how an image should be manipulated. You can create multiple tempaltes to manipuate an image in different ways. Templates must implement the Diarmuidie\ImageRack\Image\TemplateInterface interface. There is a sample template provided with ImageRack for resizing images to 320ร240px.
After you create a new template it must be registered in the server:
$server->setTemplate(
'large',
function () {
return new Templates\Large();
}
);
The template name (large
in this example) must be URL safe as it is used to access images using this template i.e. example.com/large/path/to/image.jpg
.
You can set an optional "not found" response. By default a 404 header will be sent with the body "File not found". However this can be modified using the setNotFound()
method:
$server->setNotFound(function ($response) {
// Edit the response as required.
// For example here we cahnge the content
$response->setContent('Image not found.');
// Return the modified response
return $response;
});
$response
is an instance of Symfony\Component\HttpFoundation\Response
. See the Symfony HTTP-Foundation docs for more info on what you can do with the response.
You can set an optional "error" response. By default a 500 header will be sent with the body "There has been a problem serving this request". However this can be modified using the setError()
method:
$server->setError(function ($response, $exception) {
// Edit the response as required.
// For example here we add the exception message to the content
$response->setContent('An internal error occurred. ' . $exception->getMessage());
// Return the modified response
return $response;
});
$exception
is an instance of the caught exception.
$response
is an instance of Symfony\Component\HttpFoundation\Response
. See the Symfony HTTP-Foundation docs for more info on what you can do with the response.
- Initial commit.
- Require 0.2.0 release of ImageRack.
- Default to GD image library.
- Doc tidy up an improvements to examples.
- Require 0.4.0 release of ImageRack (PHP >= 5.6)
The MIT License (MIT)
Copyright (c) 2017 Diarmuid
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.