README

用于与俄罗斯邮政追踪服务进行交互的库。可以作为独立使用，也可以作为symfony bundle使用。

安装

可以通过以下两种推荐方式通过Composer安装此包：

• 使用composer require命令

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

• 将依赖项添加到你的composer.json文件中

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

如果失败，请尝试添加

"minimum-stability": "dev",

与symfony一起使用

添加到AppKernel.php

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

添加到config.yml

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

获取服务

$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) {
    ...
}

独立使用

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) {
    ...
}

开发

更新api模型

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

运行测试

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