Download the PHP package milon/barcode without Composer

Barcode generation for Laravel and plain PHP. This package wraps the TCPDF barcode engines (1D + QR / Data Matrix / PDF417) behind a small API that returns SVG, HTML, PNG, and JPEG.

Requires the PHP GD extension (ext-gd).

Full docs: oss.milon.im/barcode

Examples below are real outputs from this library. Regenerate them with:

Installation

Laravel compatibility

Laravel 6+ auto-discovers the service provider and facades (DNS1D, DNS2D).

Publish config (optional)

Default store path is the Laravel storage directory (used by *Path helpers). Ensure the directory is writable.

Quick start

Blade

Always use {!! !!} (unescaped). PNG helpers return raw base64, not a full data: URL:

Units: $w and $h

Larger $w / $h = larger image. Typical starting points:

• 1D labels: $w = 2–3, $h = 50–80
• QR for screen: $w = $h = 4–8
• QR for print: $w = $h = 8–12

Output methods

Common options

1D (DNS1D)

2D (DNS2D)

• $color — RGB foreground [r, g, b] (SVG/HTML use CSS color strings)
• $showCode — print human-readable text under 1D bars
• $bgcolor — RGB background, or null for transparent (default)
• $filename — optional custom file name for *Path helpers (extension optional; path segments are stripped)

Quiet zone (padding) for print / scanners

Printed barcodes often fail to scan when bars sit flush against the page edge or other graphics. Add a quiet zone with setPadding() (pixels on every side):

SVG output also sets shape-rendering="crispEdges" to reduce print-time anti-alias blur.

QR logo (centered)

Overlay a logo on QR / Datamatrix PNG output (GD). Use high error correction (QRCODE,H) and keep the logo modest (~15–25% of width) so scanners still read the code.

Retail UPC-A / EAN layout

EAN-8, EAN-13, UPC-A, and UPC-E now use taller guard bars and, when $showCode is enabled, split human-readable digits (number system / left / right / check) instead of one centered string.

Background color (dark UI / email)

Transparent PNGs disappear on dark backgrounds. Pass a white (or light) $bgcolor:

Examples (with screenshots)

CODE 39

CODE 39+

CODE 128

CODE 128A / 128B / 128C

EAN-13 / EAN-8 / UPC-A

Interleaved 2 of 5 / Codabar / Pharmacode

Custom bar color

QR Code / Data Matrix / PDF417

Browse all generated samples: docs/examples/gallery.html

Regenerate images + gallery:

Symbology character sets

Invalid input throws Milon\Barcode\InvalidBarcodeException with a hint for the chosen type.

Prefer C128 (auto) unless you specifically need A/B/C.

Also supported (1D)

C39+, C93, S25, S25+, I25+, GS1-128, EAN2, EAN5, MSI, MSI+, POSTNET, PLANET, RMS4CC, KIX, IMB, CODE11, PHARMA2T

Standalone PHP (no Laravel)

Laravel is optional. Without a container, the store path defaults to the system temp directory (or whatever you set):

Use the instance API (or the Laravel facade). Calling DNS2D::getBarcodePNG() as a static method on the class itself will not work.

FAQ

Why is my Blade barcode empty / escaped HTML?
Use {!! DNS1D::getBarcodeHTML(...) !!}, not {{ }}.

Why is the <img> broken?
PNG helpers return base64 only. Prefix with data:image/png;base64,.

Barcode works in light mode but not dark mode / email?
Pass a solid $bgcolor, e.g. [255, 255, 255].

Printed barcode won’t scan reliably?
Add a quiet zone (setPadding(...)), use a larger $w (avoid $w = 1 for print), and prefer SVG/PNG over scaled-down screen captures. See Quiet zone.

InvalidBarcodeException?
The payload does not match the symbology (see table above). Switch type or sanitize input.

Can this package scan barcodes from a camera?
No. It only generates barcodes. Scanning needs a separate library or device SDK.

Can it authenticate users / replace login?
No. Generating a QR of a URL or token is not authentication by itself.

License

GNU LGPLv3. Copyright Nuruzzaman Milon. Original barcode classes by Nicola Asuni / Tecnick.com LTD (TCPDF).

Buy me a coffee