Search by 
whereof / cloud-print
This package is abandoned and no longer maintained.
The author suggests using the pkg6/cloud-print package instead.
非官方云小票机SDK，支持飞鹅云，芯烨云，易联云，快递100，映美云，中午云，佳博云，优声云，365智能云打印等
Maintainers
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
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' => '',
]);
支持厂商
加入我们
如果你认可我们的开源项目，有兴趣为 cloud-print 的发展做贡献，竭诚欢迎加入我们一起开发完善。无论是 报告错误issues 或是 Pull Request 开发，那怕是修改一个错别字也是对我们莫大的帮助。