Real GTIN Validator
, (*1)
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., (*2)
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., (*3)
Installation
via Composer, (*4)
``` bash
$ composer require real-digital/gtin-validator, (*5)
via GitHub
``` bash
$ 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:, (*6)
Method |
Type |
Functionality |
checkDigit() |
integer |
Retrieve the rightmost digit called the "Check Digit" |
indicator() |
integer |
Retrieve the "Indicator" component |
key() |
string |
Retrieve GTIN value having a length corresponding to its variation |
length() |
integer |
Retrieve length of the variation |
origin() |
string |
Retrieve an origin value used for GTIN creation |
padded() |
string |
Retrieve key padded to 14 digits |
prefix() |
string |
Retrieve GS1 Prefix |
variation() |
string |
Retrieve variation name |
Testing
bash
$ composer tests
, (*7)
License
Real GTIN Validator is licensed under The Apache License 2.0. Please see LICENSE for details., (*8)
Changelog
Please see CHANGELOG for more information., (*9)