在PHP中通过IP地址打印服务器PDF文件技术求助

核心问题排查 #

你的现有代码存在几个关键问题：

• Windows下print命令不支持直接用IP地址指定网络打印机，仅能识别本地已安装的打印机名称
• Linux下lpr命令的-P参数需要已配置的打印机队列名，而非直接填IP
• PDFtoPrinter的参数使用错误，虚拟打印机的测试场景和真实IP打印机逻辑不匹配

Windows环境解决办法 #

1. 先通过IP安装网络打印机 #

Windows无法直接通过print命令推送至未安装的IP打印机，需先完成打印机安装：

• 控制面板→设备和打印机→添加打印机→选择「添加网络、无线或Bluetooth打印机」→输入打印机IP（格式如\\192.168.1.100\StarPrinter）完成安装
• 记录安装后的打印机名称（例如Star TSP100）

2. 修正PHP代码 #

使用PDFtoPrinter.exe（针对PDF打印优化，比系统print命令更可靠），正确参数格式如下：

$printerName = "Star TSP100"; // 替换为你安装的打印机名称
$fileToPrint = $_SERVER["DOCUMENT_ROOT"]."/receipts/".CLIENT_ID."/receipt.pdf";
$pdfToPrinterPath = "C:/path/to/PDFtoPrinter.exe"; // 替换为实际路径

if(file_exists($fileToPrint)){
    // 静默打印，禁止弹出对话框
    exec("\"$pdfToPrinterPath\" \"$fileToPrint\" /printer \"$printerName\" /silent", $output, $returnCode);
    
    if ($returnCode === 0) {
        echo "打印任务提交成功";
    } else {
        // 输出错误信息用于排查
        var_dump($output);
        echo "打印任务提交失败";
    }
} else {
    echo "PDF文件不存在";
}

• /silent参数强制静默模式，避免弹出文件名输入框
• 必须使用已安装的打印机名称而非IP，Windows需通过系统注册表识别打印机设备

Linux环境解决办法（部署网站的服务器） #

1. 配置IP打印机队列 #

Star emae打印机通常支持LPR/LPD协议，先在Linux服务器上创建打印机队列：

# 安装CUPS打印工具（未安装时执行）
sudo apt-get install cups-client cups

# 添加IP打印机队列，命名为star_printer
sudo lpadmin -p star_printer -v lpd://192.168.1.100 -E -m starmicronics/star-tsp100.ppd
# 替换192.168.1.100为实际打印机IP，PPD文件需匹配你的Star型号，可从官网下载

2. 修正PHP代码 #

使用lpr命令时指定已配置的队列名，而非直接填IP：

$printerQueue = "star_printer"; // 替换为你创建的队列名
$fileToPrint = $_SERVER["DOCUMENT_ROOT"]."/receipts/".CLIENT_ID."/receipt.pdf";

if(file_exists($fileToPrint)){
    // -r参数可选：打印完成后删除原文件
    exec("lpr -P $printerQueue -r \"$fileToPrint\"", $output, $returnCode);
    
    if ($returnCode === 0) {
        echo "打印任务提交成功";
    } else {
        var_dump($output);
        echo "打印任务提交失败";
    }
} else {
    echo "PDF文件不存在";
}

• 确保PHP运行用户（通常是www-data）有打印权限：执行sudo usermod -a -G lp www-data添加权限

Star打印机特殊注意事项 #

• 确认打印机的LPR/LPD服务已启用：多数Star小票打印机默认开启，可通过设备设置页检查
• PDF文件尺寸需匹配打印机纸型（如58mm/80mm小票纸），否则可能出现打印错位或内容截断
• 先通过系统命令测试打印，再整合到PHP：
  • Windows："C:/path/to/PDFtoPrinter.exe" "test.pdf" /printer "Star Printer" /silent
  • Linux：lpr -P star_printer test.pdf

调试技巧 #

• 不要仅依赖exec的$output，可将命令输出重定向到日志文件：

  exec("\"$pdfToPrinterPath\" \"$fileToPrint\" /printer \"$printerName\" > C:/print_log.txt 2>&1", $output, $returnCode);
  

• 检查PHP的exec权限：确认php.ini的disable_functions中未禁用exec、shell_exec等函数
• Windows下需确保PDFtoPrinter.exe的运行用户（IIS/IUSR或Apache用户）有打印机访问权限

内容的提问来源于stack exchange，提问作者sveta ivanova