The Wayback Machine - https://web.archive.org/web/20221221130846/https://github.com/conlect/image-iiif
Skip to content

conlect/image-iiif

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 

Latest Version on Packagist Tests Total Downloads

Image IIIF

This package implements the IIIF Image API 3.0, it is unopinionated about implementation and many of the MUST features are not included because it does not include an actual implementation only the means to create one. I consider it a bring your own framework solution for implementing Image API 3.0 with PHP. The package utilizes the Intervention Image package for manipulations. I have provided Intervention filters for each of the 5 IIIF parameters that can be used independently of the $factory()->load()->withParameters() pipeline methods.

Supports all Image Request Parameters:

  • Region (full || square || x,y,w,h || pct:x,y,w,h)
  • Size (full || max || w, || ,h || pct:n || w,h || !w,h)
  • Rotation (n || !n)
  • Quality (color || gray || default)
  • Format (jpg || tif || png || gif || webp)

Supports the info.json response for an identifier.

Laravel image route example:

Route::get('iiif/{identifier}/{region}/{size}/{rotation}/{quality}.{format}',
    function (Request $request) {
        $parameters = $request->route()->parameters();

        $file = storage_path('app/images/'.$parameters['identifier']);

        $factory = new \Conlect\ImageIIIF\ImageFactory;

        $file = $factory()->load($file)
            ->withParameters($parameters)
            ->stream();

        $response = \Response::make($file);

        $response->header('Content-Type', config("iiif.mime.{$parameters['format']}"));

        return $response;
    }
);

Laravel info route example:

Route::get('iiif/{identifier}/info.json',
    function (Request $request) {
        $file = storage_path('app/images/'.$request->identifier);

        $factory = new \Conlect\ImageIIIF\ImageFactory;

        $info = $factory()->load($file)
            ->info($request->identifier);

        return $info;
    }
);