pkg6/cloud-print

非官方云小票机SDK，支持飞鹅云，芯烨云，易联云，快递100，映美云，中午云，佳博云，优声云，365智能云打印等

v1.0.1 2026-07-12 16:54 UTC

Requires

• php: >=8.0
• ext-json: *
• ext-zlib: *
• guzzlehttp/guzzle: ^6 | ^7
• psr/cache: ~1.0 | ^2.0 | ^3.0
• psr/log: ^1.0.1 | ^2.0 | ^3.0
• psr/simple-cache: ^1.0 | ^2.0 | ^3.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.9
• mockery/mockery: ^1.2.3
• phpunit/phpunit: ^6|^7|^8|^9
• pkg6/log: ^0.1

MIT

• zhiqiang

• 快递100
• 云打印机
• 云小票机
• 芯烨云
• Cloud Print
• 飞鹅云
• 易联云
• 映美云
• 佳博云
• 365智能云打印
• 中午云
• 优声云

Published on Packagist.org on 2026-07-12 16:55 UTC

README

云小票机SDK-cloud-print

非官方云小票机SDK，支持飞鹅云，芯烨云，易联云，快递100，映美云，中午云，佳博云，优声云，365智能云打印等

安装

composer require pkg6/cloud-print

自定义缓存

基于https://packagist.org/packages/psr/simple-cache#1.0

public function setCache(CacheInterface $cache);

自定义日志

基于 https://packagist.org/packages/psr/log

public function setRequestLogger(LoggerInterface $logger)
//自定义日志格式（借助guzzlehttp/guzzle中的handler）进行实现
public function setMessageFormatter(MessageFormatter $messageFormatter)

适配模式

需要定义的服务商实现客户端

https://github.com/pkg6/cloud-print/blob/main/src/Contracts/ClientInterface.php

配置

https://github.com/pkg6/cloud-print/blob/main/config/config.php

实例化

$cloudPrint = new CloudPrint($config)
//自定义驱动
$cloudPrint->client("zhongwuyun")->request($method, $action, $privateParams)
//默认驱动
$cloudPrint->request($method, $action, $privateParams)

统一打印协议

所有厂商客户端实现统一的 print(PrintRequest $request) 方法，通过 PrintRequest 参数类传递打印参数。

PrintRequest 参数

参数	类型	说明
sn	string	打印机编号
content	string	打印内容
copies	int	打印份数，默认 1
orderId	string	订单号
type	string	打印类型（厂商差异）
templateId	string	模板ID
imageUrl	string	图片地址
htmlUrl	string	HTML地址
extra	array	各厂商私有扩展字段

基本用法

use Pkg6\CloudPrint\Requests\PrintRequest;

$request = PrintRequest::create()
    ->sn('99999999')
    ->content('订单内容')
    ->copies(1)
    ->orderId('12345');

$client->print($request);

使用 type 参数

// 飞鹅云 - 标签打印
$request = PrintRequest::create()
    ->sn('99999999')
    ->content('标签内容')
    ->type('label');

// 映美云 - 多种打印模式
$request = PrintRequest::create()
    ->sn('99999999')
    ->htmlUrl('https://example.com/order.html')
    ->type('html_url');  // html_code / html_to_pic / template / express / esc 等

// 易联云 - 图片打印
$request = PrintRequest::create()
    ->sn('99999999')
    ->imageUrl('https://example.com/image.png')
    ->type('picture');

厂商 type 映射表

厂商	type 值	说明
飞鹅云	label	标签打印
芯烨云	label	标签打印
易联云	picture / express	图片打印 / 面单打印
映美云	html_url / html_code / html_to_pic / html_to_gray_pic / template / point_text / express / rich_html_code / esc / file / file_by_url / label / invoice	13种打印模式
其余厂商	默认	文本打印

门脸模式

可以直接到实现请求的客户端，内置很多方法可以供使用

基于中午云的 PHP 接口组件

$printer = \Pkg6\CloudPrint\Factory::Zhongwuyun([
    'appid'     => '******',
    'appsecret' => '******',
]);

基于 优声云 的 PHP 接口组件

$printer = \Pkg6\CloudPrint\Factory::Ushengyun([
    'appId'     => '10001',
    'appSecret' => '**********',
]);

基于佳博云的 PHP 接口组件

$printer = \Pkg6\CloudPrint\Factory::Poscom([
    'memberCode' => '',
    'apiKey'     => '',
]);

基于快递100的 PHP 接口组件

$printer = \Pkg6\CloudPrint\Factory::Kuaidi100([
    'key' => '',
    'secret' => '',
]);

基于易联云的 PHP 接口组件

$printer = \Pkg6\CloudPrint\Factory::Yilianyun([
    'client_id'     => '',
    'client_secret' => '',
]);

基于映美云的 PHP 接口组件

$printer = \Pkg6\CloudPrint\Factory::Jolimark([
    'app_id'  => '',
    'app_key' => '',
]);

基于 芯烨云 的 PHP 接口组件

$printer = \Pkg6\CloudPrint\Factory::Xpyun([
    'user'    => '',
    'userKey' => '',
]);

基于 飞鹅云 的 PHP 接口组件

$printer = \Pkg6\CloudPrint\Factory::Feieyun([
    'user' => '',
    'ukey' => '',
]);

支持厂商

• 飞鹅云
• 芯烨云
• 易联云
• 快递100
• 映美云
• 佳博云
• 中午云
• 优声云

加入我们

如果你认可我们的开源项目，有兴趣为 cloud-print 的发展做贡献，竭诚欢迎加入我们一起开发完善。无论是 报告错误issues 或是 Pull Request 开发，那怕是修改一个错别字也是对我们莫大的帮助。

许可协议

MIT