3mg/russian-post-bundle

Бандл для работы с сервисом отслеживания Почты России

v0.1 2015-09-14 08:44 UTC

Requires

• 3mg/nusoap: 0.9.5
• jms/serializer: 0.11 - 1
• symfony/intl: ~2.5

Requires (Dev)

• goetas/xsd-reader: 2.*@dev
• goetas/xsd2php: 2.*@dev
• jms/serializer-bundle: ~1.0
• phpunit/phpunit: ~4.0
• symfony/symfony: ~2.5

Suggests

• jms/serializer-bundle: For using as symfony bundle
• ocramius/proxy-manager: For lazy services

MIT

• Nickolay Savchenko

• russian post

README

Библиотека для работы с сервисом отслеживания Почты России. Можно использовать standalone и как symfony bundle.

Installation

There are two recommended ways to install the bundle via Composer:

• using the composer require command:

composer require '3mg/russian-post-bundle:dev-master'

• adding the dependency to your composer.json file:

"require": {
    ..
    "3mg/russian-post-bundle" : "dev-master",
    ..
}

if it fails try add

"minimum-stability": "dev",

Using with symfony

add to AppKernel.php

...
new a3mg\RussianPostBundle\a3mgRussianPostBundle(),
...

add to config.yml

...
# a3mgRussianPostBundle
a3mg_russian_post:
    login: 'your_login'
    password: 'your_password'
...

get service

$api = $this->container->get('russian_post_api');

try {
    /** @var \a3mg\RussianPostBundle\Model\OperationHistoryData $object */
    $object = $api->getTrackOperationHistory("EE123456785KR");
    ...
} catch (\a3mg\RussianPostBundle\Exception\InvalidTrackException $e) {
    ...
} catch (\a3mg\RussianPostBundle\Exception\RussianPostApiException $e) {
    ...
}

Using stand alone

use a3mg\RussianPostBundle\Service\RussianPostApiFactory;
...
$api = RussianPostApiFactory::createApi("your_login", "your_password");
try {
    /** @var \a3mg\RussianPostBundle\Model\OperationHistoryData $object */
    $object = $api->getTrackOperationHistory("EE123456785KR");
    ...
} catch (\a3mg\RussianPostBundle\Exception\InvalidTrackException $e) {
    ...
} catch (\a3mg\RussianPostBundle\Exception\RussianPostApiException $e) {
    ...
}

Development

Updating api model

• composer install
• composer run-script build_rus_post
• composer run-script build_rus_post_metadata

Run tests

./vendor/bin/phpunit --config phpunit.xml.dist