Download the PHP package webcooking/zpl-to-image without Composer

On this page you can find all versions of the php package webcooking/zpl-to-image. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of webcooking/zpl-to-image

Informations about the package zpl-to-image

ZPL to Image Converter

A PHP library to convert ZPL (Zebra Programming Language) content into images. Generates SVG output with support for TrueType fonts and GDImage conversion.

Features

This library provides 3 types of ZPL conversion:

Requirements

Installation

Clone the repository and run Composer install:

Usage

Method 1: Generate SVG (Recommended)

Available Fonts

Built-in fonts:

Custom fonts:

Method 2: Convert to GDImage (Raster with Imagick)

Method 3: Direct File Export (PNG/JPEG)

Method 4: Get an Imagick object directly

If you prefer to work with Imagick directly (for advanced processing, composites or filters), use ZplToImagick which returns an Imagick object.

Font Comparison

Font Style File Size
Noto Sans Modern, clean ~1.9 MB
IBM VGA Retro, pixel style ~35 KB

Testing

Run the example test scripts:

See the examples/ folder for more details.

Creating your own tests

  1. Create a .zpl file in the examples/ folder
  2. Test it: php examples/test.php your_file.zpl

Docker testing

A Docker environment is provided for consistent testing with all dependencies:

The Docker environment includes rsvg-convert for reliable rasterization, solving potential blank image issues.

Supported ZPL Commands

Currently supports:

More commands can be added as needed.

Troubleshooting

Issue: Blank/White JPG Images

Problem: Generated JPEG/PNG images appear completely white or blank, even though SVG output is correct.

Cause: Some Imagick installations don't properly handle SVG files with embedded fonts (data URLs in @font-face rules).

Solution: The library detects and uses rsvg-convert when available. All classes automatically use the best available renderer:

  1. Install rsvg-convert (recommended):

  2. Docker setup (if using containerization):

  3. Verify installation:

When rsvg-convert is available, the library automatically uses it for SVG rasterization, providing much better compatibility with embedded fonts and complex SVG elements. If rsvg-convert is not available, it falls back to direct Imagick conversion.

Resources

License

Project: LGPL-3.0-or-later

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

Fonts:

Support

If you use this package in a commercial or paid project and find it helpful, I'd be grateful if you considered offering a small token of thanks : https://ko-fi.com/nuranto

No pressure — this is only if the library saved you time and you feel like supporting future work.

All versions of zpl-to-image with dependencies

PHP Build Version
Package Version
Requires php Version >=8.0
dompdf/php-svg-lib Version ^1.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package webcooking/zpl-to-image contains the following files

Loading the files please wait ...