surda/zebra

Zebra client for network-connected Zebra label printers

v2.0.0 2024-02-21 08:50 UTC

Requires

• php: >=8.0
• ext-sockets: *
• latte/latte: ^3.0
• nette/utils: ^3.2 || ^4.0

Requires (Dev)

• nette/tester: ^2.0
• ninjify/nunjuck: ^0.3
• phpstan/phpstan: ^1.0
• phpstan/phpstan-deprecation-rules: ^1.0
• phpstan/phpstan-nette: ^1.0
• phpstan/phpstan-strict-rules: ^1.0

Conflicts

• nette/di: <2.4

MIT

• Radek Šuráni

• nette
• zebra

README

Installation

The recommended way to is via Composer:

composer require surda/zebra

Basic using

$client = new \Surda\Zebra\Client\Client(host: '192.168.0.100');
$client->send(zpl: '^XA.......^XZ');

Using dispatcher

$label = new \Surda\Zebra\Label\DummyDataLabel();
$printer = new \Surda\Zebra\Printer\Printer(name: 'name', host: '192.168.0.100');
$dispatcher = new \Surda\Zebra\Dispatcher\Dispatcher();
$dispatcher->dispatch(label: $label, printer: $printer);

Nette Latte template

OrderLabel.latte

^XA
^MMT
^PW400
^LL0200
^LS0
^BY2,3,51^FT20,80^B3N,N,,N,N^FD{$order->getNumber()}^FS
^FT260,75^A0N,50,50^FH\^FD{$order->getNumber()}^FS
^PQ{$quantity},0,1,Y
^XZ

OrderLabel.php

class OrderLabel implements \Surda\Zebra\Label\ILabel
{
    public function __construct(private Order $order)
    {
    }

    public function getData(): string
    {
        $template = new \Surda\Zebra\Template\Template(
            __DIR__ . '/OrderLabel.latte',
            [
                'order' => $this->order,
                'quantity' => 1,
            ]
        );
        return (new \Surda\Zebra\Label\TemplateLabel($template))->getData();
    }
}

OrderLabelFactory.php

interface OrderLabelFactory
{
    public function create(Order $order)): OrderLabel;
}

LabelPrintManager.php

class LabelPrintManager
{
    public function __construct(
        private \Surda\Zebra\Printer\IPrinter $printer, 
        private \Surda\Zebra\Dispatcher\Dispatcher $dispatcher,
    )
    {
    }

    public function print(ILabel $label): void
    {
        try {
            $this->dispatcher->dispatch($label, $this->printer);
        } catch (DispatchException) {
            throw new \Surda\Zebra\PrintException();
        }
    }
}

config.neon

service:
    zebraPrinter:
        factory: \Surda\Zebra\Printer\Printer('name', '192.168.0.100', 9100)
        autowired: false
    - OrderLabelFactory
    - LabelPrintManager(@zebraPrinter)

Presenter

#[Inject]
public OrderLabelFactory $orderLabelFactory;

#[Inject]
public LabelPrintManager $labelPrintManager;

public function print() {
    $order = new Order();
    $label = $this->orderLabelFactory->create($order);
    $this->labelPrintManager->print($label);
}