Download the PHP package tecnickcom/tc-lib-barcode without Composer

tc-lib-barcode

PHP library for generating linear, 2D and postal barcodes.

💖 Part of the tc-lib-pdf / TCPDF ecosystem (100M+ installs). Sponsor its maintenance →

Overview

tc-lib-barcode is a pure-PHP library that encodes data in 73 linear, 2D and postal barcode formats and outputs them as SVG, PNG, HTML, text grids, GD images or arrays of bar coordinates.

Why this library

• One API for every format. getBarcodeObj() returns the same object for a UPC-A and a Han Xin Code; the same getInlineSvgCode(), getPngData(), getGrid() and getArray() methods work across all 73 types.
• Pure PHP, one runtime dependency. Only tecnickcom/tc-lib-color, plus the gd, ctype and pcre extensions. bcmath and imagick are optional accelerators, never required.
• Written to the published standards. Each symbology follows its own published specification, named alongside the format where one applies.
• Covered by tests. Per-format encoding, ECC, size and input-validation suites, run under strict static analysis on every commit.
• LGPL-3.0. Usable in closed-source applications.
• Maintained. Part of the tc-lib-pdf / TCPDF ecosystem, in continuous development since 2015.

Supported Formats

Linear

2D

Postal

Output Formats

• SVG image (file, inline code, or standalone document)
• PNG image (via GD or Imagick)
• GD image object
• HTML div elements
• Character grid string
• Array of bar coordinates

Width, height, padding, foreground and background color are set per barcode.

Requirements

• PHP 8.2 or later
• Extensions: gd
• Optional extensions: bcmath (speeds up the arbitrary precision arithmetic used by the IMB and PDF417 types, a pure-PHP implementation is used when it is missing)
• Composer

Installation

Quick Start

For more formats and rendering options, see the example/ directory.

Development

To preview the example app in a browser:

Then open http://localhost:8000/ (served from the example/ directory).

To use a different port:

Build artifacts and reports are generated in target/.

Packaging

For system packages, bootstrap with:

Identifiers issued by a registration body

The library encodes the data it is given. Several formats carry a number that only its registration body can issue, so a symbol is valid in its scheme only once that number has been obtained:

Trademarks

The names below identify the symbologies this library encodes and belong to their respective owners. They are used descriptively; no affiliation with or endorsement by their owners is claimed or implied.

GS1 licenses the claims necessary to implement its standards under its IP Policy, to GS1 members and to the participants of the work group that developed the standard, rather than to the public at large.

Contributing

Contributions are welcome. Please read SECURITY.md before submitting a pull request.