README

CUPS 的 IPP 实现 - PHP 客户端 API

CUPS (通用 Unix 打印系统) 是一种适用于 Unix-like 计算机操作系统的模块化打印系统，它允许计算机充当打印服务器。运行 CUPS 的计算机可以接受来自客户端计算机的打印作业，处理它们，并将它们发送到适当的打印机。

通过 Composer 安装

您可以使用 Composer 安装此组件。

composer require maddin-68/cups-ipp

然后，引入 vendor/autoload.php 文件以启用 Composer 提供的自动加载机制。否则，您的应用程序将无法找到此组件的类。

需求

此库使用 Unix sock 连接：unix:///var/run/cups/cups.sock

首先，检查您是否有权访问此文件：/var/run/cups/cups.sock

实现

列出打印机

<?php

include 'vendor/autoload.php';

use Maddin\Cups\Builder\Builder;
use Maddin\Cups\Manager\PrinterManager;
use Maddin\Cups\Transport\Client;
use Maddin\Cups\Transport\ResponseParser;

$client = new Client();
$builder = new Builder();
$responseParser = new ResponseParser();

$printerManager = new PrinterManager($builder, $client, $responseParser);
$printers = $printerManager->getList();

foreach ($printers as $printer) {
    echo $printer->getName().' ('.$printer->getUri().')'.PHP_EOL;
}

列出所有打印机的作业

<?php

include 'vendor/autoload.php';

use Maddin\Cups\Builder\Builder;
use Maddin\Cups\Manager\JobManager;
use Maddin\Cups\Manager\PrinterManager;
use Maddin\Cups\Transport\Client;
use Maddin\Cups\Transport\ResponseParser;

$client = new Client();
$builder = new Builder();
$responseParser = new ResponseParser();

$printerManager = new PrinterManager($builder, $client, $responseParser);
$printer = $printerManager->findByUri('ipp://:631/printers/HP-Photosmart-C4380-series');

$jobManager = new JobManager($builder, $client, $responseParser);
$jobs = $jobManager->getList($printer, false, 0, 'completed');

foreach ($jobs as $job) {
    echo '#'.$job->getId().' '.$job->getName().' - '.$job->getState().PHP_EOL;
}

创建并发送新作业

<?php

include 'vendor/autoload.php';

use Maddin\Cups\Builder\Builder;
use Maddin\Cups\Manager\JobManager;
use Maddin\Cups\Manager\PrinterManager;
use Maddin\Cups\Model\Job;
use Maddin\Cups\Transport\Client;
use Maddin\Cups\Transport\ResponseParser;

$client = new Client();
$builder = new Builder();
$responseParser = new ResponseParser();

$printerManager = new PrinterManager($builder, $client, $responseParser);
$printer = $printerManager->findByUri('ipp://:631/printers/HP-Photosmart-C4380-series');

$jobManager = new JobManager($builder, $client, $responseParser);

$job = new Job();
$job->setName('job create file');
$job->setUsername('demo');
$job->setCopies(1);
$job->setPageRanges('1');
$job->addFile('./helloworld.pdf');
$job->addAttribute('media', 'A4');
$job->addAttribute('fit-to-page', true);
$result = $jobManager->send($printer, $job);