Skip to content

Commit 39ba935

Browse files
committed
big commit
1 parent c5041ba commit 39ba935

11 files changed

+34
-184
lines changed

src/BaseRequester.php

-3
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,6 @@
44

55
use GuzzleHttp\Client;
66

7-
/**
8-
* @author Артём Соколовский <dev.sokolovsky@gmail.com>
9-
*/
107
abstract class BaseRequester
118
{
129
/**

src/Cleaner.php

+13-29
Original file line numberDiff line numberDiff line change
@@ -8,26 +8,26 @@
88
use GuzzleHttp\Client;
99
use GuzzleHttp\RequestOptions;
1010

11-
/**
12-
* Класс для постройки запросов к стандартизацию.
13-
*
14-
* @author Артём Соколовский <dev.sokolovsky@gmail.com>
15-
*/
1611
final class Cleaner
1712
{
18-
/** @var string Базовая URL для обращения. */
19-
const BASE_URL = 'https://cleaner.dadata.ru/api/v1/clean/';
20-
21-
/** @var Client Http client. */
13+
/**
14+
* @var Client Http client.
15+
*/
2216
private Client $_httpClient;
2317

24-
/** @var array Http options. */
18+
/**
19+
* @var array Http options.
20+
*/
2521
private array $_httpOptions;
2622

27-
/** @var string Токен доступа к API DaData.Ru */
23+
/**
24+
* @var string Токен доступа к API DaData.Ru
25+
*/
2826
private string $_accessToken;
2927

30-
/** @var string Секрет от API DaData.Ru */
28+
/**
29+
* @var string Секрет от API DaData.Ru
30+
*/
3131
private string $_secret;
3232

3333
/**
@@ -42,7 +42,7 @@ public function __construct(string $accessToken, string $secret, int $timeOut =
4242
$this->_secret = $secret;
4343

4444
$this->_httpClient = new Client([
45-
'base_uri' => self::BASE_URL,
45+
'base_uri' => 'https://cleaner.dadata.ru/api/v1/clean/',
4646
'timeout' => $timeOut,
4747
]);
4848

@@ -73,11 +73,6 @@ public function reSetAccessToken(string $accessToken, string $secret): self
7373
return $this;
7474
}
7575

76-
/**
77-
* Разбор адреса из строки «стандартизация»
78-
* @param string $query Адрес.
79-
* @return AddressRequester
80-
*/
8176
public function requesterAddress(string $query): AddressRequester
8277
{
8378
$address = new AddressRequester($query);
@@ -88,11 +83,6 @@ public function requesterAddress(string $query): AddressRequester
8883
return $address;
8984
}
9085

91-
/**
92-
* Разбор ФИО из строки «стандартизация»
93-
* @param string $query ФИО.
94-
* @return NameRequester
95-
*/
9686
public function requesterName(string $query): NameRequester
9787
{
9888
$name = new NameRequester($query);
@@ -103,12 +93,6 @@ public function requesterName(string $query): NameRequester
10393
return $name;
10494
}
10595

106-
/**
107-
* Проверяет телефон по справочнику Россвязи, определяет оператора с учётом переноса номеров, заполняет страну,
108-
* город и часовой пояс.
109-
* @param string $query Телефон.
110-
* @return PhoneRequester
111-
*/
11296
public function requesterPhone(string $query): PhoneRequester
11397
{
11498
$name = new PhoneRequester($query);

src/Suggestions.php

+19-38
Original file line numberDiff line numberDiff line change
@@ -9,36 +9,33 @@
99
use c7v\dadata\requesters\FindByIdPartyRequester;
1010
use c7v\dadata\requesters\FindByIdBankRequester;
1111

12-
/**
13-
* Класс для постройки запросов для получения информации.
14-
*
15-
* @author Артём Соколовский <dev.sokolovsky@gmail.com>
16-
*/
1712
final class Suggestions
1813
{
19-
/** @var string Базовая URL для обращения. */
20-
const BASE_URL = 'https://suggestions.dadata.ru/suggestions/api/';
21-
22-
/** @var Client Http client. */
14+
/**
15+
* @var Client Http client.
16+
*/
2317
private Client $_httpClient;
2418

25-
/** @var array Http options. */
19+
/**
20+
* @var array Http options.
21+
*/
2622
private array $_httpOptions;
2723

28-
/** @var string Токен доступа к API DaData.Ru */
24+
/**
25+
* @var string Токен доступа к API DaData.Ru
26+
*/
2927
private string $_accessToken;
3028

31-
/**
32-
* @param string $accessToken Токен доступа к API DaData.Ru
33-
* @param int $timeOut TimeOut для запроса.
34-
*/
29+
/**
30+
* @param string $accessToken Токен доступа к API DaData.Ru
31+
*/
3532
public function __construct(string $accessToken, int $timeOut = 60)
3633
{
3734
/** @var string _accessToken */
3835
$this->_accessToken = $accessToken;
3936

4037
$this->_httpClient = new Client([
41-
'base_uri' => self::BASE_URL,
38+
'base_uri' => 'https://suggestions.dadata.ru/suggestions/api/',
4239
'timeout' => $timeOut,
4340
]);
4441

@@ -58,6 +55,7 @@ public function __construct(string $accessToken, int $timeOut = 60)
5855
public function reSetAccessToken(string $accessToken): self
5956
{
6057
$this->_accessToken = $accessToken;
58+
6159
$this->_httpOptions = [
6260
RequestOptions::HEADERS => [
6361
'Authorization' => 'Token ' . $this->_accessToken
@@ -66,11 +64,10 @@ public function reSetAccessToken(string $accessToken): self
6664
return $this;
6765
}
6866

69-
/**
70-
* Получить данные по ИНН.
71-
* @param string $inn ИНН компании или индивидуального предпринимателя.
72-
* @return FindByIdPartyRequester
73-
*/
67+
/**
68+
* Получить данные по ИНН.
69+
* @return FindByIdPartyRequester
70+
*/
7471
public function requesterFindByIdParty(string $inn): FindByIdPartyRequester
7572
{
7673
$findById = new FindByIdPartyRequester($inn);
@@ -81,12 +78,6 @@ public function requesterFindByIdParty(string $inn): FindByIdPartyRequester
8178
return $findById;
8279
}
8380

84-
/**
85-
* Банк по БИК, SWIFT, ИНН, рег. номеру
86-
* @param string $query БИК, SWIFT, ИНН и рег. номер банка
87-
* @param string|null $kpp Дополнительно можно указать КПП если параметр $query имеет значение ИНН.
88-
* @return FindByIdBankRequester
89-
*/
9081
public function requesterFindByIdBank(string $query, string $kpp = null): FindByIdBankRequester
9182
{
9283
$findById = new FindByIdBankRequester($query, $kpp);
@@ -97,12 +88,7 @@ public function requesterFindByIdBank(string $query, string $kpp = null): FindBy
9788
return $findById;
9889
}
9990

100-
/**
101-
* Справочник инспекций Налоговой службы.
102-
* @param string $query Поиск работает по полям: code, name_short и address.
103-
* @return FindByIdFnsUnitRequester
104-
*/
105-
public function requesterFindByIdFnsUnit(string $query): FindByIdFnsUnitRequester
91+
public function requesterFindByIdFnsUnit(int $query): FindByIdFnsUnitRequester
10692
{
10793
$findById = new FindByIdFnsUnitRequester($query);
10894

@@ -112,11 +98,6 @@ public function requesterFindByIdFnsUnit(string $query): FindByIdFnsUnitRequeste
11298
return $findById;
11399
}
114100

115-
/**
116-
* Отделения Почты России.
117-
* @param string $query Поиск работает по полям: postal_code и address_str.
118-
* @return FindByAddressPostalUnitRequester
119-
*/
120101
public function requesterFindByAddressPostalUnit(string $query): FindByAddressPostalUnitRequester
121102
{
122103
$findById = new FindByAddressPostalUnitRequester($query);

src/helpers/StyleData.php

+1-21
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,8 @@
22

33
namespace c7v\dadata\helpers;
44

5-
/**
6-
* @author Артём Соколовский <dev.sokolovsky@gmail.com>
7-
*/
85
class StyleData
96
{
10-
/**
11-
* @param string $string Название компании.
12-
* @return string
13-
*/
147
public static function normalQuotes(string $string): string
158
{
169
return preg_replace([
@@ -22,30 +15,17 @@ public static function normalQuotes(string $string): string
2215
], $string);
2316
}
2417

25-
/**
26-
* @param int $time Метка времени.
27-
* @return string
28-
*/
2918
public static function normalDate(int $time): string
3019
{
3120
return date('d.m.Y', substr($time,0,-3));
3221
}
3322

34-
/**
35-
* @param string $post Должность
36-
* @param string $charset Кодировка строки
37-
* @return string
38-
*/
39-
public static function normalManagementPost(string $post, string $charset = "utf-8"): string
23+
public static function normalManagementPost(string $post, $charset = "utf-8"): string
4024
{
4125
$post = mb_strtolower($post, 'utf-8');
4226
return mb_strtoupper(mb_substr($post, 0, 1, $charset), $charset).mb_substr($post, 1, mb_strlen($post, $charset)-1, $charset);
4327
}
4428

45-
/**
46-
* @param string $name ФИО строкой.
47-
* @return array
48-
*/
4929
public static function explodeName(string $name): array
5030
{
5131
$array = explode(' ', $name);

src/requesters/AddressRequester.php

-13
Original file line numberDiff line numberDiff line change
@@ -5,30 +5,17 @@
55
use GuzzleHttp\RequestOptions;
66
use c7v\dadata\BaseRequester;
77

8-
/**
9-
* @author Артём Соколовский <dev.sokolovsky@gmail.com>
10-
*/
118
class AddressRequester extends BaseRequester
129
{
13-
/** @var string Имя метода */
1410
const METHOD_URL = 'address';
1511

16-
/** @var array Данные для отправки */
1712
private array $_data;
1813

19-
/**
20-
* @param string $query Адрес.
21-
*/
2214
public function __construct(string $query)
2315
{
2416
$this->_data[] = $query;
2517
}
2618

27-
/**
28-
* Отправка запроса.
29-
* @return \Psr\Http\Message\ResponseInterface
30-
* @throws \GuzzleHttp\Exception\GuzzleException
31-
*/
3219
public function send(): \Psr\Http\Message\ResponseInterface
3320
{
3421
return self::$_httpClient->request('POST', self::METHOD_URL, array_merge(self::$_httpOptions, [

src/requesters/FindByAddressPostalUnitRequester.php

-13
Original file line numberDiff line numberDiff line change
@@ -5,30 +5,17 @@
55
use GuzzleHttp\RequestOptions;
66
use c7v\dadata\BaseRequester;
77

8-
/**
9-
* @author Артём Соколовский <dev.sokolovsky@gmail.com>
10-
*/
118
class FindByAddressPostalUnitRequester extends BaseRequester
129
{
13-
/** @var string Имя метода */
1410
const METHOD_URL = '4_1/rs/suggest/postal_unit';
1511

16-
/** @var array Данные для отправки */
1712
private array $_data;
1813

19-
/**
20-
* @param string $query Поиск работает по полям: postal_code и address_str.
21-
*/
2214
public function __construct(string $query)
2315
{
2416
$this->_data['query'] = $query;
2517
}
2618

27-
/**
28-
* Отправка запроса.
29-
* @return \Psr\Http\Message\ResponseInterface
30-
* @throws \GuzzleHttp\Exception\GuzzleException
31-
*/
3219
public function send(): \Psr\Http\Message\ResponseInterface
3320
{
3421
return self::$_httpClient->request('POST', self::METHOD_URL, array_merge(self::$_httpOptions, [

src/requesters/FindByIdBankRequester.php

-14
Original file line numberDiff line numberDiff line change
@@ -5,21 +5,12 @@
55
use GuzzleHttp\RequestOptions;
66
use c7v\dadata\BaseRequester;
77

8-
/**
9-
* @author Артём Соколовский <dev.sokolovsky@gmail.com>
10-
*/
118
class FindByIdBankRequester extends BaseRequester
129
{
13-
/** @var string Имя метода */
1410
const METHOD_URL = '4_1/rs/findById/bank';
1511

16-
/** @var array Данные для отправки */
1712
private array $_data;
1813

19-
/**
20-
* @param string $query БИК, SWIFT, ИНН и рег. номер банка
21-
* @param string|null $kpp Дополнительно можно указать КПП если параметр $query имеет значение ИНН.
22-
*/
2314
public function __construct(string $query, string $kpp = null)
2415
{
2516
$this->_data = [];
@@ -29,11 +20,6 @@ public function __construct(string $query, string $kpp = null)
2920
}
3021
}
3122

32-
/**
33-
* Отправка запроса.
34-
* @return \Psr\Http\Message\ResponseInterface
35-
* @throws \GuzzleHttp\Exception\GuzzleException
36-
*/
3723
public function send(): \Psr\Http\Message\ResponseInterface
3824
{
3925
return self::$_httpClient->request('POST', self::METHOD_URL, array_merge(self::$_httpOptions, [

src/requesters/FindByIdFnsUnitRequester.php

+1-14
Original file line numberDiff line numberDiff line change
@@ -5,30 +5,17 @@
55
use GuzzleHttp\RequestOptions;
66
use c7v\dadata\BaseRequester;
77

8-
/**
9-
* @author Артём Соколовский <dev.sokolovsky@gmail.com>
10-
*/
118
class FindByIdFnsUnitRequester extends BaseRequester
129
{
13-
/** @var string Имя метода */
1410
const METHOD_URL = '4_1/rs/suggest/fns_unit';
1511

16-
/** @var array Данные для отправки */
1712
private array $_data;
1813

19-
/**
20-
* @param string $query Поиск работает по полям: code, name_short и address.
21-
*/
22-
public function __construct(string $query)
14+
public function __construct(int $query)
2315
{
2416
$this->_data['query'] = $query;
2517
}
2618

27-
/**
28-
* Отправка запроса.
29-
* @return \Psr\Http\Message\ResponseInterface
30-
* @throws \GuzzleHttp\Exception\GuzzleException
31-
*/
3219
public function send(): \Psr\Http\Message\ResponseInterface
3320
{
3421
return self::$_httpClient->request('POST', self::METHOD_URL, array_merge(self::$_httpOptions, [

0 commit comments

Comments
 (0)