Laravel Homestead环境下如何连接USB热敏打印机打印小票

你在Windows本地XAMPP环境能正常打印，核心原因是PHP直接运行在Windows系统层，可以直接访问本机挂载的打印机外设；而Laravel Homestead是VirtualBox运行的隔离Ubuntu虚拟机，默认无法直接访问宿主机外接的打印机，按下面两种场景选对应方案配置即可。

方案一：网口打印机连接（优先选，稳定性最高） #

• 只要你的ESCPOS小票机带网口（绝大多数商用热敏小票机都标配），直接把打印机和电脑接入同一局域网，给打印机设置固定静态IP即可，不需要做任何虚拟机外设映射配置。
• 代码里直接用NetworkPrintConnector连接打印机的IP和默认9100打印端口即可，示例：

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

$connector = new NetworkPrintConnector("你的打印机静态局域网IP", 9100);
$printer = new Printer($connector);
// 写入你的小票打印逻辑
$printer->close();

• 这种方式完全不依赖宿主机和虚拟机的映射关系，本地测试和后续线上部署逻辑完全一致，不会因为虚拟机重启、设备插拔失效，是最推荐的实现方式。

方案二：USB直连宿主机打印机（无网口场景使用） #

如果你的打印机只有USB接口，通过宿主机打印机共享的方式打通通路即可，不要用VirtualBox的USB直通，稳定性极差：

1. Windows宿主机侧配置
   • 打开Windows 10「设置-蓝牙和设备-打印机和扫描仪」，找到你连接的小票打印机，进入「打印机属性-共享」页，勾选「共享这台打印机」，设置纯英文无特殊字符的共享名（比如pos_printer）。
   • 打开Windows cmd执行ipconfig，找到VirtualBox Host-Only Network网卡对应的IPv4地址，Homestead默认这个地址是192.168.10.1，记下来后续用。
   • 在Windows防火墙设置里放开「文件和打印机共享」的入站规则，避免虚拟机访问被拦截。
   • 测试配置：在资源管理器地址栏输入\\刚才查到的宿主机虚拟网卡IP，能看到你共享的小票打印机即为配置正常。
2. Homestead虚拟机侧配置
   • 执行vagrant ssh进入虚拟机，安装smb访问依赖：

   sudo apt update && sudo apt install -y smbclient
   

   • 执行下面的命令测试虚拟机能否正常访问宿主机共享资源，能返回共享打印机列表即为通路正常：

   smbclient -L //192.168.10.1 -N
   

   • 不需要在虚拟机内安装打印机驱动，ESCPOS-PHP本身已经内置了完整的打印指令集，直接用WindowsPrintConnector连接共享打印机即可，代码示例：

   use Mike42\Escpos\PrintConnectors\WindowsPrintConnector;
   use Mike42\Escpos\Printer;
   
   $connector = new WindowsPrintConnector("smb://192.168.10.1/pos_printer");
   $printer = new Printer($connector);
   // 写入你的小票打印逻辑
   $printer->close();
   

常见踩坑说明 #

• 不要尝试在虚拟机内直接读取/dev/usb/lp0这类本地设备端口，除非你做了USB直通，否则永远无法识别到接在宿主机上的打印机。
• 共享打印机名不要用中文、空格或者特殊符号，否则会出现连接失败找不到设备的问题。
• 如果你之前在XAMPP里用的是COM串口、LPT并口直连的方式，不要在虚拟机环境里折腾串口/并口映射，调试成本极高且稳定性差，优先换成网口连接方式。

内容的提问来源于stack exchange，提问作者John Rhey