This repository contains a PHP SDK/Interface for the (UK) Royal Mail's Shipping API
This is not an official SDK, we (http://www.turtledesign.com/) are a 3rd party integrator releasing the module with an open source licence because why not.
- PHP 5.4 or above (testing requires version 5.6 or above due to the Atoum test module requirements).
- soap & openssl extensions must be enabled
- fileinfo required for testing.
composer 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.
- composer for fetching dependencies (See http://getcomposer.org)
Currently, the SDK is available at https://packagist.org. 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
requirefield, 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"
}
...
}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.
-
Download zip archive with desired version from our Releases. Each release will have a
direct-download-*.zipthat 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 directory location>/vendor/autoload.php'in it. The location of the<vendor directory>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.