How to create Barcode on PDF in Magento 2.3.x

How to create Barcode on PDF in Magento 2.3.x

September 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to create Barcode on PDF in Magento 2.3.x

Creating Barcode on PDF in Magento 2.3.x: A Comprehensive Guide

In this blog post, we will address a common issue faced by developers working with Magento 2.3.x - creating barcodes on PDF files using the Zend_Barcode component. We’ll provide a step-by-step solution to resolve the error you’re encountering and help you generate the desired PDF output.

The Error and Current Code Structure

You’ve shared the relevant code from your custom Custom helper class, which is designed to create an order confirmation PDF with a barcode. However, when executed in Magento 2.3.x, it throws a fatal error due to a type mismatch. The error message suggests that the argument passed to the setResource() method must be an instance of ZendPdf\PdfDocument, but you’re providing an instance of Zend_Barcode_Renderer_Pdf.

Let’s dive into the code and understand the issue:

// ...
Barcode::setBarcodeFont($this->_fontPath.'helvetica-normal.ttf');
$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
$rendererOptions = array();
$renderer = Barcode::factory('code128', 'pdf', $barcodeOptions, $rendererOptions);
$renderer->setResource($pdf, $page)->draw();

// ...

The problem lies in this section of the code. You’re using the Barcode class to create a barcode renderer and then calling its setResource() method with two arguments: $pdf (an instance of \Zend_Pdf) and $page (an instance of \Zend_Pdf_Page).

The Solution: Updating Zend_Barcode Component

To resolve this issue, we need to update the way we handle the barcode generator in Magento 2.3.x.

Firstly, let’s ensure that you have the latest version of the zendFramework package installed in your project’s composer.json file:

"require": {
    // ...
    "zendframework/zendframework": "^2.4"
}

After updating the zendframework dependency, clear your project cache using the following command in the terminal:

php bin/magento setup:upgrade

This will ensure that you’re using the updated Zend_Barcode component which is compatible with Magento 2.3.x.

Updating the Custom Helper

Now let’s update the getOrderConfirmationPdf() method in your custom helper to reflect these changes:

public function getOrderConfirmationPdf($order)
{
    try {
        $pdf = new \Zend_Pdf();
        $page = new \Zend_Pdf_Page(\Zend_Pdf_Page::SIZE_A4);

        // ... (Other code for generating the PDF content remains unchanged)

        Barcode::setBarcodeFont($this->_fontPath.'helvetica-normal.ttf');
        $barcodeOptions = array('text' => $order->getIncrementId());
        $rendererOptions = array();
        $renderer = Barcode::factory('code128', 'pdf', $barcodeOptions, $rendererOptions);
        $renderer->setResource($page)->draw();

        // ... (Rest of the code for rendering and returning the PDF)

    } catch(Exception $e) {
        mail("rdambare@test.com","ORDER CONFIRMATION PDF ERROR: ".$order->getIncrementId(),$e->getMessage);
        return FALSE;
    }
}

The key change is in this line:

$renderer->setResource($page)->draw();

We’ve removed the $pdf argument from the setResource() method and passed only the $page instance. This ensures that we’re using the correct type for the resource.

Testing the Updated Code

After making these changes, clear your project cache again:

php bin/magento cache:clean

Then trigger the relevant code in your custom module to generate the order confirmation PDF. You should now be able to create the desired PDF output with a barcode without encountering any errors.

Conclusion

In this blog post, we’ve addressed a common issue faced by Magento 2 developers and provided a step-by-step solution for creating barcodes on PDF files using the Zend_Barcode component.

Remember, keeping your project dependencies up-to-date is crucial when working with Magento. Regularly review and update your composer.json file to ensure you’re using compatible versions of third-party libraries.

For more advanced customizations and troubleshooting in Magento development, feel free to explore our website for comprehensive guides and resources tailored to the Magento ecosystem.

Happy coding!

Magento 2 Orders Errors

Our network