{"id":23962732,"url":"https://github.com/smalot/cups-ipp","last_synced_at":"2025-04-05T10:08:14.134Z","repository":{"id":51149738,"uuid":"89877585","full_name":"smalot/cups-ipp","owner":"smalot","description":"CUPS Implementation of IPP - PHP Client API","archived":false,"fork":false,"pushed_at":"2022-10-27T08:03:50.000Z","size":172,"stargazers_count":108,"open_issues_count":26,"forks_count":57,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-29T09:09:41.944Z","etag":null,"topics":["api","client","cups","ipp","jobs","php","printer","sock","unix"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smalot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-30T21:13:23.000Z","updated_at":"2024-12-10T16:40:09.000Z","dependencies_parsed_at":"2022-08-12T22:40:43.523Z","dependency_job_id":null,"html_url":"https://github.com/smalot/cups-ipp","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smalot%2Fcups-ipp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smalot%2Fcups-ipp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smalot%2Fcups-ipp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smalot%2Fcups-ipp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smalot","download_url":"https://codeload.github.com/smalot/cups-ipp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247318744,"owners_count":20919484,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","client","cups","ipp","jobs","php","printer","sock","unix"],"created_at":"2025-01-06T20:54:37.867Z","updated_at":"2025-04-05T10:08:14.112Z","avatar_url":"https://github.com/smalot.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cups IPP\n\nCUPS Implementation of IPP - PHP Client API\n\nCUPS (Common Unix Printing System) is a modular printing system for Unix-like computer operating systems which allows a computer to act as a print server. A computer running CUPS is a host that can accept print jobs from client computers, process them, and send them to the appropriate printer.\n\n[![Build Status](https://travis-ci.org/smalot/cups-ipp.png?branch=master)](https://travis-ci.org/smalot/cups-ipp)\n[![Current Version](https://poser.pugx.org/smalot/cups-ipp/v/stable.png)](https://packagist.org/packages/smalot/cups-ipp)\n[![composer.lock](https://poser.pugx.org/smalot/cups-ipp/composerlock)](https://packagist.org/packages/smalot/cups-ipp)\n\n[![Total Downloads](https://poser.pugx.org/smalot/cups-ipp/downloads.png)](https://packagist.org/packages/smalot/cups-ipp)\n[![Monthly Downloads](https://poser.pugx.org/smalot/cups-ipp/d/monthly)](https://packagist.org/packages/smalot/cups-ipp)\n[![Daily Downloads](https://poser.pugx.org/smalot/cups-ipp/d/daily)](https://packagist.org/packages/smalot/cups-ipp)\n\n\n## Install via Composer\n\nYou can install the component using [Composer](https://getcomposer.org/).\n\n````sh\ncomposer require smalot/cups-ipp\n````\n\nThen, require the `vendor/autoload.php` file to enable the autoloading mechanism provided by Composer.\nOtherwise, your application won't be able to find the classes of this component.\n\n\n## Requirements\n\nThis library use unix sock connection: `unix:///var/run/cups/cups.sock`\n\nFirst of all, check if you have correct access to this file: `/var/run/cups/cups.sock`\n\n\n## Implementation\n\n### List printers\n\n\n````php\n\u003c?php\n\ninclude 'vendor/autoload.php';\n\nuse Smalot\\Cups\\Builder\\Builder;\nuse Smalot\\Cups\\Manager\\PrinterManager;\nuse Smalot\\Cups\\Transport\\Client;\nuse Smalot\\Cups\\Transport\\ResponseParser;\n\n$client = new Client();\n$builder = new Builder();\n$responseParser = new ResponseParser();\n\n$printerManager = new PrinterManager($builder, $client, $responseParser);\n$printers = $printerManager-\u003egetList();\n\nforeach ($printers as $printer) {\n    echo $printer-\u003egetName().' ('.$printer-\u003egetUri().')'.PHP_EOL;\n}\n\n````\n\n\n### List all printer's jobs\n\n````php\n\u003c?php\n\ninclude 'vendor/autoload.php';\n\nuse Smalot\\Cups\\Builder\\Builder;\nuse Smalot\\Cups\\Manager\\JobManager;\nuse Smalot\\Cups\\Manager\\PrinterManager;\nuse Smalot\\Cups\\Transport\\Client;\nuse Smalot\\Cups\\Transport\\ResponseParser;\n\n$client = new Client();\n$builder = new Builder();\n$responseParser = new ResponseParser();\n\n$printerManager = new PrinterManager($builder, $client, $responseParser);\n$printer = $printerManager-\u003efindByUri('ipp://localhost:631/printers/HP-Photosmart-C4380-series');\n\n$jobManager = new JobManager($builder, $client, $responseParser);\n$jobs = $jobManager-\u003egetList($printer, false, 0, 'completed');\n\nforeach ($jobs as $job) {\n    echo '#'.$job-\u003egetId().' '.$job-\u003egetName().' - '.$job-\u003egetState().PHP_EOL;\n}\n\n````\n\n\n### Create and send a new job\n\n````php\n\u003c?php\n\ninclude 'vendor/autoload.php';\n\nuse Smalot\\Cups\\Builder\\Builder;\nuse Smalot\\Cups\\Manager\\JobManager;\nuse Smalot\\Cups\\Manager\\PrinterManager;\nuse Smalot\\Cups\\Model\\Job;\nuse Smalot\\Cups\\Transport\\Client;\nuse Smalot\\Cups\\Transport\\ResponseParser;\n\n$client = new Client();\n$builder = new Builder();\n$responseParser = new ResponseParser();\n\n$printerManager = new PrinterManager($builder, $client, $responseParser);\n$printer = $printerManager-\u003efindByUri('ipp://localhost:631/printers/HP-Photosmart-C4380-series');\n\n$jobManager = new JobManager($builder, $client, $responseParser);\n\n$job = new Job();\n$job-\u003esetName('job create file');\n$job-\u003esetUsername('demo');\n$job-\u003esetCopies(1);\n$job-\u003esetPageRanges('1');\n$job-\u003eaddFile('./helloworld.pdf');\n$job-\u003eaddAttribute('media', 'A4');\n$job-\u003eaddAttribute('fit-to-page', true);\n$result = $jobManager-\u003esend($printer, $job);\n\n````\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmalot%2Fcups-ipp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmalot%2Fcups-ipp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmalot%2Fcups-ipp/lists"}