Weave Code
Laminas Barcode Laravel Package
laminas/laminas-barcode
laminas/laminas-barcode is a framework-agnostic PHP library for generating and rendering barcodes, supporting common symbologies such as Code 39, Code 128, EAN, UPC, and QR, with configurable image, PDF, and HTML renderers.
laminas/laminas-barcode is a PHP library for generating and rendering scannable 1D barcodes. It offers barcode objects for common symbologies plus flexible renderers for images, SVG, and PDF, making it suitable for invoices, labels, tickets, and other documents.
- Supports Code 128, EAN/UPC, Code 39/93, ITF-14, Codabar, Postnet, and more
- Renders to PNG/JPEG, SVG, and PDF
- Configurable size, colors, fonts, and checksums
- Integrates cleanly with Laminas components and PHP applications
Frequently asked questions about Laminas Barcode
- How do I install and use laminas/laminas-barcode in Laravel?
- Install it with composer require laminas/laminas-barcode; there is no Laravel service provider to register. Create a thin adapter or service class that builds the barcode object and renderer, then bind it in your own service provider. The image renderer needs ext-gd, and text rendering also needs FreeType. Keep Laminas classes out of controllers and jobs by depending on a small interface.
- Does laminas/laminas-barcode have a Laravel service provider or facade?
- No. It is a framework-agnostic Laminas component with no Laravel-specific provider, facade, config publishing or Blade directives. You add those yourself in a thin wrapper. A common pattern is an App\Contracts\BarcodeGenerator interface plus a LaminasBarcodeGenerator adapter bound in a BarcodeServiceProvider.
- Which barcode types does laminas/laminas-barcode support?
- It is primarily a 1D barcode library: Code128, Code39, Code93, Code25, the EAN and UPC family, ITF-14, Postnet and Royal Mail. It does not generate QR, DataMatrix or Aztec codes. If you need 2D symbologies now or soon, plan a second dependency behind the same interface.
- How do I generate and save a barcode PNG in Laravel?
- Use the image renderer with setSendHeaders(false), start output buffering, call render(), then capture the buffer with ob_get_clean(). Write those bytes with Laravel's Storage facade or return them in a response. This byte-capture pattern avoids the renderer writing directly to the HTTP output. Test it in a queue or CLI context as well as in a controller.
- How do I return a barcode image from a Laravel controller without 'headers already sent' errors?
- Do not let render() send headers and echo bytes directly inside a normal Laravel response cycle. Call setSendHeaders(false), capture the output with output buffering, and return response()->make($bytes, 200, ['Content-Type' => 'image/png']). This keeps barcode generation side-effect free and safe for queues, jobs and tests.
- Can laminas/laminas-barcode generate barcodes in PDFs?
- Yes, but the PDF renderer requires laminas/laminas-pdf and pulls in additional Laminas packages. In many Laravel applications it is cheaper and simpler to generate a PNG and embed it with dompdf, Snappy or mPDF. Choose native PDF output only if you genuinely need the library to create PDF pages itself.
- Is laminas/laminas-barcode compatible with Laravel 9, 10, 11 and 12?
- It is framework-agnostic and targets PHP 8.1+, so it should work with Laravel 9 through 12 without Laravel-specific constraints. The main compatibility concerns are ext-gd and FreeType in your Docker images, CI and production hosts. Verify the installed PHP version and extension set before rollout.
- Is laminas/laminas-barcode actively maintained and safe for production?
- The license is BSD-3-Clause, which is permissive and carries no copyleft exposure. The codebase is small and the barcode specifications are stable, so churn is low. However, the vendor signal is thin and the repository location is not confirmed, so verify commit cadence, open issues and release recency on Packagist and the actual repository before committing. Forking or vendoring is a credible fallback.
- How do I test barcode generation in Laravel?
- Capture the rendered bytes with setSendHeaders(false) and output buffering, then assert the PNG signature, dimensions and non-empty content. Avoid relying on byte-for-byte snapshots across GD versions and platforms, because output can vary. A contract-level test using a fake generator is also useful for controllers and jobs.
- What are alternatives to laminas/laminas-barcode for QR or 2D codes in Laravel?
- For QR codes, endroid/qr-code and bacon/bacon-qr-code are common PHP choices. For 1D-only needs, picqer/php-barcode-generator is another option. Keep the same BarcodeGenerator contract and add a second adapter so callers do not learn which engine rendered the image. This also lets you migrate away from laminas/laminas-barcode later without touching controllers.
Weaver
How can I help you explore Laravel packages today?