IBX-6620: Added image search criterions

[ciastektk]

Question	Answer
JIRA issue	IBX-6620
Type	feature
Target Ibexa version	v4.6
BC breaks	no

Requires:
ibexa/solr#55
https://github.com/ibexa/elasticsearch/pull/29
ibexa/rest#76

This PR adds new criteria that allows to search images.

Examples:

FileSize criterion:

Criterion to filter by image size.

min_size - Minimum file size in MB
max_size - Maximum file size in MB

new FileSize(string $fieldDefIdentifier, int $minFileSize = 0, ?int $maxFileSize = null);

Width criterion:

Criterion to filter by image width.

min_value - Minimum file size in pixels
max_value - Maximum file size in pixels

new Width(string $fieldDefIdentifier, int $minValue = 0, ?int $maxValue = null);

Height criterion:

Criterion to filter by image height.

min_value - Minimum file size in pixels
max_value - Maximum file size in pixels

new Height(string $fieldDefIdentifier, int $minValue = 0, ?int $maxValue = null);

MimeType criterion:

Criterion to filter by image mime type.

type - string or array, e.g.: image/png

new MimeType(string $fieldDefIdentifier, $type);

Orientation criterion:

Criterion to filter by image orientation.

orientation - string or array. Allowed orientation types: portrait, landscape, square.

new Orientation(string $fieldDefIdentifier, $orientation);

Dimensions criterion:

Composite criterion to filter by image dimensions.

data - allowed criteria width, height. All criteria are optional.

$data = [
    'width' => [
        'min' => 0 // (default: 0, optional),
        'max' => 1000 // (default: null, optional),
    ],
    'height' => [
        'min' => 0 // (default: 0, optional),
        'max' => 1000 // (default: null, optional),
    ],
]

new Dimensions(string $fieldDefIdentifier, array $data);

Image criterion:

Composite criterion to filter by image attributes.

data - allowed criteria mimeTypes, size,width, height,orientation. All criteria are optional.

$data = [
    'mimeTypes' => [
       'image/png'
    ],
    'orientation' => [
       'image/png'
    ],
    'width' => [
        'min' => 0 // (default: 0, optional),
        'max' => 1000 // (default: null, optional),
    ],
    'height' => [
        'min' => 0 // (default: 0, optional),
        'max' => 1000 // (default: null, optional),
    ],
    'size' => [
        'min' => 0 // (default: 0, optional),
        'max' => 2 // (default: null, optional),
    ],
];

or 

$data = [
    'mimeTypes' => 'image/png',
    'orientation' => 'image/png',
    'width' => [
        'min' => 0 // (default: 0, optional),
        'max' => 1000 // (default: null, optional),
    ],
    'height' => [
        'min' => 0 // (default: 0, optional),
        'max' => 1000 // (default: null, optional),
    ],
    'size' => [
        'min' => 0 // (default: 0, optional),
        'max' => 2 // (default: null, optional),
    ],
];

new Image(string $fieldDefIdentifier, array $data);

Checklist:

• Provided PR description.
• Tested the solution manually.
• Provided automated test coverage.
• Checked that target branch is set correctly (main for features, the oldest supported for bugs).
• Ran PHP CS Fixer for new PHP code (use $ composer fix-cs).
• Asked for a review (ping @ibexa/engineering).

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
5 Code Smells

No Coverage information
0.0% Duplication