如何通过PHP或CUPS在Zebra ZT411打印机上打印PDF文件

Zebra ZT411原生仅支持ZPL等条码指令，不直接解析PDF。以下提供两种可行的实现方案：

方案一：PHP将PDF转ZPL后直接打印 #

利用图像处理工具将PDF转为单色位图，再将位图数据封装为ZPL指令，沿用你现有9100端口打印逻辑。

前置依赖 #

• 安装ImageMagick工具
• 安装PHP的Imagick扩展

实现代码 #

// 1. 将PDF转为黑白单色PNG
$pdfPath = 'path/to/target.pdf';
$imagick = new Imagick();
$imagick->readImage($pdfPath);
// 仅处理PDF第一页，多页需循环处理
$imagick->setIteratorIndex(0);
$imagick->setImageFormat('png');
$imagick->setImageColorspace(Imagick::COLORSPACE_GRAY);
$imagick->thresholdImage(0.5); // 黑白阈值转换
$tempImgPath = 'temp_label.png';
$imagick->writeImage($tempImgPath);
$imagick->clear();
$imagick->destroy();

// 2. 将位图转为ZPL兼容的二进制数据
$image = imagecreatefrompng($tempImgPath);
$width = imagesx($image);
$height = imagesy($image);
$bytesPerLine = ceil($width / 8); // 每行字节数（8位为1字节）
$totalBytes = $bytesPerLine * $height;

$rawData = '';
for ($y = 0; $y < $height; $y++) {
    $lineBytes = '';
    for ($xByte = 0; $xByte < $bytesPerLine; $xByte++) {
        $byte = 0;
        for ($bit = 0; $bit < 8; $bit++) {
            $xPos = $xByte * 8 + $bit;
            if ($xPos < $width) {
                $pixelColor = imagecolorat($image, $xPos, $y);
                $grayValue = ($pixelColor >> 16) & 0xFF;
                // 黑色像素对应ZPL的1位
                if ($grayValue < 128) {
                    $byte |= (1 << (7 - $bit));
                }
            }
        }
        $lineBytes .= chr($byte);
    }
    $rawData .= $lineBytes;
}
imagedestroy($image);
unlink($tempImgPath);

// 3. 压缩数据并生成完整ZPL指令
$compressedData = gzcompress($rawData);
$hexData = bin2hex($compressedData);
$zplCommand = "^XA^FO0,0^GF,L," . $totalBytes . "," . $totalBytes . "," . $bytesPerLine . "," . $hexData . "^FS^XZ";

// 4. 发送到打印机（复用原有ZPL打印逻辑）
$printerIp = '你的打印机IP';
$fp = @pfsockopen($printerIp, 9100, $errno, $errstr);
if ($fp) {
    fputs($fp, $zplCommand);
    fclose($fp);
} else {
    echo "打印机连接失败: $errstr ($errno)";
}

方案二：通过CUPS配置打印机实现PDF打印 #

配置CUPS服务将PDF转为打印机支持的格式，再发送打印任务。

配置步骤 #

1. 安装并启动CUPS：
   Linux系统执行：

   sudo apt-get install cups
   sudo systemctl start cups
   sudo systemctl enable cups
   

   访问localhost:631进入CUPS管理界面。

2. 添加ZT411打印机：

   • 进入「Administration」→「Add Printer」
   • 选择网络连接方式：AppSocket/HP JetDirect，输入地址socket://打印机IP:9100
   • 选择驱动：优先用Zebra官方提供的CUPS驱动，或通用的Zebra ZPL Label Printer驱动
   • 设置默认纸张尺寸（需匹配你的标签规格）

3. 测试打印：
   命令行执行：

   lp -d 打印机队列名称 path/to/target.pdf
   

PHP调用CUPS打印代码 #

$pdfPath = 'path/to/target.pdf';
$printerQueue = 'ZT411_Printer'; // 替换为你的CUPS打印机队列名

// 构造打印命令，转义路径避免空格问题
$command = "lp -d $printerQueue " . escapeshellarg($pdfPath);
exec($command, $output, $returnCode);

if ($returnCode === 0) {
    echo "PDF打印任务已提交";
} else {
    echo "打印失败: " . implode("\n", $output);
}

常见问题排查 #

• CUPS打印失败：检查打印机队列是否激活，PHP运行用户（如www-data）是否拥有打印权限，可将用户加入lpadmin组
• PDF转ZPL后尺寸异常：调整Imagick的图片缩放参数，确保适配打印机标签宽度

内容的提问来源于stack exchange，提问作者Iteam-Schneider