cviebrock / image-validator
Custom Laravel Validator for image dimensions - abandoned since these are now built in to Laravel 5.2 and later
Installs: 449 626
Dependents: 8
Suggesters: 3
Security: 0
Stars: 224
Watchers: 8
Forks: 53
Open Issues: 0
Requires
- php: >=5.6.4
- illuminate/config: ^5.4
- illuminate/database: ^5.4
- illuminate/support: ^5.4
Requires (Dev)
- friendsofphp/php-cs-fixer: ^1.11
- mockery/mockery: ^0.9.4
- orchestra/testbench: ^3.4
- phpunit/phpunit: ~5.7
- scrutinizer/ocular: ^1.3
README
Extra validation rules for dealing with images in Laravel 5.
NOTE: As of Laravel version 5.2, there are now built-in validation rules for image dimensions and aspect ratios. This package is not required and will no longer be maintained.
Installation
NOTE: Depending on your version of Laravel, you should install a different version of the package:
Laravel Version Package Version 4.* 1.x 5.0–5.3 2.1† 5.4 2.2† 5.5 not supported† † Laravel 5.2 and later have built-in validation rules for image dimensions.
Install the package through Composer.
composer require "cviebrock/image-validator"
Add the following to your providers
array in app/config/app.php
:
'providers' => [ ... \Cviebrock\ImageValidator\ImageValidatorServiceProvider::class, ],
Usage
Use it like any Validator
rule. The package offers two rules for image validation:
image_size
$rules = [ 'my_image_field' => 'image_size:<width>[,<height>]', ];
The values for width and _height can be integers, or integers with a modifier prefix:
300
or=300
means the dimension must be exactly 300 pixels.<300
means the dimension must be less than 300 pixels<=300
means the dimension must be less than or equal to 300 pixels>300
means the dimension must be greater than 300 pixels>=300
means the dimension must be greater than or equal to 300 pixels200-300
means the dimension must be between 200 and 300 pixels (inclusive)*
means the dimension can be any value
If you only pass one value, it's assumed to apply to both dimensions (i.e. a square image with the given dimensions).
image_aspect
$rules = [ 'my_image_field' => 'image_aspect:<ratio>', ];
The value for ratio represents width ÷ height and be either a decimal or two values (width, height; both integers):
0.75
3,4
The value (or first value, if providing height and width) can also be prefixed
with a tilde ~
character, in which case the orientation does not matter:
~3,4
means the image can have an aspect ratio of either 3:4 or 4:3.
Note that you may run into issues with floating point rounding.
Examples
// logo must be 300px wide by 400px tall $rules = [ 'logo' => 'required|image|image_size:300,400', ]; // logo must be less than or equal to 300x300px. $rules = [ 'logo' => 'required|image|image_size:<=300', ]; // logo must be 300px wide but can be any height $rules = [ 'logo' => 'required|image|image_size:300,*', ]; // logo must be at least 100px tall and 200-300 pixels wide (inclusive) $rules = [ 'logo' => 'required|image|image_size:>=100,200-300', ]; // logo must be square $rules = [ 'logo' => 'required|image|image_aspect:1', ]; // logo must be ready for the big screen TV :) $rules = [ 'logo' => 'required|image|image_aspect:16,9', ];
Bugs, Suggestions and Contributions
Thanks to everyone who has contributed to this project!
Please use Github for reporting bugs, and making comments or suggestions.
See CONTRIBUTING.md for how to contribute changes.
Copyright and License
image-validator was written by Colin Viebrock and is released under the MIT License.
Copyright 2013 Colin Viebrock
Thanks
Lots of thanks to https://bitbucket.org/hampel/validate-laravel for the structure of creating a package to add validator rules to Laravel, and setting up useful unit tests.