femtopixel/crop

PHP Component to resize images from a configuration file

1.0.0 2021-02-06 22:22 UTC

Requires

• php: ^8.0

Requires (Dev)

• codeclimate/php-test-reporter: ^0.4
• phploc/phploc: ^7.0
• phpmd/phpmd: ^2.4
• phpunit/phpunit: ^9.0
• sebastian/phpcpd: ^6.0
• squizlabs/php_codesniffer: ^3.0

MIT

• Jay MOULIN

README

Caution

As-of 2021, this product does not have a free support team anymore. If you want this product to be maintained, please support my work.

Note

(This product is available under a free and permissive license, but needs financial support to sustain its continued improvements. In addition to maintenance and stability there are many desirable features yet to be added.)

Crop

This component will resize images following configuration rules. allows only defined format

Installation

composer require femtopixel/crop

Usage

<?php
$formats = array(
    'mini' => array(
        'width' => 100,
        'height' => 100,
        'full' => 'cropped',
    ),
);
$image = new \FemtoPixel\Crop\Crop('/path/to/file.png', 'mini');
$image->setFormatsFromArray($formats)->render();

You can define as many format that you want!

• First parameter is path to your file to display
• Second (optional) is the format you want to display in (default : 'original' (no modification))
• Third (optional) is path to default image displayed if path in first parameter doesn't exist. This file will be displayed in requested format. (default : 'src/missing.png')

Configuration

Each format given in method setFormatsFromArray must define width, height and optional full index.

full can be configured to 4 values depending on attended rendering :

• none : No cropping, no resize. Will render image with original file dimensions.
• cropped : Crop the rendered image to be exactly dimensions defined in configuration.
• height : Resize the image without distortion to have height to value defined in configuration.
• width : Resize the image without distortion to have width to value defined in configuration.