RetailCRM-Mirror/api-client-php
1
0
Fork 0
mirror of synced 2024-11-25 06:46:07 +03:00
Code Issues Projects Releases Wiki Activity

PSR-2, refactoring, tests

Browse Source
This commit is contained in:
Alex Lushpai 2016-03-12 01:54:33 +03:00
parent 31b1d9d0f1
commit ecb26bc1ff
12 changed files with 458 additions and 174 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.gitignore vendored
View File

@ -1,6 +1,7 @@
/vendor /vendor
/bin /bin
composer.lock composer.lock
composer.phar
phpunit.xml phpunit.xml
.idea .idea
.DS_Store .DS_Store

50
README.md
View File

@ -1,33 +1,31 @@
# PHP-клиент для retailCRM API # retailCRM API PHP client
PHP-клиент для работы с [retailCRM API](http://www.retailcrm.ru/docs/Developers/ApiVersion3). PHP-client for [retailCRM API](http://www.retailcrm.ru/docs/Developers/ApiVersion3).
Рекомендуем обращаться к [документации](http://retailcrm.github.io/api-client-php) по библиотеке, в частности по классу [RetailCrm\ApiClient](http://retailcrm.github.io/api-client-php/class-RetailCrm.ApiClient.html). Use [API documentation](http://retailcrm.github.io/api-client-php)
## Обязательные требования ## Requirements
* PHP версии 5.3 и выше * PHP 5.3 and above
* PHP-расширение cURL * PHP's cURL support
## Установка ## Install
1) Установите [composer](https://getcomposer.org/download/) 1) Get [composer](https://getcomposer.org/download/)
2) Выполните в папке проекта: 2) Run into your project directory:
```bash ```bash
composer require retailcrm/api-client-php ~3.0.0 composer require retailcrm/api-client-php ~3.0.0
``` ```
В конфиг `composer.json` вашего проекта будет добавлена библиотека `retailcrm/api-client-php`, которая установится в папку `vendor/`. При отсутствии файла конфига или папки с вендорами они будут созданы. If you have not used `composer` before, include autoloader into your project.
В случае, если до этого в вашем проекте не использовался `composer`, подключите файл автозагрузки вендоров. Для этого укажите в коде проекта:
```php ```php
require 'path/to/vendor/autoload.php'; require 'path/to/vendor/autoload.php';
``` ```
## Примеры использования ## Usage
### Получение информации о заказе ### Get order
```php ```php
$client = new \RetailCrm\ApiClient( $client = new \RetailCrm\ApiClient(
'https://demo.retailcrm.ru', 'https://demo.retailcrm.ru',
@ -38,30 +36,30 @@ $client = new \RetailCrm\ApiClient(
try { try {
$response = $client->ordersGet('M-2342'); $response = $client->ordersGet('M-2342');
} catch (\RetailCrm\Exception\CurlException $e) { } catch (\RetailCrm\Exception\CurlException $e) {
echo "Сетевые проблемы. Ошибка подключения к retailCRM: " . $e->getMessage(); echo "Connection error: " . $e->getMessage();
} }
if ($response->isSuccessful()) { if ($response->isSuccessful()) {
echo $response->order['totalSumm']; echo $response->order['totalSumm'];
// или $response['order']['totalSumm']; // or $response['order']['totalSumm'];
// или // or
// $order = $response->getOrder(); // $order = $response->getOrder();
// $order['totalSumm']; // $order['totalSumm'];
} else { } else {
echo sprintf( echo sprintf(
"Ошибка получения информации о заказа: [Статус HTTP-ответа %s] %s", "Error: [HTTP-code %s] %s",
$response->getStatusCode(), $response->getStatusCode(),
$response->getErrorMsg() $response->getErrorMsg()
); );
// получить детализацию ошибок // error details
//if (isset($response['errors'])) { //if (isset($response['errors'])) {
// print_r($response['errors']); // print_r($response['errors']);
//} //}
} }
``` ```
### Создание заказа ### Create order
```php ```php
$client = new \RetailCrm\ApiClient( $client = new \RetailCrm\ApiClient(
@ -82,21 +80,21 @@ try {
) )
)); ));
} catch (\RetailCrm\Exception\CurlException $e) { } catch (\RetailCrm\Exception\CurlException $e) {
echo "Сетевые проблемы. Ошибка подключения к retailCRM: " . $e->getMessage(); echo "Connection error: " . $e->getMessage();
} }
if ($response->isSuccessful() && 201 === $response->getStatusCode()) { if ($response->isSuccessful() && 201 === $response->getStatusCode()) {
echo 'Заказ успешно создан. ID заказа в retailCRM = ' . $response->id; echo 'Order successfully created. Order ID into retailCRM = ' . $response->id;
// или $response['id']; // or $response['id'];
// или $response->getId(); // or $response->getId();
} else { } else {
echo sprintf( echo sprintf(
"Ошибка создания заказа: [Статус HTTP-ответа %s] %s", "Error: [HTTP-code %s] %s",
$response->getStatusCode(), $response->getStatusCode(),
$response->getErrorMsg() $response->getErrorMsg()
); );
// получить детализацию ошибок // error details
//if (isset($response['errors'])) { //if (isset($response['errors'])) {
// print_r($response['errors']); // print_r($response['errors']);
//} //}

13
composer.json
View File

@ -4,6 +4,7 @@
"type": "library", "type": "library",
"keywords": ["API", "retailCRM", "REST"], "keywords": ["API", "retailCRM", "REST"],
"homepage": "http://www.retailcrm.ru/", "homepage": "http://www.retailcrm.ru/",
"license": "MIT",
"authors": [ "authors": [
{ {
"name": "retailCRM", "name": "retailCRM",
@ -12,15 +13,17 @@
], ],
"require": { "require": {
"php": ">=5.3.0", "php": ">=5.3.0",
"ext-curl": "*" "ext-curl": "*",
"phpunit/php-code-coverage": "3.3.0",
"phpunit/php-invoker": "1.1.4"
}, },
"require-dev": { "require-dev": {
"phpunit/phpunit": "3.7.*", "phpunit/phpunit": "5.2.*",
"phpmd/phpmd": "2.1.*", "phpmd/phpmd": "2.4.*",
"sebastian/phpcpd": "2.0.*", "sebastian/phpcpd": "2.0.*",
"sebastian/phpdcd": "1.0.*", "sebastian/phpdcd": "1.0.*",
"squizlabs/php_codesniffer": "dev-master", "squizlabs/php_codesniffer": "2.5.*",
"apigen/apigen": "~4.0@dev" "apigen/apigen": "4.1.*"
}, },
"support": { "support": {
"email": "support@intarocrm.ru" "email": "support@intarocrm.ru"

349
lib/RetailCrm/ApiClient.php
View File

@ -35,11 +35,13 @@ class ApiClient
* @param string $apiKey api key * @param string $apiKey api key
* @param string $site site code * @param string $site site code
* *
* @throws \InvalidArgumentException
*
* @return mixed * @return mixed
*/ */
public function __construct($url, $apiKey, $site = null) public function __construct($url, $apiKey, $site = null)
{ {
if ('/' != substr($url, strlen($url) - 1, 1)) { if ('/' !== substr($url, strlen($url) - 1, 1)) {
$url .= '/'; $url .= '/';
} }
@ -56,13 +58,17 @@ class ApiClient
* @param int $page (default: null) * @param int $page (default: null)
* @param int $limit (default: null) * @param int $limit (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersList(array $filter = array(), $page = null, $limit = null) public function ordersList(array $filter = array(), $page = null, $limit = null)
{ {
$parameters = array(); $parameters = array();
if (sizeof($filter)) { if (count($filter)) {
$parameters['filter'] = $filter; $parameters['filter'] = $filter;
} }
if (null !== $page) { if (null !== $page) {
@ -85,18 +91,22 @@ class ApiClient
* @param array $order order data * @param array $order order data
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersCreate(array $order, $site = null) public function ordersCreate(array $order, $site = null)
{ {
if (! sizeof($order)) { if (!count($order)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Parameter `order` must contains a data' 'Parameter `order` must contains a data'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/orders/create", '/orders/create',
Client::METHOD_POST, Client::METHOD_POST,
$this->fillSite($site, array('order' => json_encode($order))) $this->fillSite($site, array('order' => json_encode($order)))
); );
@ -107,18 +117,22 @@ class ApiClient
* *
* @param array $ids order identificators * @param array $ids order identificators
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersFixExternalIds(array $ids) public function ordersFixExternalIds(array $ids)
{ {
if (! sizeof($ids)) { if (! count($ids)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Method parameter must contains at least one IDs pair' 'Method parameter must contains at least one IDs pair'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/orders/fix-external-ids", '/orders/fix-external-ids',
Client::METHOD_POST, Client::METHOD_POST,
array('orders' => json_encode($ids) array('orders' => json_encode($ids)
) )
@ -134,6 +148,10 @@ class ApiClient
* @param int $offset (default: 0) * @param int $offset (default: 0)
* @param bool $skipMyChanges (default: true) * @param bool $skipMyChanges (default: true)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersHistory( public function ordersHistory(
@ -174,6 +192,10 @@ class ApiClient
* @param array $ids (default: array()) * @param array $ids (default: array())
* @param array $externalIds (default: array()) * @param array $externalIds (default: array())
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersStatuses( public function ordersStatuses(
@ -182,10 +204,10 @@ class ApiClient
) { ) {
$parameters = array(); $parameters = array();
if (sizeof($ids)) { if (count($ids)) {
$parameters['ids'] = $ids; $parameters['ids'] = $ids;
} }
if (sizeof($externalIds)) { if (count($externalIds)) {
$parameters['externalIds'] = $externalIds; $parameters['externalIds'] = $externalIds;
} }
@ -202,18 +224,22 @@ class ApiClient
* @param array $orders array of orders * @param array $orders array of orders
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersUpload(array $orders, $site = null) public function ordersUpload(array $orders, $site = null)
{ {
if (! sizeof($orders)) { if (!count($orders)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Parameter `orders` must contains array of the orders' 'Parameter `orders` must contains array of the orders'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/orders/upload", '/orders/upload',
Client::METHOD_POST, Client::METHOD_POST,
$this->fillSite($site, array('orders' => json_encode($orders))) $this->fillSite($site, array('orders' => json_encode($orders)))
); );
@ -226,6 +252,10 @@ class ApiClient
* @param string $by (default: 'externalId') * @param string $by (default: 'externalId')
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersGet($id, $by = 'externalId', $site = null) public function ordersGet($id, $by = 'externalId', $site = null)
@ -246,11 +276,15 @@ class ApiClient
* @param string $by (default: 'externalId') * @param string $by (default: 'externalId')
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersEdit(array $order, $by = 'externalId', $site = null) public function ordersEdit(array $order, $by = 'externalId', $site = null)
{ {
if (! sizeof($order)) { if (!count($order)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Parameter `order` must contains a data' 'Parameter `order` must contains a data'
); );
@ -258,14 +292,14 @@ class ApiClient
$this->checkIdParameter($by); $this->checkIdParameter($by);
if (! isset($order[$by])) { if (!array_key_exists($by, $order)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
sprintf('Order array must contain the "%s" parameter.', $by) sprintf('Order array must contain the "%s" parameter.', $by)
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/orders/" . $order[$by] . "/edit", sprintf('/orders/%s/edit', $order[$by]),
Client::METHOD_POST, Client::METHOD_POST,
$this->fillSite( $this->fillSite(
$site, $site,
@ -281,6 +315,10 @@ class ApiClient
* @param int $page (default: null) * @param int $page (default: null)
* @param int $limit (default: null) * @param int $limit (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function customersList( public function customersList(
@ -290,7 +328,7 @@ class ApiClient
) { ) {
$parameters = array(); $parameters = array();
if (sizeof($filter)) { if (count($filter)) {
$parameters['filter'] = $filter; $parameters['filter'] = $filter;
} }
if (null !== $page) { if (null !== $page) {
@ -313,18 +351,22 @@ class ApiClient
* @param array $customer customer data * @param array $customer customer data
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function customersCreate(array $customer, $site = null) public function customersCreate(array $customer, $site = null)
{ {
if (! sizeof($customer)) { if (! count($customer)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Parameter `customer` must contains a data' 'Parameter `customer` must contains a data'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/customers/create", '/customers/create',
Client::METHOD_POST, Client::METHOD_POST,
$this->fillSite($site, array('customer' => json_encode($customer))) $this->fillSite($site, array('customer' => json_encode($customer)))
); );
@ -335,18 +377,22 @@ class ApiClient
* *
* @param array $ids ids mapping * @param array $ids ids mapping
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function customersFixExternalIds(array $ids) public function customersFixExternalIds(array $ids)
{ {
if (! sizeof($ids)) { if (! count($ids)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Method parameter must contains at least one IDs pair' 'Method parameter must contains at least one IDs pair'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/customers/fix-external-ids", '/customers/fix-external-ids',
Client::METHOD_POST, Client::METHOD_POST,
array('customers' => json_encode($ids)) array('customers' => json_encode($ids))
); );
@ -358,18 +404,22 @@ class ApiClient
* @param array $customers array of customers * @param array $customers array of customers
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function customersUpload(array $customers, $site = null) public function customersUpload(array $customers, $site = null)
{ {
if (! sizeof($customers)) { if (! count($customers)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Parameter `customers` must contains array of the customers' 'Parameter `customers` must contains array of the customers'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/customers/upload", '/customers/upload',
Client::METHOD_POST, Client::METHOD_POST,
$this->fillSite($site, array('customers' => json_encode($customers))) $this->fillSite($site, array('customers' => json_encode($customers)))
); );
@ -382,6 +432,10 @@ class ApiClient
* @param string $by (default: 'externalId') * @param string $by (default: 'externalId')
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function customersGet($id, $by = 'externalId', $site = null) public function customersGet($id, $by = 'externalId', $site = null)
@ -402,11 +456,15 @@ class ApiClient
* @param string $by (default: 'externalId') * @param string $by (default: 'externalId')
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function customersEdit(array $customer, $by = 'externalId', $site = null) public function customersEdit(array $customer, $by = 'externalId', $site = null)
{ {
if (! sizeof($customer)) { if (!count($customer)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Parameter `customer` must contains a data' 'Parameter `customer` must contains a data'
); );
@ -414,14 +472,14 @@ class ApiClient
$this->checkIdParameter($by); $this->checkIdParameter($by);
if (! isset($customer[$by])) { if (!array_key_exists($by, $customer)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
sprintf('Customer array must contain the "%s" parameter.', $by) sprintf('Customer array must contain the "%s" parameter.', $by)
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/customers/" . $customer[$by] . "/edit", sprintf('/customers/%s/edit', $customer[$by]),
Client::METHOD_POST, Client::METHOD_POST,
$this->fillSite( $this->fillSite(
$site, $site,
@ -437,6 +495,10 @@ class ApiClient
* @param int $page (default: null) * @param int $page (default: null)
* @param int $limit (default: null) * @param int $limit (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersPacksList( public function ordersPacksList(
@ -446,7 +508,7 @@ class ApiClient
) { ) {
$parameters = array(); $parameters = array();
if (sizeof($filter)) { if (count($filter)) {
$parameters['filter'] = $filter; $parameters['filter'] = $filter;
} }
if (null !== $page) { if (null !== $page) {
@ -469,18 +531,22 @@ class ApiClient
* @param array $pack pack data * @param array $pack pack data
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersPacksCreate(array $pack, $site = null) public function ordersPacksCreate(array $pack, $site = null)
{ {
if (! sizeof($pack)) { if (!count($pack)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Parameter `pack` must contains a data' 'Parameter `pack` must contains a data'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/orders/packs/create", '/orders/packs/create',
Client::METHOD_POST, Client::METHOD_POST,
$this->fillSite($site, array('pack' => json_encode($pack))) $this->fillSite($site, array('pack' => json_encode($pack)))
); );
@ -493,6 +559,10 @@ class ApiClient
* @param int $page (default: null) * @param int $page (default: null)
* @param int $limit (default: null) * @param int $limit (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersPacksHistory( public function ordersPacksHistory(
@ -502,7 +572,7 @@ class ApiClient
) { ) {
$parameters = array(); $parameters = array();
if (sizeof($filter)) { if (count($filter)) {
$parameters['filter'] = $filter; $parameters['filter'] = $filter;
} }
if (null !== $page) { if (null !== $page) {
@ -524,6 +594,10 @@ class ApiClient
* *
* @param string $id pack identificator * @param string $id pack identificator
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersPacksGet($id) public function ordersPacksGet($id)
@ -532,7 +606,10 @@ class ApiClient
throw new \InvalidArgumentException('Parameter `id` must be set'); throw new \InvalidArgumentException('Parameter `id` must be set');
} }
return $this->client->makeRequest("/orders/packs/$id", Client::METHOD_GET); return $this->client->makeRequest(
"/orders/packs/$id",
Client::METHOD_GET
);
} }
/** /**
@ -540,6 +617,10 @@ class ApiClient
* *
* @param string $id pack identificator * @param string $id pack identificator
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersPacksDelete($id) public function ordersPacksDelete($id)
@ -549,7 +630,7 @@ class ApiClient
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/orders/packs/$id/delete", sprintf('/orders/packs/%s/delete', $id),
Client::METHOD_POST Client::METHOD_POST
); );
} }
@ -560,20 +641,22 @@ class ApiClient
* @param array $pack pack data * @param array $pack pack data
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function ordersPacksEdit(array $pack, $site = null) public function ordersPacksEdit(array $pack, $site = null)
{ {
if (! sizeof($pack) || empty($pack['id'])) { if (!count($pack) || empty($pack['id'])) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Parameter `pack` must contains a data & pack `id` must be set' 'Parameter `pack` must contains a data & pack `id` must be set'
); );
} }
$id = $pack['id'];
return $this->client->makeRequest( return $this->client->makeRequest(
"/orders/packs/$id/edit", sprintf('/orders/packs/%s/edit', $pack['id']),
Client::METHOD_POST, Client::METHOD_POST,
$this->fillSite($site, array('pack' => json_encode($pack))) $this->fillSite($site, array('pack' => json_encode($pack)))
); );
@ -585,19 +668,21 @@ class ApiClient
* @param array $filter (default: array()) * @param array $filter (default: array())
* @param int $page (default: null) * @param int $page (default: null)
* @param int $limit (default: null) * @param int $limit (default: null)
* @param string $site (default: null) *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
* *
* @return ApiResponse * @return ApiResponse
*/ */
public function storeInventories( public function storeInventories(
array $filter = array(), array $filter = array(),
$page = null, $page = null,
$limit = null, $limit = null
$site = null
) { ) {
$parameters = array(); $parameters = array();
if (sizeof($filter)) { if (count($filter)) {
$parameters['filter'] = $filter; $parameters['filter'] = $filter;
} }
if (null !== $page) { if (null !== $page) {
@ -610,7 +695,7 @@ class ApiClient
return $this->client->makeRequest( return $this->client->makeRequest(
'/store/inventories', '/store/inventories',
Client::METHOD_GET, Client::METHOD_GET,
$this->fillSite($site, $parameters) $parameters
); );
} }
@ -620,18 +705,22 @@ class ApiClient
* @param array $offers offers data * @param array $offers offers data
* @param string $site (default: null) * @param string $site (default: null)
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function storeInventoriesUpload(array $offers, $site = null) public function storeInventoriesUpload(array $offers, $site = null)
{ {
if (! sizeof($offers)) { if (!count($offers)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Parameter `offers` must contains array of the offers' 'Parameter `offers` must contains array of the offers'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/store/inventories/upload", '/store/inventories/upload',
Client::METHOD_POST, Client::METHOD_POST,
$this->fillSite($site, array('offers' => json_encode($offers))) $this->fillSite($site, array('offers' => json_encode($offers)))
); );
@ -640,6 +729,10 @@ class ApiClient
/** /**
* Returns available county list * Returns available county list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function countriesList() public function countriesList()
@ -653,6 +746,10 @@ class ApiClient
/** /**
* Returns deliveryServices list * Returns deliveryServices list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function deliveryServicesList() public function deliveryServicesList()
@ -668,18 +765,22 @@ class ApiClient
* *
* @param array $data delivery service data * @param array $data delivery service data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function deliveryServicesEdit(array $data) public function deliveryServicesEdit(array $data)
{ {
if (! isset($data['code'])) { if (!array_key_exists('code', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "code" parameter.' 'Data must contain "code" parameter.'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/delivery-services/' . $data['code'] . '/edit', sprintf('/reference/delivery-services/%s/edit', $data['code']),
Client::METHOD_POST, Client::METHOD_POST,
array('deliveryService' => json_encode($data)) array('deliveryService' => json_encode($data))
); );
@ -688,6 +789,10 @@ class ApiClient
/** /**
* Returns deliveryTypes list * Returns deliveryTypes list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function deliveryTypesList() public function deliveryTypesList()
@ -703,18 +808,22 @@ class ApiClient
* *
* @param array $data delivery type data * @param array $data delivery type data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function deliveryTypesEdit(array $data) public function deliveryTypesEdit(array $data)
{ {
if (! isset($data['code'])) { if (!array_key_exists('code', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "code" parameter.' 'Data must contain "code" parameter.'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/delivery-types/' . $data['code'] . '/edit', sprintf('/reference/delivery-types/%s/edit', $data['code']),
Client::METHOD_POST, Client::METHOD_POST,
array('deliveryType' => json_encode($data)) array('deliveryType' => json_encode($data))
); );
@ -723,12 +832,17 @@ class ApiClient
/** /**
* Returns orderMethods list * Returns orderMethods list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function orderMethodsList() public function orderMethodsList()
{ {
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/order-methods', Client::METHOD_GET '/reference/order-methods',
Client::METHOD_GET
); );
} }
@ -737,18 +851,22 @@ class ApiClient
* *
* @param array $data order method data * @param array $data order method data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function orderMethodsEdit(array $data) public function orderMethodsEdit(array $data)
{ {
if (! isset($data['code'])) { if (!array_key_exists('code', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "code" parameter.' 'Data must contain "code" parameter.'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/order-methods/' . $data['code'] . '/edit', sprintf('/reference/order-methods/%s/edit', $data['code']),
Client::METHOD_POST, Client::METHOD_POST,
array('orderMethod' => json_encode($data)) array('orderMethod' => json_encode($data))
); );
@ -757,6 +875,10 @@ class ApiClient
/** /**
* Returns orderTypes list * Returns orderTypes list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function orderTypesList() public function orderTypesList()
@ -772,18 +894,22 @@ class ApiClient
* *
* @param array $data order type data * @param array $data order type data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function orderTypesEdit(array $data) public function orderTypesEdit(array $data)
{ {
if (! isset($data['code'])) { if (!array_key_exists('code', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "code" parameter.' 'Data must contain "code" parameter.'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/order-types/' . $data['code'] . '/edit', sprintf('/reference/order-types/%s/edit', $data['code']),
Client::METHOD_POST, Client::METHOD_POST,
array('orderType' => json_encode($data)) array('orderType' => json_encode($data))
); );
@ -792,6 +918,10 @@ class ApiClient
/** /**
* Returns paymentStatuses list * Returns paymentStatuses list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function paymentStatusesList() public function paymentStatusesList()
@ -807,18 +937,22 @@ class ApiClient
* *
* @param array $data payment status data * @param array $data payment status data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function paymentStatusesEdit(array $data) public function paymentStatusesEdit(array $data)
{ {
if (! isset($data['code'])) { if (!array_key_exists('code', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "code" parameter.' 'Data must contain "code" parameter.'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/payment-statuses/' . $data['code'] . '/edit', sprintf('/reference/payment-statuses/%s/edit', $data['code']),
Client::METHOD_POST, Client::METHOD_POST,
array('paymentStatus' => json_encode($data)) array('paymentStatus' => json_encode($data))
); );
@ -827,6 +961,10 @@ class ApiClient
/** /**
* Returns paymentTypes list * Returns paymentTypes list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function paymentTypesList() public function paymentTypesList()
@ -842,18 +980,22 @@ class ApiClient
* *
* @param array $data payment type data * @param array $data payment type data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function paymentTypesEdit(array $data) public function paymentTypesEdit(array $data)
{ {
if (! isset($data['code'])) { if (!array_key_exists('code', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "code" parameter.' 'Data must contain "code" parameter.'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/payment-types/' . $data['code'] . '/edit', sprintf('/reference/payment-types/%s/edit', $data['code']),
Client::METHOD_POST, Client::METHOD_POST,
array('paymentType' => json_encode($data)) array('paymentType' => json_encode($data))
); );
@ -862,6 +1004,10 @@ class ApiClient
/** /**
* Returns productStatuses list * Returns productStatuses list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function productStatusesList() public function productStatusesList()
@ -877,18 +1023,22 @@ class ApiClient
* *
* @param array $data product status data * @param array $data product status data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function productStatusesEdit(array $data) public function productStatusesEdit(array $data)
{ {
if (! isset($data['code'])) { if (!array_key_exists('code', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "code" parameter.' 'Data must contain "code" parameter.'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/product-statuses/' . $data['code'] . '/edit', sprintf('/reference/product-statuses/%s/edit', $data['code']),
Client::METHOD_POST, Client::METHOD_POST,
array('productStatus' => json_encode($data)) array('productStatus' => json_encode($data))
); );
@ -897,11 +1047,18 @@ class ApiClient
/** /**
* Returns sites list * Returns sites list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function sitesList() public function sitesList()
{ {
return $this->client->makeRequest('/reference/sites', Client::METHOD_GET); return $this->client->makeRequest(
'/reference/sites',
Client::METHOD_GET
);
} }
/** /**
@ -909,18 +1066,22 @@ class ApiClient
* *
* @param array $data site data * @param array $data site data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function sitesEdit(array $data) public function sitesEdit(array $data)
{ {
if (! isset($data['code'])) { if (!array_key_exists('code', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "code" parameter.' 'Data must contain "code" parameter.'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/sites/' . $data['code'] . '/edit', sprintf('/reference/sites/%s/edit', $data['code']),
Client::METHOD_POST, Client::METHOD_POST,
array('site' => json_encode($data)) array('site' => json_encode($data))
); );
@ -929,6 +1090,10 @@ class ApiClient
/** /**
* Returns statusGroups list * Returns statusGroups list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function statusGroupsList() public function statusGroupsList()
@ -942,11 +1107,18 @@ class ApiClient
/** /**
* Returns statuses list * Returns statuses list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function statusesList() public function statusesList()
{ {
return $this->client->makeRequest('/reference/statuses', Client::METHOD_GET); return $this->client->makeRequest(
'/reference/statuses',
Client::METHOD_GET
);
} }
/** /**
@ -954,18 +1126,22 @@ class ApiClient
* *
* @param array $data status data * @param array $data status data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function statusesEdit(array $data) public function statusesEdit(array $data)
{ {
if (! isset($data['code'])) { if (!array_key_exists('code', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "code" parameter.' 'Data must contain "code" parameter.'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/statuses/' . $data['code'] . '/edit', sprintf('/reference/statuses/%s/edit', $data['code']),
Client::METHOD_POST, Client::METHOD_POST,
array('status' => json_encode($data)) array('status' => json_encode($data))
); );
@ -974,11 +1150,18 @@ class ApiClient
/** /**
* Returns stores list * Returns stores list
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function storesList() public function storesList()
{ {
return $this->client->makeRequest('/reference/stores', Client::METHOD_GET); return $this->client->makeRequest(
'/reference/stores',
Client::METHOD_GET
);
} }
/** /**
@ -986,24 +1169,28 @@ class ApiClient
* *
* @param array $data site data * @param array $data site data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function storesEdit(array $data) public function storesEdit(array $data)
{ {
if (! isset($data['code'])) { if (!array_key_exists('code', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "code" parameter.' 'Data must contain "code" parameter.'
); );
} }
if (! isset($data['name'])) { if (!array_key_exists('name', $data)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Data must contain "name" parameter.' 'Data must contain "name" parameter.'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
'/reference/stores/' . $data['code'] . '/edit', sprintf('/reference/stores/%s/edit', $data['code']),
Client::METHOD_POST, Client::METHOD_POST,
array('store' => json_encode($data)) array('store' => json_encode($data))
); );
@ -1012,11 +1199,18 @@ class ApiClient
/** /**
* Update CRM basic statistic * Update CRM basic statistic
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function statisticUpdate() public function statisticUpdate()
{ {
return $this->client->makeRequest('/statistic/update', Client::METHOD_GET); return $this->client->makeRequest(
'/statistic/update',
Client::METHOD_GET
);
} }
/** /**
@ -1027,6 +1221,10 @@ class ApiClient
* @param string $code additional phone code * @param string $code additional phone code
* @param string $status call status * @param string $status call status
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function telephonyCallEvent($phone, $type, $code, $status) public function telephonyCallEvent($phone, $type, $code, $status)
@ -1062,18 +1260,22 @@ class ApiClient
* *
* @param array $calls calls data * @param array $calls calls data
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function telephonyCallsUpload(array $calls) public function telephonyCallsUpload(array $calls)
{ {
if (! sizeof($calls)) { if (!count($calls)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
'Parameter `calls` must contains array of the calls' 'Parameter `calls` must contains array of the calls'
); );
} }
return $this->client->makeRequest( return $this->client->makeRequest(
"/telephony/calls/upload", '/telephony/calls/upload',
Client::METHOD_POST, Client::METHOD_POST,
array('calls' => json_encode($calls)) array('calls' => json_encode($calls))
); );
@ -1085,6 +1287,10 @@ class ApiClient
* @param string $phone phone number * @param string $phone phone number
* @param bool $details detailed information * @param bool $details detailed information
* *
* @throws \InvalidArgumentException
* @throws \RetailCrm\Exception\CurlException
* @throws \RetailCrm\Exception\InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function telephonyCallManager($phone, $details) public function telephonyCallManager($phone, $details)
@ -1098,7 +1304,8 @@ class ApiClient
return $this->client->makeRequest( return $this->client->makeRequest(
'/telephony/manager', '/telephony/manager',
Client::METHOD_GET, $parameters Client::METHOD_GET,
$parameters
); );
} }
@ -1129,6 +1336,8 @@ class ApiClient
* *
* @param string $by identify by * @param string $by identify by
* *
* @throws \InvalidArgumentException
*
* @return bool * @return bool
*/ */
protected function checkIdParameter($by) protected function checkIdParameter($by)
@ -1138,7 +1347,7 @@ class ApiClient
'id' 'id'
); );
if (!in_array($by, $allowedForBy)) { if (!in_array($by, $allowedForBy, false)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
sprintf( sprintf(
'Value "%s" for parameter "by" is not valid. Allowed values are %s.', 'Value "%s" for parameter "by" is not valid. Allowed values are %s.',

74
lib/RetailCrm/Http/Client.php
View File

@ -3,6 +3,7 @@
namespace RetailCrm\Http; namespace RetailCrm\Http;
use RetailCrm\Exception\CurlException; use RetailCrm\Exception\CurlException;
use RetailCrm\Exception\InvalidJsonException;
use RetailCrm\Response\ApiResponse; use RetailCrm\Response\ApiResponse;
/** /**
@ -30,6 +31,8 @@ class Client
* *
* @param string $url api url * @param string $url api url
* @param array $defaultParameters array of parameters * @param array $defaultParameters array of parameters
*
* @throws \InvalidArgumentException
*/ */
public function __construct($url, array $defaultParameters = array()) public function __construct($url, array $defaultParameters = array())
{ {
@ -60,24 +63,23 @@ class Client
* @param string $path request url * @param string $path request url
* @param string $method (default: 'GET') * @param string $method (default: 'GET')
* @param array $parameters (default: array()) * @param array $parameters (default: array())
* @param int $timeout (default: 30)
* @param bool $verify (default: false)
* @param bool $debug (default: false)
* *
* @SuppressWarnings(PHPMD.ExcessiveParameterList) * @SuppressWarnings(PHPMD.ExcessiveParameterList)
* *
* @throws \InvalidArgumentException
* @throws CurlException
* @throws InvalidJsonException
*
* @return ApiResponse * @return ApiResponse
*/ */
public function makeRequest( public function makeRequest(
$path, $path,
$method, $method,
array $parameters = array(), array $parameters = array()
$timeout = 30,
$verify = false,
$debug = false
) { ) {
$allowedMethods = array(self::METHOD_GET, self::METHOD_POST); $allowedMethods = array(self::METHOD_GET, self::METHOD_POST);
if (!in_array($method, $allowedMethods)) {
if (!in_array($method, $allowedMethods, false)) {
throw new \InvalidArgumentException( throw new \InvalidArgumentException(
sprintf( sprintf(
'Method "%s" is not valid. Allowed methods are %s', 'Method "%s" is not valid. Allowed methods are %s',
@ -91,53 +93,37 @@ class Client
$url = $this->url . $path; $url = $this->url . $path;
if (self::METHOD_GET === $method && sizeof($parameters)) { if (self::METHOD_GET === $method && count($parameters)) {
$url .= '?' . http_build_query($parameters, '', '&'); $url .= '?' . http_build_query($parameters, '', '&');
} }
$ch = curl_init(); $curlHandler = curl_init();
curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($curlHandler, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($curlHandler, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1); curl_setopt($curlHandler, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($ch, CURLOPT_FAILONERROR, false); curl_setopt($curlHandler, CURLOPT_FAILONERROR, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, $verify); curl_setopt($curlHandler, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, $verify); curl_setopt($curlHandler, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curlHandler, CURLOPT_TIMEOUT, 30);
if (!$debug) { curl_setopt($curlHandler, CURLOPT_CONNECTTIMEOUT, 30);
curl_setopt($ch, CURLOPT_TIMEOUT, (int) $timeout);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, (int) $timeout);
} else {
curl_setopt(
$ch,
CURLOPT_TIMEOUT_MS,
(int) $timeout + ($this->retry * 2000)
);
}
if (self::METHOD_POST === $method) { if (self::METHOD_POST === $method) {
curl_setopt($ch, CURLOPT_POST, true); curl_setopt($curlHandler, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $parameters); curl_setopt($curlHandler, CURLOPT_POSTFIELDS, $parameters);
} }
$responseBody = curl_exec($ch); $responseBody = curl_exec($curlHandler);
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); $statusCode = curl_getinfo($curlHandler, CURLINFO_HTTP_CODE);
$errno = curl_errno($ch); $errno = curl_errno($curlHandler);
$error = curl_error($ch); $error = curl_error($curlHandler);
curl_close($ch); curl_close($curlHandler);
if ($errno && in_array($errno, $this->curlErrors) && $this->retry < 3) { if ($errno && in_array($errno, $this->curlErrors, false) && $this->retry < 3) {
$errno = null; $errno = null;
$error = null; $error = null;
$this->retry += 1; ++$this->retry;
$this->makeRequest( $this->makeRequest($path, $method, $parameters);
$path,
$method,
$parameters,
$timeout,
$verify,
$debug
);
} }
if ($errno) { if ($errno) {

17
lib/RetailCrm/Response/ApiResponse.php
View File

@ -28,6 +28,8 @@ class ApiResponse implements \ArrayAccess
* *
* @param int $statusCode HTTP status code * @param int $statusCode HTTP status code
* @param mixed $responseBody HTTP body * @param mixed $responseBody HTTP body
*
* @throws InvalidJsonException
*/ */
public function __construct($statusCode, $responseBody = null) public function __construct($statusCode, $responseBody = null)
{ {
@ -71,6 +73,10 @@ class ApiResponse implements \ArrayAccess
* Allow to access for the property throw class method * Allow to access for the property throw class method
* *
* @param string $name * @param string $name
* @param $arguments
*
* @throws \InvalidArgumentException
*
* @return mixed * @return mixed
*/ */
public function __call($name, $arguments) public function __call($name, $arguments)
@ -89,6 +95,9 @@ class ApiResponse implements \ArrayAccess
* Allow to access for the property throw object property * Allow to access for the property throw object property
* *
* @param string $name * @param string $name
*
* @throws \InvalidArgumentException
*
* @return mixed * @return mixed
*/ */
public function __get($name) public function __get($name)
@ -103,6 +112,8 @@ class ApiResponse implements \ArrayAccess
/** /**
* @param mixed $offset * @param mixed $offset
* @param mixed $value * @param mixed $value
*
* @throws \BadMethodCallException
*/ */
public function offsetSet($offset, $value) public function offsetSet($offset, $value)
{ {
@ -111,6 +122,8 @@ class ApiResponse implements \ArrayAccess
/** /**
* @param mixed $offset * @param mixed $offset
*
* @throws \BadMethodCallException
*/ */
public function offsetUnset($offset) public function offsetUnset($offset)
{ {
@ -119,6 +132,7 @@ class ApiResponse implements \ArrayAccess
/** /**
* @param mixed $offset * @param mixed $offset
*
* @return bool * @return bool
*/ */
public function offsetExists($offset) public function offsetExists($offset)
@ -128,6 +142,9 @@ class ApiResponse implements \ArrayAccess
/** /**
* @param mixed $offset * @param mixed $offset
*
* @throws \InvalidArgumentException
*
* @return mixed * @return mixed
*/ */
public function offsetGet($offset) public function offsetGet($offset)

3
phpunit.xml.dist
View File

@ -13,6 +13,9 @@
<server name="CRM_URL" value="foo" /> <server name="CRM_URL" value="foo" />
<server name="CRM_API_KEY" value="bar" /> <server name="CRM_API_KEY" value="bar" />
<server name="CRM_SITE" value="zoo" /> <server name="CRM_SITE" value="zoo" />
<server name="CRM_STORE" value="moo" />
<server name="CRM_PACK_ITEM" value="boo" />
<server name="CRM_PACK_QUANTITY" value="goo" />
</php> </php>
<testsuites> <testsuites>

9
tests/RetailCrm/Test/TestCase.php
View File

@ -28,14 +28,19 @@ class TestCase extends \PHPUnit_Framework_TestCase
* Return Client object * Return Client object
* *
* @param string $url (default: null) * @param string $url (default: null)
* @param string $apiKey (default: null) * @param array $defaultParameters (default: array())
*
* @return Client * @return Client
*/ */
public static function getClient($url = null, $defaultParameters = array()) public static function getClient($url = null, $defaultParameters = array())
{ {
return new Client( return new Client(
$url ?: $_SERVER['CRM_URL'] . '/api/' . ApiClient::VERSION, $url ?: $_SERVER['CRM_URL'] . '/api/' . ApiClient::VERSION,
array('apiKey' => isset($defaultParameters['apiKey']) ? $defaultParameters['apiKey'] : $_SERVER['CRM_API_KEY']) array(
'apiKey' => array_key_exists('apiKey', $defaultParameters)
? $defaultParameters['apiKey']
: $_SERVER['CRM_API_KEY']
)
); );
} }
} }

62
tests/RetailCrm/Tests/ApiClientPacksTest.php
View File

@ -26,4 +26,66 @@ class ApiClientPacksTest extends TestCase
'API returns generatedAt in orders assembly history' 'API returns generatedAt in orders assembly history'
); );
} }
/**
* @group integration
*/
public function testOrdersPacksCreate()
{
$client = static::getApiClient();
$pack = array(
'itemId' => $_SERVER['CRM_PACK_ITEM'],
'quantity' => $_SERVER['CRM_PACK_QUANTITY'],
'store' => $_SERVER['CRM_STORE']
);
$response = $client->ordersPacksCreate($pack);
$this->assertInstanceOf('RetailCrm\Response\ApiResponse', $response);
$this->assertEquals(201, $response->getStatusCode());
$this->assertTrue($response->success);
}
/**
* @group integration
*/
public function testOrdersPacksCreateFailed()
{
$client = static::getApiClient();
$pack = array(
'itemId' => 12,
'store' => $_SERVER['CRM_STORE'],
'quantity' => 2
);
$response = $client->ordersPacksCreate($pack);
$this->assertInstanceOf('RetailCrm\Response\ApiResponse', $response);
$this->assertEquals(400, $response->getStatusCode());
$this->assertFalse($response->success);
}
/**
* @group integration
*/
public function testOrdersPacksGet()
{
$client = static::getApiClient();
$response = $client->ordersPacksGet(1);
$this->assertInstanceOf('RetailCrm\Response\ApiResponse', $response);
$this->assertEquals(200, $response->getStatusCode());
$this->assertTrue($response->success);
}
/**
* @group integration
*/
public function testOrdersPacksDelete()
{
$client = static::getApiClient();
$response = $client->ordersPacksDelete(1);
$this->assertInstanceOf('RetailCrm\Response\ApiResponse', $response);
$this->assertEquals(200, $response->getStatusCode());
$this->assertTrue($response->success);
}
} }

22
tests/RetailCrm/Tests/ApiClientStoreTest.php
View File

@ -4,6 +4,10 @@ namespace RetailCrm\Tests;
use RetailCrm\Test\TestCase; use RetailCrm\Test\TestCase;
/**
* Class ApiClientStoreTest
* @package RetailCrm\Tests
*/
class ApiClientStoreTest extends TestCase class ApiClientStoreTest extends TestCase
{ {
/** /**
@ -30,8 +34,7 @@ class ApiClientStoreTest extends TestCase
public function testStoreInventoriesUploadExceptionEmpty() public function testStoreInventoriesUploadExceptionEmpty()
{ {
$client = static::getApiClient(); $client = static::getApiClient();
$client->storeInventoriesUpload(array());
$response = $client->storeInventoriesUpload(array());
} }
/** /**
@ -47,20 +50,27 @@ class ApiClientStoreTest extends TestCase
$response = $client->storeInventoriesUpload(array( $response = $client->storeInventoriesUpload(array(
array( array(
'externalId' => $externalIdA, 'externalId' => $externalIdA,
'stores' => array(
array(
'code' => $_SERVER['CRM_STORE'],
'available' => 10, 'available' => 10,
'purchasePrice' => 1700 'purchasePrice' => 1700
)
)
), ),
array( array(
'externalId' => $externalIdB, 'externalId' => $externalIdB,
'stores' => array(
array(
'code' => $_SERVER['CRM_STORE'],
'available' => 20, 'available' => 20,
'purchasePrice' => 1500 'purchasePrice' => 1500
)
)
), ),
)); ));
$this->assertInstanceOf('RetailCrm\Response\ApiResponse', $response); $this->assertInstanceOf('RetailCrm\Response\ApiResponse', $response);
$this->assertTrue( $this->assertTrue($response->isSuccessful());
$response->isSuccessful(),
'Got offer'
);
} }
/** /**

10
tests/RetailCrm/Tests/Http/ClientTest.php
View File

@ -58,14 +58,4 @@ class ClientTest extends TestCase
$this->assertInstanceOf('RetailCrm\Response\ApiResponse', $response); $this->assertInstanceOf('RetailCrm\Response\ApiResponse', $response);
$this->assertEquals(200, $response->getStatusCode()); $this->assertEquals(200, $response->getStatusCode());
} }
/**
* @group integration
*/
public function testMakeRequestRepeatOnTimeout()
{
$client = static::getClient();
$response = $client->makeRequest('/orders', Client::METHOD_GET, array(), 1, false, true);
$this->assertGreaterThanOrEqual(1, $client->retry);
}
} }

2
tests/RetailCrm/Tests/Response/ApiResponseTest.php
View File

@ -29,7 +29,7 @@ class ApiResponseTest extends TestCase
/** /**
* @group unit * @group unit
* @expectedException RetailCrm\Exception\InvalidJsonException * @expectedException \RetailCrm\Exception\InvalidJsonException
*/ */
public function testJsonInvalid() public function testJsonInvalid()
{ {