real-digital / gtin-validator
Real GTIN Validator
Installs: 217 693
Dependents: 1
Suggesters: 0
Security: 0
Stars: 16
Watchers: 6
Forks: 11
Open Issues: 0
Requires
- php: >=7.1
Requires (Dev)
- phpstan/phpstan: ^0.12.92
- phpunit/phpunit: ^7.3 || ^8.0 || ^9.0
- slevomat/coding-standard: ^7.0
- squizlabs/php_codesniffer: ^3.6
- vimeo/psalm: ^4.8
README
A GTIN is a string of digits that uniquely identifies a trade item (a product that is bought and sold). A GTIN is globally unique, meaning that no two products in the world share the same GTIN.
This library provides a straightforward way by which a number can be determined to be a valid GTIN or suspected of being invalid in some way.
Installation
via Composer
$ composer require real-digital/gtin-validator
via GitHub
$ git clone https://github.com/real-digital/gtin-validator.git
Usage
<?php use Real\Validator\Gtin; // create a valid GTIN $value = '4006381333931'; $gtin = Gtin\Factory::create($value); // handle errors $value = 'any invalid value'; try { $gtin = Gtin\Factory::create($value); } catch (Gtin\NonNormalizable $e) { // ... } // check whether GTIN is valid $value = '4006381333931'; $isValid = Gtin\Factory::isValid($value);
GTIN interface overview
Each created GTIN implements a common interface. This is a complete list of its methods:
Testing
$ composer tests
License
Real GTIN Validator is licensed under The Apache License 2.0. Please see LICENSE for details.
Changelog
Please see CHANGELOG for more information.