mvdnbrk/gtin

GTIN / EAN / UPC Validation for Laravel

GTIN / EAN / UPC Validation for Laravel

![Latest Version on Packagist][ico-version] [![Tests][ico-tests]][link-tests] ![Code style][ico-code-style] , _(*1)

Extension for the Laravel validation class., _(*2)

Installation

You can install the package via composer:, _(*3)

$ composer require mvdnbrk/gtin

Usage

Now you can use the gtin validation to validate a GTIN-8, GTIN-12, GTIN-13 or GTIN-14:, _(*4)

$this->validate($request, [
    'somefield' => 'gtin',
]);

Specifying a custom error message

You may publish the language files with the following artisan command:, _(*5)

php artisan vendor:publish --tag=gtin-lang

Now you can customize the error message in resources/lang/vendor/gtin/{loale}/validation.php., _(*6)

Another option is to define the error message by adding your message to the custom array in the resources/lang/{locale}/validation.php language file., _(*7)

'custom' => [
    'somefield' => [
        'gtin' => 'Please enter a valid GTIN!',
    ],
],

Or with a JSON file stored in resources/lang/{locale}.json, _(*8)

{
    "validation.custom.somefield.gtin": "Please enter a valid GTIN!"
}

Or you may pass custom messages as the third argument to the Validator::make method as described in the Laravel documentation., _(*9)

Helper function

This package exposes a is_gtin() helper function to quickly validate a GTIN.
It will return a boolean whether the given value is a valid GTIN or not:, _(*10)

is_gtin('1300000000000')    // returns true
is_gtin('1234567891234')    // returns false

Migrations

This package contains a helper method to create a GTIN column in your database table:, _(*11)

Schema::table('products', function (Blueprint $table) {
    $table->gtin();
});

If you would like to customize the column name and/or length you may pass these as parameters:, _(*12)

$table->gtin('ean13', 13);

To drop the column you may use the dropGtin method:, _(*13)

Schema::table('products', function (Blueprint $table) {
    $table->dropGtin();

    // $table->dropGtin('ean13');
});

Testing

$ composer test

Contributing

Please see CONTRIBUTING for details., _(*14)

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities., _(*15)

Credits

• Mark van den Broek
• All Contributors

License

The MIT License (MIT). Please see License File for more information., _(*16)