如何从PHP应用打印物理收据？mike42/escpos-php助你轻松搞定

王林

发布时间：2025-07-22 14:18:03

1016人浏览过

来源于php中文网

原创

最近在开发一个处理用户提交数据的程序时，遇到了一个棘手的问题：用户输入的文本中包含各种非ASCII字符，例如中文、日文、特殊符号等等。这些字符导致程序在处理字符串时效率低下，甚至出现错误。为了解决这个问题，我尝试了多种方法，最终找到了voku/portable-ascii这个库。 Composer在线学习地址：学习地址

痛点：PHP 应用如何与物理收据打印机对话？

想象一下，你正在为一家咖啡馆开发一套基于web的pos系统。顾客点完单，你点击“打印收据”按钮，期望一台物理打印机能立刻吐出一张漂亮的收据。然而，作为一名php开发者，你很快就会发现，这不像在浏览器里echo一个字符串那么简单。

传统的Web应用运行在服务器端，而收据打印机通常通过USB、串口、并口或以太网连接在客户端（收银台电脑）或局域网内。PHP本身无法直接“感知”并控制这些物理设备。这意味着：

通信障碍： 如何让服务器端的PHP代码，向客户端的物理打印机发送指令？
协议复杂： 热敏打印机通常遵循ESC/POS协议，这是一套低级指令集，用于控制文本格式、图片打印、条形码生成、切纸等。手动拼接这些指令字符串简直是噩梦。
兼容性挑战： 不同的打印机型号、不同的操作系统（Windows、Linux、macOS）以及不同的连接方式（USB、串口、网口）都会有细微的差异。

面对这些挑战，如果从零开始，不仅耗时耗力，还容易出错，直接影响系统的稳定性和用户体验。

Composer 登场：轻松引入专业打印能力

好在，PHP生态系统中有Composer这个强大的依赖管理工具。对于像收据打印这样专业且复杂的任务，我们完全可以借助成熟的第三方库来解决。mike42/escpos-php就是这样一个为PHP开发者量身定制的解决方案。

它封装了复杂的ESC/POS协议，提供了一套简单易用的API，让你能够像操作普通PHP对象一样来控制打印机。通过Composer，你可以非常方便地将它引入到你的项目中：

立即学习“PHP免费学习笔记（深入）”；

composer require mike42/escpos-php

安装完成后，Composer会自动处理所有依赖，你只需专注于业务逻辑，而无需关心底层打印机的通信细节。该库要求PHP 7.3或更高版本，并建议安装json、intl、zlib等扩展，以及可选的imagick或gd用于图像处理。

mike42/escpos-php：你的收据打印利器

mike42/escpos-php库的核心理念是提供一个抽象层，将复杂的打印机指令转化为直观的PHP方法调用。

核心功能概览

文本打印与格式化： 支持设置字体、大小、加粗、下划线、反色、对齐方式（左对齐、居中、右对齐）。
图像打印： 可以将图片（如Logo）打印到收据上。
条形码与二维码： 支持多种标准条形码（UPC-A, Code39, ITF等）和QR码、PDF417码的生成与打印。
切纸与钱箱控制： 发送指令实现全切或半切，以及触发钱箱开启。
广泛的兼容性： 支持通过以太网、USB、串口、并口等多种接口连接打印机，并针对不同操作系统（Linux, Windows, macOS）提供了相应的连接器。

连接方式

该库通过PrintConnectors来处理与打印机的物理连接。这是解决“通信障碍”的关键：

知了zKnown

知了zKnown：致力于信息降噪 / 阅读提效的个人知识助手。

下载

NetworkPrintConnector：用于连接网络打印机（通过IP地址和端口）。
FilePrintConnector：用于连接本地设备文件（如Linux下的/dev/usb/lp0，或串口/dev/ttyS0）。
WindowsPrintConnector：专为Windows系统设计，通过共享打印机名称进行连接（如smb://computer/printer或LPT1）。

例如，连接一台网络打印机：

use Mike42\Escpos\PrintConnectors\NetworkPrintConnector;
use Mike42\Escpos\Printer;

try {
    // 连接到打印机，替换为你的打印机IP和端口
    $connector = new NetworkPrintConnector("192.168.1.100", 9100);
    $printer = new Printer($connector);

    // ... 在这里编写你的打印逻辑 ...

} finally {
    // 确保在任何情况下都关闭连接，释放资源
    if (isset($printer)) {
        $printer->close();
    }
}

打印机兼容性与配置

不同品牌的打印机可能对ESC/POS指令的支持程度不同。mike42/escpos-php通过CapabilityProfile来解决这个问题，你可以加载适合你打印机型号的配置文件，以确保最佳兼容性：

use Mike42\Escpos\CapabilityProfile;
use Mike42\Escpos\PrintConnectors\WindowsPrintConnector;
use Mike42\Escpos\Printer;

// 加载针对特定打印机型号的配置，例如“simple”或“SP2000”
$profile = CapabilityProfile::load("simple"); // 适用于大多数基本打印机
$connector = new WindowsPrintConnector("smb://computer/printer_share_name");
$printer = new Printer($connector, $profile);

// ... 打印逻辑 ...
$printer->close();

“Hello World” 打印示例

让我们看一个简单的例子，如何打印一张包含文本和切纸指令的收据：

initialize();

    // 设置居中对齐
    $printer->setJustification(Printer::JUSTIFY_CENTER);
    // 打印标题
    $printer->setTextSize(2, 2); // 字体放大2倍
    $printer->setEmphasis(true); // 加粗
    $printer->text("咖啡馆收据\n");
    $printer->setEmphasis(false); // 取消加粗
    $printer->setTextSize(1, 1); // 恢复默认字体大小
    $printer->text("--------------------------------\n");

    // 设置左对齐
    $printer->setJustification(Printer::JUSTIFY_LEFT);
    $printer->text("订单号: #12345\n");
    $printer->text("日期: " . date('Y-m-d H:i:s') . "\n");
    $printer->text("--------------------------------\n");

    // 打印商品列表
    $printer->text("美式咖啡 x1           15.00\n");
    $printer->text("拿铁 x2               40.00\n");
    $printer->text("芝士蛋糕 x1           28.00\n");
    $printer->text("--------------------------------\n");

    // 打印总计
    $printer->setJustification(Printer::JUSTIFY_RIGHT);
    $printer->setTextSize(1, 2); // 高度放大2倍
    $printer->text("总计: 83.00 元\n");
    $printer->setTextSize(1, 1); // 恢复默认
    $printer->setJustification(Printer::JUSTIFY_LEFT);

    // 打印二维码 (例如，用于支付或会员)
    $printer->qrCode("https://your-website.com/order/12345", Printer::QR_ECLEVEL_L, 8);
    $printer->text("扫码查看订单详情\n");

    // 进纸3行
    $printer->feed(3);
    // 全切纸
    $printer->cut();

} catch (Exception $e) {
    echo "打印失败: " . $e->getMessage() . "\n";
} finally {
    // 确保关闭连接
    if (isset($printer)) {
        $printer->close();
    }
}