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 参数

基本用法

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 映射表

门脸模式

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

基于中午云的 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