PHPackages                             cloudprinter/cloudapps - 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. cloudprinter/cloudapps

ActiveLibrary[API Development](/categories/api)

cloudprinter/cloudapps
======================

The library that help developers easily integrate with CloudPrinter CloudApps API.

v1.0.18(4y ago)0271MITPHPPHP >=7.0CI failing

Since Jun 18Pushed 4y ago2 watchersCompare

[ Source](https://github.com/cloudprintercom/cloudapps-php-sdk)[ Packagist](https://packagist.org/packages/cloudprinter/cloudapps)[ RSS](/packages/cloudprinter-cloudapps/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (2)Versions (20)Used By (0)

CloudApps PHP SDK
=================

[](#cloudapps-php-sdk)

The Cloudprinter.com PHP SDK is a library with useful features that enable App developers to easily integrate their application with Cloudprinter.com and make requests to our CloudApps API. This PHP SDK makes it easy to set up the integration between your App and the Cloudprinter.com Print Cloud to request instant pricing, post print orders, get production signals back, and more.

The CloudApps API is exclusively designed for app and platform developers and offers support for multiple users.

We at Cloudprinter.com have connected 150+ printers to print & ship print products in almost any country in the world. Whether this is around the corner or at the other side of the globe, we've got you covered: we can deliver 500+ different products in more than 100 countries currently.

Our platform makes use of smart routing algoritms to route any print job to the most local and qualified printer. Based on location, performance, price and production options, your print job is routed by these algorithms to the nearest printing facility near your delivery address to help you save on transit times and costs.

Visit our [website](https://www.cloudprinter.com) for more information on all the products and services that we offer.

Full documentation
------------------

[](#full-documentation)

Follow the [link](https://github.com/cloudprintercom/cloudapps-php-sdk/wiki/PHP-SDK-CloudAPPS-documentation) to read the full documentation.

Installation
------------

[](#installation)

The CloudApps SDK can be installed with Composer. Run this command:

```
composer require cloudprinter/cloudapps

```

Prerequisites
-------------

[](#prerequisites)

- composer (for installation)
- php 7.0 or above
- json, fileinfo, curl extensions must be enabled
- Cloudprinter.com Print Cloud account

Creating an app
---------------

[](#creating-an-app)

The CloudApps API is designed as backend for integrated apps. An app could as an example an e-commerce system integration.

Each app needs to be created in the Cloudprinter.com system. Please contact Cloudprinter.com support team for this.

Authentication
--------------

[](#authentication)

Authentication is done via OAuth2.

Each app requires a unique client identifier, client password and a return URL. This information is required for Cloudprinter.com support team when creating the app.

The Cloudprinter.com user login grants access to the CloudApps API.

Examples
--------

[](#examples)

### Get access token.

[](#get-access-token)

```
use CloudPrinter\CloudApps\Authentication\OAuth2;

$config = [
    'client_id' => '***',
    'client_secret' => '***',
    'redirect_uri' => 'http://www.your-site.com',
    'scope' => 'read-write'
];
$oAuth2 = new OAuth2($config);

// Step 1. Getting url for authorization code.
$authorizationCodeUrl = $oAuth2->getAuthorizationCodeUrl();

// Step 2. Getting access token by authorization code that comes to redirect url.
$code = $_GET['code'];
$accessToken = $oAuth2->getAccessToken($code);

```

### Get list of orders.

[](#get-list-of-orders)

```
use CloudPrinter\CloudApps\Client\CloudAppsClient;

$accessToken = '***';
$client = new CloudAppsClient($accessToken);
$response = $client->order->getList();

print_r($response->getData());

```

### Create new order.

[](#create-new-order)

```
use CloudPrinter\CloudCore\Client\CloudCoreClient;
use CloudPrinter\CloudCore\Exception\ValidationException;
use CloudPrinter\CloudCore\Model\{Address, File, OrderItem, Order, Option};

$accessToken = '***';
$client = new CloudAppsClient($accessToken);

$address = new Address();
$address->setEmail('test@mail.com')
    ->setFirstName('John')
    ->setLastName('Doe')
    ->setCountry('NL')
    ->setCity('Amsterdam')
    ->setStreet('Street1')
    ->setPhone('+31-655-538-848')
    ->setZip('1071 JA')
    ->setType('delivery');

$fileCover = new File();
$fileCover->setUrl('https://s3-eu-west-1.amazonaws.com/demo.cloudprinter.com/b52f510a5e2419f67c4925153ec0c080_v2/CP_Sample_doc_A4_Book_Cover_Textbook_80_gsm_Casewrap_v2.1.pdf')
    ->setType('cover');

$fileBook = new File();
$fileBook->setUrl('https://s3-eu-west-1.amazonaws.com/demo.cloudprinter.com/b52f510a5e2419f67c4925153ec0c080_v2/CP_Sample_doc_A4_Book_Interior_Textbook_v2.1.pdf')
    ->setType('book');

$item = new OrderItem();
$item->setReference('item-1')
    ->setCount(1)
    ->setProductReference('textbook_cw_a4_p_bw')
    ->addFile($fileCover)
    ->addFile($fileBook)
    ->addOption(new Option('cover_finish_gloss', 1))
    ->addOption(new Option('pageblock_80off', 1))
    ->addOption(new Option('cover_130mcg', 1))
    ->addOption(new Option('total_pages', 100));

$order = new Order();
$order
    ->setEmail('test@mail.com')
    ->setReference('sdk-' . time())
    ->addItem($item)
    ->addAddress($address);

try {
    $response = $client->order->create($order);
    print_r($response->getData());
} catch (ValidationException $e) {
    print_r($e->getValidationMessages());
}

```

Read more information
---------------------

[](#read-more-information)

Follow the [link](https://github.com/cloudprintercom/cloudapps-php-sdk/wiki/PHP-SDK-CloudAPPS-documentation) to read the full documentation.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 88.9% 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 ~44 days

Recently: every ~111 days

Total

19

Last Release

1732d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b0767482f6b5718333bd3f8b3ba854bf006d167fd330c6e47b8a7560e3b14b58?d=identicon)[kushniruk](/maintainers/kushniruk)

![](https://www.gravatar.com/avatar/ecde9547a3be36e21f6b08319a44d3d4d92e4fbb29b1606fadc006dc8e430736?d=identicon)[Cloudprinter.com](/maintainers/Cloudprinter.com)

---

Top Contributors

[![kushniruk](https://avatars.githubusercontent.com/u/47745979?v=4)](https://github.com/kushniruk "kushniruk (8 commits)")[![mogenswinther](https://avatars.githubusercontent.com/u/13745919?v=4)](https://github.com/mogenswinther "mogenswinther (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/cloudprinter-cloudapps/health.svg)

```
[![Health](https://phpackages.com/badges/cloudprinter-cloudapps/health.svg)](https://phpackages.com/packages/cloudprinter-cloudapps)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

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