PHPackages                             turtledesign/royalmail-php - 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. turtledesign/royalmail-php

ActiveLibrary[API Development](/categories/api)

turtledesign/royalmail-php
==========================

PHP module for interfacing with the Royal Mail shipping api : http://www.royalmail.com/corporate/services/shipping-api

0.4.0.2(7y ago)2016.6k7[5 issues](https://github.com/turtledesign/royalmail-php/issues)MITPHPPHP &gt;=5.4.0

Since Oct 11Pushed 7y ago4 watchersCompare

[ Source](https://github.com/turtledesign/royalmail-php)[ Packagist](https://packagist.org/packages/turtledesign/royalmail-php)[ RSS](/packages/turtledesign-royalmail-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (11)Used By (0)

Royal Mail API SDK for PHP
==========================

[](#royal-mail-api-sdk-for-php)

[![Build Status](https://camo.githubusercontent.com/9bf0600ace5926534fdbfb5bae574ac0217fde91f333b9cfa268273b0d303f05/68747470733a2f2f7472617669732d63692e6f72672f747572746c6564657369676e2f726f79616c6d61696c2d7068702e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/turtledesign/royalmail-php)

This repository contains a PHP SDK/Interface for the (UK) [Royal Mail's Shipping API](http://www.royalmail.com/corporate/services/shipping-api)

> This is not an official SDK, we () are a 3rd party integrator releasing the module with an open source licence because why not.

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

[](#prerequisites)

- PHP 5.4 or above (testing requires version 5.6 or above due to the Atoum test module requirements).
- [soap](http://php.net/manual/en/book.soap.php) &amp; [openssl](http://php.net/manual/en/book.openssl.php) extensions must be enabled
- [fileinfo](http://php.net/manual/en/book.fileinfo.php) required for testing.

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

[](#installation)

### - Using Composer

[](#--using-composer)

[**composer**](https://getcomposer.org/) is the recommended way to install the SDK. To use the SDK with project, add the following dependency to your application's composer.json and run `composer update --no-dev` to fetch the SDK.

You can download composer using instructions on [Composer Official Website.](https://getcomposer.org/download/)

#### Prerequisites

[](#prerequisites-1)

- *composer* for fetching dependencies (See )

#### Steps to Install :

[](#steps-to-install-)

Currently, the SDK is available at [https://packagist.org](https://packagist.org/packages/turtledesign/royalmail-php). To use it in your project, you need to include it as a dependency in your project composer.json file. It can be done in two ways :

- Running `composer require 'turtledesign/royalmail-php:*@dev'` command on your project root location (where project composer.json is located.)
- Or, manually editing composer.json file `require` field, and adding `"turtledesign/royalmail-php" :  "*@dev"` inside it.

The resultant sample *composer.json* would look like this:

```
{
  ...

  "name": "sample/website",
  "require": {
  	"turtledesign/royalmail-php" : "*@dev"
  }

  ...
}
```

### - Direct Download (without using Composer)

[](#--direct-download-without-using-composer)

If you do not want to use composer, you can grab the SDK zip that contains Royal Mail API SDK with all its dependencies with it.

#### Steps to Install :

[](#steps-to-install--1)

- Download zip archive with desired version from our [Releases](https://github.com/turtledesign/royalmail-php/releases). Each release will have a `direct-download-*.zip` that contains PHP Rest API SDK and its dependencies.
- Unzip and copy vendor directory inside your project, e.g. project root directory.
- If your application has a bootstrap/autoload file, you should add `include '/vendor/autoload.php'` in it. The location of the `` should be replaced based on where you downloaded **vendor** directory in your application.
- This *autoload.php* file registers a custom autoloader that can autoload the Royal Mail SDK files, that allows you to access PHP SDK system in your application.

More help
---------

[](#more-help)

- [Royal Mail Shipping API Service Page](http://www.royalmail.com/corporate/services/shipping-api)
- [API Reference - PDF](http://www.royalmail.com/sites/default/files/Shipping-API-Technical-User-Guide-v2_1-June-2015.pdf)
- [Reporting issues / feature requests](https://github.com/turtledesign/royalmail-php/issues)

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance15

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.1% 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 ~113 days

Recently: every ~35 days

Total

10

Last Release

2849d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/604ab0915b81ce7ed8ec5e5707028fc4b986aa9c261633967e83d577263f0356?d=identicon)[Turtle Design](/maintainers/Turtle%20Design)

---

Top Contributors

[![Buntix](https://avatars.githubusercontent.com/u/678256?v=4)](https://github.com/Buntix "Buntix (80 commits)")[![minioak](https://avatars.githubusercontent.com/u/1151320?v=4)](https://github.com/minioak "minioak (5 commits)")

---

Tags

barcodesshippingroyal mailpostagepost-office

### Embed Badge

![Health badge](/badges/turtledesign-royalmail-php/health.svg)

```
[![Health](https://phpackages.com/badges/turtledesign-royalmail-php/health.svg)](https://phpackages.com/packages/turtledesign-royalmail-php)
```

###  Alternatives

[gabrielbull/ups-api

PHP UPS API

4642.4M10](/packages/gabrielbull-ups-api)[easypost/easypost-php

EasyPost Shipping API Client Library for PHP

1753.1M5](/packages/easypost-easypost-php)[shippo/shippo-php

A PHP library for connecting with multiple carriers (FedEx, UPS, USPS) using Shippo.

1711.8M2](/packages/shippo-shippo-php)[firstred/postnl-api-php

PostNL REST API PHP Bindings

27610.2k1](/packages/firstred-postnl-api-php)[octw/aramex

A Library to integrate with Aramex APIs

2925.2k](/packages/octw-aramex)[devaguia/correios-php

Correios API library for PHP

294.3k1](/packages/devaguia-correios-php)

PHPackages © 2026

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