PHPackages                             kankro/simple-gtin-validator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation & Sanitization](/categories/validation)
4. /
5. kankro/simple-gtin-validator

ActiveLibrary[Validation & Sanitization](/categories/validation)

kankro/simple-gtin-validator
============================

Validates GTIN (Global Trade Item Number) codes by calculating checksums.

v1.0.5(1mo ago)124Apache-2.0PHPPHP >=7.4

Since Oct 13Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/Kankro/simple-gtin-validator)[ Packagist](https://packagist.org/packages/kankro/simple-gtin-validator)[ RSS](/packages/kankro-simple-gtin-validator/feed)WikiDiscussions main Synced 4w ago

READMEChangelog (1)DependenciesVersions (8)Used By (0)

simple-gtin-validator
=====================

[](#simple-gtin-validator)

Lightweight PHP library for validating GTIN (Global Trade Item Number) values and generating check digits.

GTIN is the umbrella format behind common barcode identifiers such as GTIN-8, UPC, EAN, and GTIN-14. This package normalizes the input, applies prefix filtering, and verifies the checksum used by the GTIN standard.

Contents
--------

[](#contents)

- [Requirements](#requirements)
- [Installation](#installation)
- [What the library does](#what-the-library-does)
- [Quick start](#quick-start)
- [Working flow](#working-flow)
- [API reference](#api-reference)
- [Usage examples](#usage-examples)
- [Prefix filtering](#prefix-filtering)
- [Development workflow](#development-workflow)
- [Limitations](#limitations)
- [License](#license)
- [Credits](#credits)

Requirements
------------

[](#requirements)

- PHP 7.4 or later
- Composer for installation and autoloading

Installation
------------

[](#installation)

Install the package with Composer:

```
composer require kankro/simple-gtin-validator
```

Then load Composer's autoloader in your project:

```
require __DIR__ . '/vendor/autoload.php';
```

What the library does
---------------------

[](#what-the-library-does)

The `GtinValidator` class provides two public operations:

- `isValidGtin($code)` validates a GTIN-style value
- `addCheckDigit($code)` appends a GTIN check digit to an incomplete code

Supported GTIN lengths for validation:

- GTIN-8
- GTIN-12
- GTIN-13
- GTIN-14

Accepted input styles:

- Numeric strings such as `'036000291452'`
- Strings containing hyphens such as `'978-0-552-13326-5'`
- Numeric values such as `884571375091`

Inputs are normalized before validation: numeric values are cast to strings, and hyphens are removed from string inputs.

Quick start
-----------

[](#quick-start)

```