PHPackages                             graze/unicontroller-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. graze/unicontroller-client

ActiveLibrary[API Development](/categories/api)

graze/unicontroller-client
==========================

Domino Unicontroller client written in PHP

v0.1.3(6y ago)39.1k[2 issues](https://github.com/graze/unicontroller-client/issues)MITPHPPHP ^5.5

Since Nov 16Pushed 6y ago2 watchersCompare

[ Source](https://github.com/graze/unicontroller-client)[ Packagist](https://packagist.org/packages/graze/unicontroller-client)[ Docs](https://github.com/graze/unicontroller-client)[ RSS](/packages/graze-unicontroller-client/feed)WikiDiscussions master Synced yesterday

READMEChangelog (3)Dependencies (7)Versions (5)Used By (0)

unicontroller-client
====================

[](#unicontroller-client)

[![Latest Version on Packagist](https://camo.githubusercontent.com/f58b1c78e379f114e3d96ad114d246198176a7ec7026d70c28d4b5ab32317a47/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6772617a652f756e69636f6e74726f6c6c65722d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/graze/unicontroller-client)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/66e64198744e67df9502828bd6d45c220fd81284ad3fe08ef32d1e2e115d3adb/68747470733a2f2f7472617669732d63692e6f72672f6772617a652f756e69636f6e74726f6c6c65722d636c69656e742e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/graze/unicontroller-client)[![Code Coverage](https://camo.githubusercontent.com/bcadfe7b3fde2cbcb5303931cc41c1817eff6d9daad1c0b392b3db5f15b26bbd/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6772617a652f756e69636f6e74726f6c6c65722d636c69656e742f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/graze/unicontroller-client/?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/d5f8f522d53869b04fb704694c69aa5277b1e2b8d46d3882ae962fe4f1d129c0/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6772617a652f756e69636f6e74726f6c6c65722d636c69656e742f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/graze/unicontroller-client/?branch=master)[![Total Downloads](https://camo.githubusercontent.com/ffd5ba6aadd8b470dc69f3960069dc244f6850dd94095d9bb4cd83f0d3ac9862/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6772617a652f756e69636f6e74726f6c6c65722d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/graze/unicontroller-client)

A Domino Unicontroller client written in PHP.

Check out the [Class Generator Readme](bin/README.md) to see how this client was written.

Install
-------

[](#install)

Via Composer

```
$ composer require graze/unicontroller-client
```

Usage
-----

[](#usage)

```
# instantiate a client
$client = Graze\UnicontrollerClient\UnicontrollerClient::factory();

# connect to a printer
$dsn = '172.16.1.1:9100';
$client->connect($dsn);

# send the 'ReadDesign' command to the printer
$designName = 'current.Design';
$designCurrent = $client->ReadDesign($designName, 0, 0);

# client returns the 'ReadDesign' entity, as defined in the Unicontroller specification
if (!$designCurrent->getReadOk()) {
    echo sprintf('failed to read design, does %s exist?', $designName);
    exit;
}

# modify some text
$ttfItem = $designCurrent->getTtfArray()[0];
$ttfItem->setData('this is some example text');

# add an image
$imageData = file_get_contents('/path/to/image.bmp');

$pictureItem = new Graze\UnicontrollerClient\Entity\Entity\EntityPictureItem();
$pictureItem->setAnchorPoint(0);
$pictureItem->setXPos(9500);
$pictureItem->setYPos(400);
$pictureItem->setWidth(0);
$pictureItem->setHeight(0);
$pictureItem->setOrion(0);
$pictureItem->setDescription('image1');
$pictureItem->setMaintain(1);
$pictureItem->setPrinterReferenceName('image.bmp');
$pictureItem->setUsePixelSize(1);
$pictureItem->setPictureData($imageData);
$pictureItem->setStoreInternally(0);
$pictureItem->setPhantomField(0);

$designCurrent->setPictureArray([$pictureItem]);

# push the design to the printer
$entity->setName('new.Design');
$entity->setSaveDesign(1);
$designNew = $client->serialise($designCurrent);
$resp = $client->send('Design', $designNew, 1);

if (!$resp->success()) {
    echo 'something went wrong';
}
```

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Testing
-------

[](#testing)

```
$ make test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance7

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~340 days

Total

4

Last Release

2490d ago

PHP version history (2 changes)v0.1.0PHP ^5.6

v0.1.2PHP ^5.5

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1314694?v=4)[John Smith](/maintainers/john-n-smith)[@john-n-smith](https://github.com/john-n-smith)

---

Top Contributors

[![john-n-smith](https://avatars.githubusercontent.com/u/1314694?v=4)](https://github.com/john-n-smith "john-n-smith (54 commits)")[![biggianteye](https://avatars.githubusercontent.com/u/1482649?v=4)](https://github.com/biggianteye "biggianteye (2 commits)")

---

Tags

grazeunicontroller-client

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/graze-unicontroller-client/health.svg)

```
[![Health](https://phpackages.com/badges/graze-unicontroller-client/health.svg)](https://phpackages.com/packages/graze-unicontroller-client)
```

###  Alternatives

[hubspot/api-client

Hubspot API client

24016.2M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[graze/telnet-client

Telnet client written in PHP

48242.5k4](/packages/graze-telnet-client)[badoo/jira-client

Jira REST API client with comfortable wrappers for most commonly used API instances like issues, custom fields, components and so on

669.1k](/packages/badoo-jira-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)