kartinki/kartinki

This package is abandoned and no longer maintained. No replacement package was suggested.

Simple tool for creating previews of images.

2.0.4 2016-07-26 13:00 UTC

This package is not auto-updated.

Last update: 2023-07-19 18:53:14 UTC


README

Creating image thumbnails with simple configs like "200x200", "1280x720:fit,quality=75".

Latest Stable Version Build Status License

Code Climate Scrutinizer Code Quality SensioLabsInsight

Requirements

  • PHP 5.4+, 7.0, HHVM
  • GD extension enabled

Installing

  • Add "kartinki/kartinki": "~2.0.0" to composer.json.
  • Run composer install

Simple usage example

filename.jpg is 1600x1200.

<?php

$config = [
    'square' => '200x200',
    'normal' => '400x400:fit',
    'big'    => '1280x720:fit,quality=100',
];

$result = (new kartinki\Kartinki\Thumbnailer)->createThumbnails(
    '/path/to/image/filename.jpg',
    $config,
    '/output/dir' // optional
);

Thumbnailer will place 3 files to /output/dir:

1ceebb2cf4b0425a0ea1e1cb49810a07_square.jpg // 200x200
1ceebb2cf4b0425a0ea1e1cb49810a07_normal.jpg // 400x300
1ceebb2cf4b0425a0ea1e1cb49810a07_big.jpg    // 960x720

And $result will be instanse of kartinki\Kartinki\Result:

<?php
$result->getThumbnails();
// [
//     'square' => '1ceebb2cf4b0425a0ea1e1cb49810a07_square.jpg',
//     'normal' => '1ceebb2cf4b0425a0ea1e1cb49810a07_normal.jpg',
//     'big'    => '1ceebb2cf4b0425a0ea1e1cb49810a07_big.jpg'
// ]
 
$result->getUniqueId();
// '1ceebb2cf4b0425a0ea1e1cb49810a07'

$result->getExtension();
// 'jpg'

Versioning

From version 1.0.0 kartinki uses Semantic Versioning.