PHPackages                             kekos/gs1 - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. kekos/gs1

ActiveLibrary[Parsing & Serialization](/categories/parsing)

kekos/gs1
=========

GS1 parser and generator for PHP

v1.0.3(9y ago)155.7k↑544.4%2MITPHPPHP >= 5.3.0

Since May 22Pushed 9y ago1 watchersCompare

[ Source](https://github.com/Kekos/gs1-php)[ Packagist](https://packagist.org/packages/kekos/gs1)[ Docs](https://github.com/Kekos/gs1-php)[ RSS](/packages/kekos-gs1/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (5)Used By (0)

GS1 parser and generator for PHP
================================

[](#gs1-parser-and-generator-for-php)

Encodes and decodes GTIN numbers (EAN-8 and EAN-13) with support for products having variable weight and price.

Install
-------

[](#install)

You can install this package via [Composer](http://getcomposer.org/):

```
composer require kekos/gs1

```

Documentation
-------------

[](#documentation)

### Locales

[](#locales)

Each member country of [GS1](http://www.gs1.org/) have their own specification for products with variable weight and price, magazines and coupons. This is handled by this library by defining encoding rules in "locales".

Currently only the `Sweden` locale is implemented.

### Generate GTIN

[](#generate-gtin)

Start by creating an entity:

```
$entity = new \Gs1\Entity\WeightProduct($sku, $weight);
$entity = new \Gs1\Entity\PriceProduct($sku, $price);
$entity = new \Gs1\Entity\Publication($sku, $price);
$entity = new \Gs1\Entity\Coupon($id, $discount);
```

Use `GtinFactory` class by specifying which locale to use:

```
$code = \Gs1\GtinFactory::get('Sweden', $entity);
echo $code;
```

### Parse GTIN

[](#parse-gtin)

Create a GTIN entity:

```
$gtin = new \Gs1\Gtin\Gtin13($code);
$gtin = new \Gs1\Gtin\Gtin8($code);
```

Use `EntityFactory` class by specifying which locale to use:

```
$entity = \Gs1\EntityFactory::get('Sweden', $gtin);
if ($entity instanceof \Gs1\Entity\WeightProduct) {
  echo 'Weight: ' . $entity->getWeight();
}
```

### Product entity

[](#product-entity)

```
$product = new \Gs1\Entity\Product($sku, $company_prefix);
$product->getSku();
$product->setSku($sku);
$product->getCompanyPrefix();
$product->setCompanyPrefix($company_prefix);
```

### Weight product entity

[](#weight-product-entity)

```
$product = new \Gs1\Entity\WeightProduct($sku, $weight);
$product->getSku();
$product->setSku($sku);
$product->getWeight();
$product->setWeight($weight);
```

### Price product entity

[](#price-product-entity)

```
$product = new \Gs1\Entity\PriceProduct($sku, $price);
$product->getSku();
$product->setSku($sku);
$product->getPrice();
$product->setPrice($price);
```

### Coupon entity

[](#coupon-entity)

```
$coupon = new \Gs1\Entity\Coupon($id, $value);
$coupon->getId();
$coupon->setId($id);
$coupon->getValue();
$coupon->setValue($value);
```

### Publication entity

[](#publication-entity)

```
$publication = new \Gs1\Entity\Publication($sku, $price);
$publication->getSku();
$publication->setSku($sku);
$publication->getPrice();
$publication->setPrice($price);
```

### GTIN-13 entity (EAN-13) and GTIN-8 entity (EAN-8)

[](#gtin-13-entity-ean-13-and-gtin-8-entity-ean-8)

When setting the code you don't have to specify the checksum (digit 8 or 13). The `Gtin` classes will add the checksum automatically if needed.

```
$gtin = new \Gs1\Gtin\Gtin8($code);
// ...or
$gtin = new \Gs1\Gtin\Gtin13($code);

$gtin->getCode();
$gtin->setCode($code);
$gtin->isValid(); // true or false
$gtin->getChecksum();
$gtin->__toString(); // magic method
```

Bugs and improvements
---------------------

[](#bugs-and-improvements)

Report bugs in GitHub issues or feel free to make a pull request :-)

License
-------

[](#license)

MIT

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~13 days

Total

4

Last Release

3644d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/914782?v=4)[Christoffer Lindahl Hassel](/maintainers/Kekos)[@Kekos](https://github.com/Kekos)

---

Top Contributors

[![Kekos](https://avatars.githubusercontent.com/u/914782?v=4)](https://github.com/Kekos "Kekos (5 commits)")

---

Tags

barcodeeangtinEAN 8EAN 13gs1

### Embed Badge

![Health badge](/badges/kekos-gs1/health.svg)

```
[![Health](https://phpackages.com/badges/kekos-gs1/health.svg)](https://phpackages.com/packages/kekos-gs1)
```

###  Alternatives

[khanamiryan/qrcode-detector-decoder

QR code decoder / reader

1.4k32.1M74](/packages/khanamiryan-qrcode-detector-decoder)[picqer/php-barcode-generator

An easy to use, non-bloated, barcode generator in PHP. Creates SVG, PNG, JPG and HTML images from the most used 1D barcode standards.

1.8k27.4M109](/packages/picqer-php-barcode-generator)[tecnickcom/tc-lib-barcode

PHP library to generate linear and bidimensional barcodes

2947.5M39](/packages/tecnickcom-tc-lib-barcode)[milon/barcode

Barcode generator like Qr Code, PDF417, C39, C39+, C39E, C39E+, C93, S25, S25+, I25, I25+, C128, C128A, C128B, C128C, 2-Digits UPC-Based Extention, 5-Digits UPC-Based Extention, EAN 8, EAN 13, UPC-A, UPC-E, MSI (Variation of Plessey code)

1.5k14.0M51](/packages/milon-barcode)[intervention/validation

Additional validation rules for the Laravel framework

6777.1M18](/packages/intervention-validation)[ronanguilloux/isocodes

PHP library - Validators for standards from ISO, International Finance, Public Administrations, GS1, Book and Music Industries, Phone numbers & Zipcodes for many countries

8043.4M26](/packages/ronanguilloux-isocodes)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)