antwerpes/barcodes-1d

Library for programmatically creating and rendering barcodes

Maintainers

Details

github.com/antwerpes/barcodes-1d

Homepage

Source

Issues

Installs: 71

Dependents: 0

Suggesters: 0

Security: 0

Stars: 24

Watchers: 3

Forks: 4

Open Issues: 2

1.4.1 2024-06-07 14:11 UTC

Requires

Requires (Dev)

MIT fad639c6ac9b7f4f716b66cb467f452ee060503e

  • Elisha Witte <opensource.woop@antwerpes.com>

barcodesEAN13upccode128antwerpes

This package is auto-updated.

Last update: 2024-12-07 15:17:01 UTC

README

Logo

Packagist Code Style Downloads License

Barcodes 1D

Barcode generator written in PHP for encoding and rendering most common barcode formats to multiple image output formats.

Features

  • Supports most common barcode formats (Code128, EAN, UPC, ...)
  • Can render to SVG, PNG, JPG or WEBP using GD
  • Images (PNG/JPG/WEBP) may be configured to scale up to any size
  • Supports common customization requirements (size, color, text display, font size, background color, font for image rendering, or format-specific options such as guard bars or quiet zones)

Supported barcodes

Installation

Install the package via composer:

composer require antwerpes/barcodes-1d

Usage

Use the Barcodes factory class to create an encoder and render its output to SVG or a base64-encoded image:

use Antwerpes\Barcodes\Barcodes;
use Antwerpes\Barcodes\Enumerators\Format;

// SVG
$svg = Barcodes::create('12345678', Format::CODE_128);
file_put_contents('img.svg', $svg);

// Or as an image
$image = Barcodes::create('12345678', Format::CODE_128, 'png');
file_put_contents('img.png', base64_decode($image));

// Example for scaled up (4x) WEBP
$image = Barcodes::create('12345678', Format::CODE_128, 'webp', [
    'image_scale' => 4,
]);
file_put_contents('img.webp', base64_decode($image));

Customization

Check out the options for an overview of all customization options.

Examples

Code 128

Code 128

Barcodes::create('A12345', Format::CODE_128);

EAN-13

EAN-13 EAN-13 Flat EAN-13 Quiet Zone

Barcodes::create('5901234123457', Format::EAN_13);
Barcodes::create('5901234123457', Format::EAN_13, 'svg', ['flat' => true]);
Barcodes::create('5901234123457', Format::EAN_13, 'svg', ['with_quiet_zone' => true]);

EAN-2 / EAN-5 / EAN-8

EAN-2 EAN-5 EAN-8

Barcodes::create('53', Format::EAN_2);
Barcodes::create('52495', Format::EAN_5);
Barcodes::create('96385074', Format::EAN_8);

UPC-A / UPC-E

UPC-A UPC-E

Barcodes::create('123456789999', Format::UPC_A);
Barcodes::create('01245714', Format::UPC_E);
// These also work and will produce the same result
Barcodes::create('124571', Format::UPC_E);
Barcodes::create('01210000457', Format::UPC_E);
Barcodes::create('012100004574', Format::UPC_E);

Codabar

Codabar

Barcodes::create('A12345B', Format::CODABAR);

Code 11

Code 11

Barcodes::create('01234-5678', Format::CODE_11);

Code 2 of 5 / Code 2 of 5 Interleaved / ITF-14

Code 25 Code 25 Interleaved ITF-14

Barcodes::create('1234567', Format::CODE_25);
Barcodes::create('12345670', Format::CODE_25_INTERLEAVED);
Barcodes::create('98765432109213', Format::ITF_14);

Code 39 / Code 93

Code 39 Code 93

Barcodes::create('AB12', Format::CODE_39);
Barcodes::create('TEST93', Format::CODE_93);

MSI

MSI

Barcodes::create('8052', Format::MSI);

Pharmacode

MSI

Barcodes::create('1234', Format::PHARMACODE);

Options

Generic options for all barcode formats:

There are additional options for some barcode formats:

Code128

EAN-8 / EAN-13 / UPC-A / UPC-E

Code39

Code39

MSI

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

License

The MIT License (MIT). Please see License File for more information.

Acknowledgements