ayeo/gs1_barcode

Generate GS1-128 standard barcode


Keywords
barcode, gs1, gs1-128, barcode-generator, gs1-barcode-generator, gs1-databar
License
MIT

Documentation

GS1 barcode generator

The library generates GS1 barcode. Currently supported formats: GS1 128.

Install

Note that library requires both GD and Free Type extensions installed

composer require ayeo/gs1_barcode:1.0.4

Usage

The simplest example:

use Ayeo\Barcode;

$builder = new Barcode\Builder();
$builder->output('(10)123456(400)11');

This will generate png image using black and white and default font

barcode

Custom barcode:

use Ayeo\Barcode;

$builder = new Barcode\Builder();
$builder->setBarcodeType('gs1-128');
$builder->setFilename('barcode.png');
$builder->setImageFormat('png');
$builder->setWidth(500);
$builder->setHeight(150);
$builder->setFontPath('FreeSans.ttf');
$builder->setFontSize(15);
$builder->setBackgroundColor(255, 255, 255);
$builder->setPaintColor(0, 0, 0);

Finally, you can use the output method to stream the image directly to the web browser.

$builder->output('(10)123456(400)11');

If you want to save the image file, you can use the saveImage method instead.

$builder->saveImage('(10)123456(400)11');

Both output() and saveImage() methods has additional boolean parameters to determine if label should be included on the print. Default value is true.

$builder->output('(10)123456(400)11', $withLabel = false);
$builder->saveImage('(10)123456(400)11', $withLabel = false);

Actually generate the same barcode because all params all set to default values. This shows only available settings

Fluent interface is welcome

use Ayeo\Barcode;

Barcode\Builder::build()->setWidth(600)->setBackgroundColor(100, 100, 100)->output('(10)123456(400)11');

Additional info

  • Supported image formats: png, jpg
  • Barcode must be valid GS1 barcode

Contributing

Everyone is welcome, feel free to join. There is Dockerfile included for ease of developemnt. The image consist of php5.6 with GD and FreeType extensions. It also contains composer and xdebug. To build the image locally use

docker build -t php-gs1 .

Supported identifiers

The goal is to support all existing gs1 application identifiers but at the moment I have added only those I needed. Feel free to add or request some. Full list is here

Code Name Min length Max length
00 SERIAL SHIPPING CONTAINER CODE 18 18
01 GLOBAL TRADE ITEM NUMBER 14 14
02 ITEM TRADE ITEM NUMBER 14 14
10 BATCH NUMBER 1 20
12 PAYMENT DATE (YYMMDD) 6 6
15 BEST BEFORE DATE (YYMMDD) 6 6
17 EXPIRATION DATE (YYMMDD) 6 6
37 NUMBER OF UNITS CONTAINED 1 8
3301 CONTAINER GROSS WEIGHT (KG) 6 6
390(n) AMOUNT PAYABLE - SINGLE MONETARY AREA 1 15
400 CUSTOMER PURCHASE ORDER NUMBER 1 30
415 GLOBAL LOCATION NUMBER OF THE INVOICE PARTY 13 13
8020 PAYMENT SLIP REFERENCE NUMBER 1 25
96 COMPANY INTERNAL INFORMATION 1 30