├── .travis.yml
├── .scrutinizer.yml
├── phpstan.neon
├── src
    ├── Exception.php
    ├── Model
    │   ├── EntityAbstract.php
    │   ├── District.php
    │   ├── City.php
    │   ├── Province.php
    │   ├── Commune.php
    │   └── Terc.php
    ├── Exception
    │   ├── NotFound.php
    │   ├── NotImplemented.php
    │   ├── Request.php
    │   ├── InvalidArgument.php
    │   ├── Response.php
    │   └── Connection.php
    ├── ResponseModel
    │   ├── Dictionary
    │   │   └── RodzajMiejscowosci.php
    │   └── Territory
    │   │   ├── JednostkaPodzialuTerytorialnego.php
    │   │   ├── UlicaDrzewo.php
    │   │   ├── Miejscowosc.php
    │   │   ├── ZweryfikowanyAdres.php
    │   │   ├── JednostkaTerytorialna.php
    │   │   ├── WyszukanaMiejscowosc.php
    │   │   ├── ZweryfikowanyAdresBezUlic.php
    │   │   ├── WyszukanaUlica.php
    │   │   ├── JednostkaNomenklaturyNTS.php
    │   │   ├── Ulica.php
    │   │   └── AbstractResponseModel.php
    ├── Api.php
    ├── TerytSoapClient.php
    ├── WSASoap.php
    ├── Helper.php
    ├── Config.php
    └── NativeApi.php
├── tests
    ├── bootstrap.php
    └── suits
    │   ├── TestCase.php
    │   ├── HelperTest.php
    │   ├── ClientTest.php
    │   ├── ConnectionTest.php
    │   ├── TercTest.php
    │   ├── ApiTest.php
    │   └── NativeApiTest.php
├── .codeclimate.yml
├── .github
    └── workflows
    │   └── php.yml
├── phpunit.xml
├── LICENSE
├── phpdoc.xml
├── .php-cs-fixer.php
├── CHANGELOG.md
├── composer.json
├── .gitignore
└── README.md


/.travis.yml:
--------------------------------------------------------------------------------
1 | language: php
2 | php:
3 |   - '7.2'
4 | before_script: composer install
5 | script: composer test
6 | 


--------------------------------------------------------------------------------
/.scrutinizer.yml:
--------------------------------------------------------------------------------
1 | build:
2 |     tests:
3 |         override:
4 |             -
5 |                 command: './vendor/bin/phpunit --coverage-clover=coverage.clover'
6 |                 coverage:
7 |                     file: 'coverage.clover'
8 |                     format: 'clover'
9 | 


--------------------------------------------------------------------------------
/phpstan.neon:
--------------------------------------------------------------------------------
 1 | parameters:
 2 | 	level: 3
 3 | 	paths:
 4 | 		- src
 5 | 		- tests
 6 | 	fileExtensions:
 7 | 		- php
 8 | 	bootstrapFiles:
 9 | 	    - ./vendor/autoload.php
10 | 	parallel:
11 | 		processTimeout: 300.0
12 | 		jobSize: 20
13 | 		maximumNumberOfProcesses: 32
14 | 		minimumNumberOfJobsPerProcess: 4
15 | includes:
16 | 	- vendor/phpstan/phpstan-phpunit/extension.neon
17 | 	- vendor/phpstan/phpstan-phpunit/rules.neon
18 | 	- vendor/jangregor/phpstan-prophecy/extension.neon
19 | 


--------------------------------------------------------------------------------
/src/Exception.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2019 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | namespace mrcnpdlk\Teryt;
15 | 
16 | /**
17 |  * Class Exception
18 |  */
19 | class Exception extends \Mrcnpdlk\Lib\Exception
20 | {
21 | }
22 | 


--------------------------------------------------------------------------------
/tests/bootstrap.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin.
16 |  * Date: 09.09.2017
17 |  * Time: 14:37
18 |  */
19 | require_once __DIR__ . '/../vendor/autoload.php';
20 | 


--------------------------------------------------------------------------------
/.codeclimate.yml:
--------------------------------------------------------------------------------
 1 | engines:
 2 |   phpmd:
 3 |     enabled: true
 4 |     checks:
 5 |       Design/TooManyPublicMethods:
 6 |         enabled: false
 7 |       Naming/ShortVariable:
 8 |         enabled: false
 9 |       CleanCode/StaticAccess:
10 |         enabled: false
11 |       Controversial/CamelCaseMethodName:
12 |         enabled: false
13 |   fixme:
14 |     enabled: true
15 |   duplication:
16 |     enabled: true
17 |     config:
18 |       languages:
19 |       - php:
20 | ratings:
21 |   paths:
22 |   - src/**
23 | 


--------------------------------------------------------------------------------
/src/Model/EntityAbstract.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin.
16 |  * Date: 11.09.2017
17 |  * Time: 23:34
18 |  */
19 | 
20 | namespace mrcnpdlk\Teryt\Model;
21 | 
22 | class EntityAbstract
23 | {
24 |     public function __construct()
25 |     {
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Exception/NotFound.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 05.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\Exception;
20 | 
21 | use mrcnpdlk\Teryt\Exception;
22 | 
23 | /**
24 |  * Class NotFound
25 |  */
26 | class NotFound extends Exception
27 | {
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Exception/NotImplemented.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin.
16 |  * Date: 06.09.2017
17 |  * Time: 22:27
18 |  */
19 | 
20 | namespace mrcnpdlk\Teryt\Exception;
21 | 
22 | use mrcnpdlk\Teryt\Exception;
23 | 
24 | /**
25 |  * Class NotImplemented
26 |  */
27 | class NotImplemented extends Exception
28 | {
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Exception/Request.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 05.09.2017
17 |  * Time: 12:50
18 |  */
19 | 
20 | namespace mrcnpdlk\Teryt\Exception;
21 | 
22 | use mrcnpdlk\Teryt\Exception;
23 | 
24 | /**
25 |  * Class Request
26 |  */
27 | class Request extends Exception
28 | {
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Exception/InvalidArgument.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 07.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\Exception;
20 | 
21 | use mrcnpdlk\Teryt\Exception;
22 | 
23 | /**
24 |  * Class InvalidArgument
25 |  */
26 | class InvalidArgument extends Exception
27 | {
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Exception/Response.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 05.09.2017
17 |  * Time: 12:49
18 |  */
19 | 
20 | namespace mrcnpdlk\Teryt\Exception;
21 | 
22 | use mrcnpdlk\Teryt\Exception;
23 | 
24 | /**
25 |  * Class Response
26 |  */
27 | class Response extends Exception
28 | {
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Exception/Connection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 05.09.2017
17 |  * Time: 12:47
18 |  */
19 | 
20 | namespace mrcnpdlk\Teryt\Exception;
21 | 
22 | use mrcnpdlk\Teryt\Exception;
23 | 
24 | /**
25 |  * Class Connection
26 |  */
27 | class Connection extends Exception
28 | {
29 | }
30 | 


--------------------------------------------------------------------------------
/.github/workflows/php.yml:
--------------------------------------------------------------------------------
 1 | name: PHP Composer
 2 | 
 3 | on: [push]
 4 | 
 5 | jobs:
 6 |   build:
 7 | 
 8 |     runs-on: ubuntu-latest
 9 | 
10 |     steps:
11 |       - uses: actions/checkout@v1
12 | 
13 |       - name: Validate composer.json and composer.lock
14 |         run: composer validate
15 | 
16 |       - name: Install dependencies
17 |         run: composer install --prefer-dist --no-progress --no-suggest
18 | 
19 |       # Add a test script to composer.json, for instance: "test": "vendor/bin/phpunit"
20 |       # Docs: https://getcomposer.org/doc/articles/scripts.md
21 | 
22 |       - name: Run lint check
23 |         run: composer lint
24 | 
25 |       - name: Run phpstan
26 |         run: composer phpstan
27 | 
28 |       - name: Run test suite
29 |         run: composer phpunit
30 | 


--------------------------------------------------------------------------------
/tests/suits/TestCase.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2019 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin.
16 |  * Date: 09.09.2017
17 |  * Time: 14:08
18 |  */
19 | 
20 | namespace Tests\mrcnpdlk\Teryt;
21 | 
22 | abstract class TestCase extends \PHPUnit\Framework\TestCase
23 | {
24 |     public function setUp(): void
25 |     {
26 |         parent::setUp(); // TODO: Change the autogenerated stub
27 |     }
28 | 
29 |     public function tearDown(): void
30 |     {
31 |         parent::tearDown(); // TODO: Change the autogenerated stub
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/tests/suits/HelperTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2019 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin.
16 |  * Date: 09.09.2017
17 |  * Time: 19:59
18 |  */
19 | 
20 | namespace Tests\mrcnpdlk\Teryt;
21 | 
22 | use mrcnpdlk\Teryt\Helper;
23 | 
24 | class HelperTest extends TestCase
25 | {
26 |     public function testConvertToBoolean(): void
27 |     {
28 |         $this->assertEquals(true, Helper::convertToBoolean('true'));
29 |         $this->assertEquals(true, Helper::convertToBoolean(1));
30 |         $this->assertEquals(true, Helper::convertToBoolean(true));
31 |         $this->assertEquals(false, Helper::convertToBoolean('false'));
32 |         $this->assertEquals(false, Helper::convertToBoolean(0));
33 |         $this->assertEquals(false, Helper::convertToBoolean(false));
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/phpunit.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <!--
 3 |   ~ TERYT-API
 4 |   ~
 5 |   ~ Copyright (c) 2017 pudelek.org.pl
 6 |   ~
 7 |   ~ For the full copyright and license information, please view source file
 8 |   ~ that is bundled with this package in the file LICENSE
 9 |   ~
10 |   ~ Author Marcin Pudełek <marcin@pudelek.org.pl>
11 |   ~
12 |   -->
13 | 
14 | <phpunit
15 |         backupGlobals="false"
16 |         backupStaticAttributes="false"
17 |         bootstrap="tests/bootstrap.php"
18 |         colors="true"
19 |         convertErrorsToExceptions="true"
20 |         convertNoticesToExceptions="true"
21 |         convertWarningsToExceptions="true"
22 |         processIsolation="false"
23 |         stopOnFailure="false"
24 | >
25 |     <testsuites>
26 |         <testsuite name="Application Test Suite">
27 |             <directory>./tests/</directory>
28 |         </testsuite>
29 |     </testsuites>
30 |     <filter>
31 |         <whitelist processUncoveredFilesFromWhitelist="true">
32 |             <directory suffix=".php">src</directory>
33 |         </whitelist>
34 |     </filter>
35 | </phpunit>
36 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2017 Marcin Pudełek
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/phpdoc.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8" ?>
 2 | <!--
 3 |   ~ TERYT-API
 4 |   ~
 5 |   ~ Copyright (c) 2017 pudelek.org.pl
 6 |   ~
 7 |   ~ For the full copyright and license information, please view source file
 8 |   ~ that is bundled with this package in the file LICENSE
 9 |   ~
10 |   ~ Author Marcin Pudełek <marcin@pudelek.org.pl>
11 |   ~
12 |   -->
13 | 
14 | <phpdoc>
15 |     <title>mrcnpdlk/teryt-api</title>
16 |     <parser>
17 |         <target>doc</target>
18 |         <encoding>utf8</encoding>
19 |         <markers>
20 |             <item>TODO</item>
21 |             <item>FIXME</item>
22 |         </markers>
23 |         <extensions>
24 |             <extension>php</extension>
25 |             <extension>php3</extension>
26 |             <extension>phtml</extension>
27 |         </extensions>
28 |         <visibility></visibility>
29 |     </parser>
30 |     <transformer>
31 |         <target>doc</target>
32 |     </transformer>
33 |     <transformations>
34 |         <template name="vendor/cvuorinen/phpdoc-markdown-public/data/templates/markdown-public" />
35 |     </transformations>
36 |     <files>
37 |         <directory>src/mrcnpdlk</directory>
38 |     </files>
39 | </phpdoc>
40 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Dictionary/RodzajMiejscowosci.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin.
16 |  * Date: 06.09.2017
17 |  * Time: 21:56
18 |  */
19 | 
20 | namespace mrcnpdlk\Teryt\ResponseModel\Dictionary;
21 | 
22 | /**
23 |  * Class RodzajMiejscowosci
24 |  */
25 | class RodzajMiejscowosci
26 | {
27 |     /**
28 |      * Identyfikator typu miejscowości
29 |      *
30 |      * @var string
31 |      */
32 |     public $id;
33 |     /**
34 |      * Nazwa typu
35 |      *
36 |      * @var string
37 |      */
38 |     public $name;
39 |     /**
40 |      * Opis
41 |      *
42 |      * @var string
43 |      */
44 |     public $desc;
45 | 
46 |     /**
47 |      * RodzajMiejscowosci constructor.
48 |      *
49 |      * @param \stdClass $oData Obiekt zwrócony z TerytWS1
50 |      */
51 |     public function __construct(\stdClass $oData)
52 |     {
53 |         $this->id   = $oData->Symbol;
54 |         $this->name = $oData->Nazwa;
55 |         $this->desc = $oData->Opis;
56 |     }
57 | }
58 | 


--------------------------------------------------------------------------------
/src/Api.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2019 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | namespace mrcnpdlk\Teryt;
15 | 
16 | use mrcnpdlk\Teryt\Model\City;
17 | 
18 | /**
19 |  * Class Api
20 |  */
21 | class Api
22 | {
23 |     /**
24 |      * @var NativeApi
25 |      */
26 |     private $oNativeApi;
27 | 
28 |     /**
29 |      * Api constructor.
30 |      *
31 |      * @param \mrcnpdlk\Teryt\Config $configuration
32 |      */
33 |     public function __construct(Config $configuration)
34 |     {
35 |         $this->oNativeApi = NativeApi::create($configuration);
36 |     }
37 | 
38 |     /**
39 |      * Get information about City
40 |      *
41 |      * @param string $id
42 |      *
43 |      * @throws \mrcnpdlk\Teryt\Exception
44 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
45 |      * @throws \mrcnpdlk\Teryt\Exception\InvalidArgument
46 |      * @throws \mrcnpdlk\Teryt\Exception\NotFound
47 |      *
48 |      * @return City
49 |      */
50 |     public function getCity(string $id): City
51 |     {
52 |         $oCity = new City();
53 | 
54 |         return $oCity->find($id);
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/tests/suits/ClientTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2019 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin.
16 |  * Date: 09.09.2017
17 |  * Time: 14:48
18 |  */
19 | 
20 | namespace Tests\mrcnpdlk\Teryt;
21 | 
22 | use mrcnpdlk\Teryt\Config;
23 | use mrcnpdlk\Teryt\NativeApi;
24 | use mrcnpdlk\Teryt\ResponseModel\Territory\JednostkaTerytorialna;
25 | use Psr\Log\NullLogger;
26 | 
27 | class ClientTest extends TestCase
28 | {
29 |     public function testEmptyLogger(): void
30 |     {
31 |         $oConfig = new Config();
32 |         $this->assertInstanceOf(NullLogger::class, $oConfig->getLogger());
33 |     }
34 | 
35 |     public function testEmptyCache(): void
36 |     {
37 |         $oConfig = new Config();
38 |         $this->assertInstanceOf(NullLogger::class, $oConfig->getLogger());
39 |     }
40 | 
41 |     public function testGetProvinces(): void
42 |     {
43 |         $oConfig    = new Config();
44 |         $oNativeApi = NativeApi::create($oConfig);
45 |         $tList      = $oNativeApi->PobierzListeWojewodztw();
46 |         $this->assertNotEmpty($tList);
47 |         $this->assertInstanceOf(JednostkaTerytorialna::class, $tList[0]);
48 |     }
49 | }
50 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/JednostkaPodzialuTerytorialnego.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 06.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
20 | 
21 | /**
22 |  * Class JednostkaPodzialuTerytorialnego
23 |  */
24 | class JednostkaPodzialuTerytorialnego extends AbstractResponseModel
25 | {
26 |     /**
27 |      * JednostkaPodzialuTerytorialnego constructor.
28 |      *
29 |      * @param \stdClass $oData Obiekt zwrócony z TerytWS1
30 |      *
31 |      * @throws \mrcnpdlk\Teryt\Exception
32 |      */
33 |     public function __construct(\stdClass $oData)
34 |     {
35 |         $this->communeName     = $oData->GmiNazwa;
36 |         $this->communeTypeName = $oData->GmiNazwaDodatkowa;
37 |         $this->communeTypeId   = $oData->GmiRodzaj;
38 |         $this->communeId       = $oData->GmiSymbol;
39 |         $this->districtId      = $oData->PowSymbol;
40 |         $this->districtName    = $oData->Powiat;
41 |         $this->provinceId      = $oData->WojSymbol;
42 |         $this->provinceName    = $oData->Wojewodztwo;
43 | 
44 |         parent::__construct();
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/tests/suits/ConnectionTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2019 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin.
16 |  * Date: 09.09.2017
17 |  * Time: 14:42
18 |  */
19 | 
20 | namespace Tests\mrcnpdlk\Teryt;
21 | 
22 | use mrcnpdlk\Teryt\Client;
23 | use mrcnpdlk\Teryt\Config;
24 | use mrcnpdlk\Teryt\Exception\Connection;
25 | use mrcnpdlk\Teryt\Exception\NotFound;
26 | use mrcnpdlk\Teryt\NativeApi;
27 | 
28 | class ConnectionTest extends TestCase
29 | {
30 |     public function testConnect(): void
31 |     {
32 |         $oConfig    = new Config();
33 |         $oNativeApi = NativeApi::create($oConfig);
34 |         $this->assertEquals(true, $oNativeApi->CzyZalogowany());
35 |     }
36 | 
37 |     /**
38 |      * @throws \Mrcnpdlk\Lib\ConfigurationException
39 |      * @throws \mrcnpdlk\Teryt\Exception
40 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
41 |      */
42 |     public function testInvalidAuth(): void
43 |     {
44 |         $this->expectException(Connection::class);
45 |         $oConfig = new Config([
46 |             'username'     => 'invaliduser',
47 |             'password'     => 'invalidpassword',
48 |             'isProduction' => false,
49 |         ]);
50 |         $oNativeApi = NativeApi::create($oConfig);
51 |         $oNativeApi->PobierzListeWojewodztw();
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/.php-cs-fixer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2019 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  *
12 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
13 |  *
14 |  */
15 | 
16 | use PhpCsFixer\Config;
17 | use PhpCsFixer\Finder;
18 | $rules = [
19 |     // default
20 |     '@PSR2'                      => true,
21 |     '@Symfony'                   => true,
22 |     // additionally
23 |     'array_syntax'               => ['syntax' => 'short'],
24 |     'concat_space'               => false,
25 |     'cast_spaces'                => false,
26 |     'no_unused_imports'          => false,
27 |     'no_useless_else'            => true,
28 |     'no_useless_return'          => true,
29 |     'no_superfluous_phpdoc_tags' => false,
30 |     'ordered_imports'            => true,
31 |     'phpdoc_align'               => true,
32 |     'phpdoc_order'               => true,
33 |     'phpdoc_trim'                => true,
34 |     'phpdoc_summary'             => false,
35 |     'simplified_null_return'     => false,
36 |     'ternary_to_null_coalescing' => true,
37 |     'binary_operator_spaces'     => ['default' => 'align'],
38 | ];
39 | $finder = (new Finder())
40 |     ->files()
41 |     ->name('*.php')
42 |     ->in(__DIR__ . '/src')
43 |     ->in(__DIR__ . '/tests')
44 | ;
45 | return (new Config('url-search-parser'))
46 |     ->setRiskyAllowed(true)
47 |     ->setRules($rules)
48 |     ->setFinder($finder)
49 |     ;
50 | 


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
 1 | # Changelog
 2 | All notable changes to this project will be documented in this file.
 3 | 
 4 | The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 5 | and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 6 | 
 7 | ## Unreleased
 8 | 
 9 | ## [1.1.0] - 2024-01-22
10 | ### Changed:
11 | - composer update
12 | ### Fixed:
13 | - [issue #6](https://github.com/mrcnpdlk/teryt-api/issues/6) - psr/log v3
14 | - 
15 | ## [1.0.1] - 2020-09-21
16 | ### Changed:
17 | - composer update
18 | ### Fixed:
19 | - [issue #3](https://github.com/mrcnpdlk/teryt-api/issues/3) - documentation fix
20 | 
21 | ## [1.0.0] - 2019-12-24
22 | ### Added:
23 | - github CI
24 | - lib-exception
25 | - config class
26 | ### Changed:
27 | - configuration API, see README
28 | ## [0.3.3] - 2017-10-16
29 | ## [0.3.2] - 2017-09-21
30 | ## [0.3.1] - 2017-09-15
31 | ## [0.3.0] - 2017-09-10
32 | ## [0.2.1] - 2017-09-10
33 | ## [0.2.0] - 2017-09-10
34 | ## [0.1.1] - 2017-09-08
35 | ## [0.1.0] - 2017-09-07 - First release
36 | 
37 | [Unreleased]: https://github.com/mrcnpdlk/teryt-api/compare/1.0.0...devel
38 | [1.0.0]: https://github.com/mrcnpdlk/teryt-api/compare/v0.3.3...v1.0.0
39 | [0.3.3]: https://github.com/mrcnpdlk/teryt-api/compare/v0.3.2...v0.3.3
40 | [0.3.2]: https://github.com/mrcnpdlk/teryt-api/compare/v0.3.1...v0.3.2
41 | [0.3.1]: https://github.com/mrcnpdlk/teryt-api/compare/v0.3.0...v0.3.1
42 | [0.3.0]: https://github.com/mrcnpdlk/teryt-api/compare/v0.2.1...v0.3.0
43 | [0.2.1]: https://github.com/mrcnpdlk/teryt-api/compare/v0.2.0...v0.2.1
44 | [0.2.0]: https://github.com/mrcnpdlk/teryt-api/compare/v0.1.1...v0.2.0
45 | [0.1.1]: https://github.com/mrcnpdlk/teryt-api/compare/v0.1.0...v0.1.1
46 | [0.1.0]: https://github.com/mrcnpdlk/teryt-api/releases/tag/v0.1.0
47 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "mrcnpdlk/teryt-api",
 3 |   "description": "Teryt WS1 Api",
 4 |   "keywords": [
 5 |     "teryt",
 6 |     "address",
 7 |     "soap"
 8 |   ],
 9 |   "type": "library",
10 |   "license": "MIT",
11 |   "authors": [
12 |     {
13 |       "name": "Marcin Pudełek",
14 |       "email": "marcin@pudelek.org.pl",
15 |       "role": "Developer"
16 |     }
17 |   ],
18 |   "minimum-stability": "stable",
19 |   "prefer-stable": true,
20 |   "require": {
21 |     "php": ">=7.2",
22 |     "ext-soap": "*",
23 |     "ext-dom": "*",
24 |     "mrcnpdlk/lib-exception": "^0",
25 |     "mrcnpdlk/lib-configuration": "^0",
26 |     "robrichards/wse-php": "^2",
27 |     "mrcnpdlk/psr16cache-adapter": "^0"
28 |   },
29 |   "require-dev": {
30 |     "phpunit/php-code-coverage": "^7",
31 |     "friendsofphp/php-cs-fixer": "^3",
32 |     "phpstan/phpstan": "^1",
33 |     "phpstan/phpstan-phpunit": "^1",
34 |     "jangregor/phpstan-prophecy": "^1",
35 |     "phpunit/phpunit": "^8",
36 |     "mockery/mockery": "^1",
37 |     "monolog/monolog": "^1.23",
38 |     "phpfastcache/phpfastcache": "^7"
39 |   },
40 |   "suggest": {
41 |     "monolog/monolog": "^1",
42 |     "phpfastcache/phpfastcache": "^7"
43 |   },
44 |   "autoload": {
45 |     "psr-4": {
46 |       "mrcnpdlk\\Teryt\\": "src/"
47 |     }
48 |   },
49 |   "autoload-dev": {
50 |     "psr-4": {
51 |       "Tests\\mrcnpdlk\\Teryt\\": "tests/suits/"
52 |     }
53 |   },
54 |   "scripts": {
55 |     "test": [
56 |       "@phpstan",
57 |       "@lint",
58 |       "@phpunit"
59 |     ],
60 |     "phpunit": "phpunit --configuration phpunit.xml --coverage-text --colors=never",
61 |     "phpstan": "phpstan analyse",
62 |     "fixer": "php-cs-fixer fix --diff --show-progress=dots",
63 |     "lint": "php-cs-fixer fix --diff --dry-run"
64 |   }
65 | }
66 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/UlicaDrzewo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 06.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
20 | 
21 | /**
22 |  * Class UlicaDrzewo
23 |  */
24 | class UlicaDrzewo extends Ulica
25 | {
26 |     /**
27 |      * 7 znakowy identyfikator miejscowości podstawowej
28 |      *
29 |      * @var string
30 |      */
31 |     public $cityParentId;
32 |     /**
33 |      * Zwiera nazwę ulicy w podziale na pola z uwzględnieniem słów kluczowych
34 |      *
35 |      * @var string
36 |      */
37 |     public $streetName1;
38 |     /**
39 |      * Zwiera nazwę ulicy w podziale na pola z uwzględnieniem słów kluczowych
40 |      *
41 |      * @var string
42 |      */
43 |     public $streetName2;
44 |     /**
45 |      * wyznacza miejsce podziału pełnej nazwy ulicy na nazwa1 i nazwa2
46 |      *
47 |      * @var int
48 |      */
49 |     public $indexKey;
50 | 
51 |     /**
52 |      * UlicaDrzewo constructor.
53 |      *
54 |      * @param \stdClass $oData Obiekt zwrócony z TerytWS1
55 |      *
56 |      * @throws \mrcnpdlk\Teryt\Exception
57 |      */
58 |     public function __construct(\stdClass $oData)
59 |     {
60 |         parent::__construct($oData);
61 | 
62 |         $this->cityParentId = $oData->IdentyfikatorMiejscowosciPodstawowej;
63 |         $this->streetName1  = $oData->Nazwa1;
64 |         $this->streetName2  = $oData->Nazwa2;
65 |         $this->indexKey     = $oData->IndeksKlucza;
66 |     }
67 | }
68 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/Miejscowosc.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 06.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
20 | 
21 | /**
22 |  * Class Miejscowosc
23 |  */
24 | class Miejscowosc extends AbstractResponseModel
25 | {
26 |     /**
27 |      * Nazwa miejscowości
28 |      *
29 |      * @var string
30 |      */
31 |     public $cityName;
32 |     /**
33 |      * 7 znakowy identyfikator miejscowości
34 |      *
35 |      * @var string
36 |      */
37 |     public $cityId;
38 | 
39 |     /**
40 |      * Miejscowosc constructor.
41 |      *
42 |      * @param \stdClass|null $oData Obiekt zwrócony z TerytWS1
43 |      *
44 |      * @todo Błąd w dokumentacji, zwracana niezgodna ilosc znaków dla PowSymbol i GmiSymbol. Narazie połatałem
45 |      *
46 |      * @throws \mrcnpdlk\Teryt\Exception
47 |      */
48 |     public function __construct(\stdClass $oData = null)
49 |     {
50 |         if ($oData) {
51 |             $this->cityName      = $oData->Nazwa;
52 |             $this->cityId        = $oData->Symbol;
53 |             $this->provinceId    = $oData->WojSymbol;
54 |             $this->provinceName  = $oData->Wojewodztwo;
55 |             $this->districtName  = $oData->Powiat;
56 |             $this->districtId    = 4 === strlen($oData->PowSymbol) ? substr($oData->PowSymbol, 2, 2) : $oData->PowSymbol;
57 |             $this->communeName   = $oData->Gmina;
58 |             $this->communeId     = 7 === strlen($oData->GmiSymbol) ? substr($oData->GmiSymbol, 4, 2) : $oData->GmiSymbol;
59 |             $this->communeTypeId = $oData->GmiRodzaj;
60 |         }
61 |         parent::__construct();
62 |     }
63 | }
64 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/ZweryfikowanyAdres.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 06.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
20 | 
21 | /**
22 |  * Class ZweryfikowanyAdres
23 |  */
24 | class ZweryfikowanyAdres extends ZweryfikowanyAdresBezUlic
25 | {
26 |     /**
27 |      * Nazwa ulicy w pełnym brzemieniu
28 |      *
29 |      * @var string
30 |      */
31 |     public $streetName;
32 |     /**
33 |      * Część nazwy ulicy począwszy od słowa, które
34 |      * decyduje o pozycji ulicy w układzie alfabetycznym, aż do końca nazwy
35 |      *
36 |      * @var string
37 |      */
38 |     public $streetName1;
39 |     /**
40 |      * Pozostała część nazwy ulicy
41 |      *
42 |      * @var string
43 |      */
44 |     public $streetName2;
45 |     /**
46 |      * Identyfikator ulicy
47 |      *
48 |      * @var string
49 |      */
50 |     public $streetId;
51 |     /**
52 |      * Nazwa cechy ulicy
53 |      *
54 |      * @var static
55 |      */
56 |     public $streetIdentityName;
57 | 
58 |     /**
59 |      * ZweryfikowanyAdres constructor.
60 |      *
61 |      * @param \stdClass $oData Obiekt zwrócony z TerytWS1
62 |      *
63 |      * @throws \mrcnpdlk\Teryt\Exception
64 |      */
65 |     public function __construct(\stdClass $oData)
66 |     {
67 |         parent::__construct($oData);
68 |         $this->streetId           = $oData->SymUl;
69 |         $this->streetName1        = $oData->Nazwa_1;
70 |         $this->streetName2        = $oData->Nazwa_2;
71 |         $this->streetName         = $oData->NazwaUlicyWPelnymBrzmieniu;
72 |         $this->streetIdentityName = $oData->NazwaCechy;
73 |     }
74 | }
75 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | /doc/
 2 | /devel/
 3 | coverage.clover
 4 | .idea
 5 | .php_cs.cache
 6 | .phpunit.result.cache
 7 | .php-cs-fixer.cache
 8 | # Created by .ignore support plugin (hsz.mobi)
 9 | ### Windows template
10 | # Windows thumbnail cache files
11 | Thumbs.db
12 | ehthumbs.db
13 | ehthumbs_vista.db
14 | 
15 | # Dump file
16 | *.stackdump
17 | 
18 | # Folder config file
19 | Desktop.ini
20 | 
21 | # Recycle Bin used on file shares
22 | $RECYCLE.BIN/
23 | 
24 | # Windows Installer files
25 | *.cab
26 | *.msi
27 | *.msm
28 | *.msp
29 | 
30 | # Windows shortcuts
31 | *.lnk
32 | ### JetBrains template
33 | # Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and Webstorm
34 | # Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
35 | 
36 | # User-specific stuff:
37 | .idea/**/workspace.xml
38 | .idea/**/tasks.xml
39 | .idea/dictionaries
40 | 
41 | # Sensitive or high-churn files:
42 | .idea/**/dataSources/
43 | .idea/**/dataSources.ids
44 | .idea/**/dataSources.xml
45 | .idea/**/dataSources.local.xml
46 | .idea/**/sqlDataSources.xml
47 | .idea/**/dynamic.xml
48 | .idea/**/uiDesigner.xml
49 | 
50 | # Gradle:
51 | .idea/**/gradle.xml
52 | .idea/**/libraries
53 | 
54 | # CMake
55 | cmake-build-debug/
56 | 
57 | # Mongo Explorer plugin:
58 | .idea/**/mongoSettings.xml
59 | 
60 | ## File-based project format:
61 | *.iws
62 | 
63 | ## Plugin-specific files:
64 | 
65 | # IntelliJ
66 | out/
67 | 
68 | # mpeltonen/sbt-idea plugin
69 | .idea_modules/
70 | 
71 | # JIRA plugin
72 | atlassian-ide-plugin.xml
73 | 
74 | # Cursive Clojure plugin
75 | .idea/replstate.xml
76 | 
77 | # Crashlytics plugin (for Android Studio and IntelliJ)
78 | com_crashlytics_export_strings.xml
79 | crashlytics.properties
80 | crashlytics-build.properties
81 | fabric.properties
82 | ### Composer template
83 | composer.phar
84 | /vendor/
85 | 
86 | # Commit your application's lock file http://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file
87 | # You may choose to ignore a library lock file http://getcomposer.org/doc/02-libraries.md#lock-file
88 | # composer.lock
89 | 
90 | 


--------------------------------------------------------------------------------
/src/TerytSoapClient.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | namespace mrcnpdlk\Teryt;
15 | 
16 | use RobRichards\WsePhp\WSSESoap;
17 | 
18 | class TerytSoapClient extends \SoapClient
19 | {
20 |     /**
21 |      * @var string
22 |      */
23 |     private $username;
24 |     /**
25 |      * @var string
26 |      */
27 |     private $password;
28 |     /**
29 |      * @var bool
30 |      */
31 |     private $digest;
32 | 
33 |     /**
34 |      * @param string $username
35 |      * @param string $password
36 |      * @param bool   $digest
37 |      */
38 |     public function addUserToken(string $username, string $password, bool $digest = false): void
39 |     {
40 |         $this->username = $username;
41 |         $this->password = $password;
42 |         $this->digest   = $digest;
43 |     }
44 | 
45 |     /** @noinspection MagicMethodsValidityInspection */
46 |     #[\ReturnTypeWillChange]
47 |     /**
48 |      * @param string $request
49 |      * @param string $location
50 |      * @param string $action
51 |      * @param int    $version
52 |      * @param int    $oneWay
53 |      *
54 |      * @throws \Exception
55 |      *
56 |      * @return string|null
57 |      */
58 |     public function __doRequest($request, $location, $action, $version, $oneWay = 0)
59 |     {
60 |         $doc = new \DOMDocument('1.0');
61 |         $doc->loadXML($request);
62 |         $wsa = new WSASoap($doc);
63 |         $wsa->addAction($action);
64 |         $doc                  = $wsa->getDoc();
65 |         $wsse                 = new WSSESoap($doc, false);
66 |         $wsse->signAllHeaders = false;
67 |         $wsse->addUserToken($this->username, $this->password, $this->digest);
68 |         $request = $wsse->saveXML();
69 | 
70 |         return parent::__doRequest($request, $location, $action, $version, $oneWay);
71 |     }
72 | }
73 | 


--------------------------------------------------------------------------------
/tests/suits/TercTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2019 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin.
16 |  * Date: 09.09.2017
17 |  * Time: 20:12
18 |  */
19 | 
20 | namespace Tests\mrcnpdlk\Teryt;
21 | 
22 | use mrcnpdlk\Teryt\Model\Terc;
23 | 
24 | class TercTest extends TestCase
25 | {
26 |     public function testTerc(): void
27 |     {
28 |         $oTerc = new Terc(1234567);
29 |         $this->assertEquals('12', $oTerc->getProvinceId());
30 |         $this->assertEquals('34', $oTerc->getDistrictId());
31 |         $this->assertEquals('56', $oTerc->getCommuneId());
32 |         $this->assertEquals('7', $oTerc->getCommuneTypeId());
33 |         $this->assertEquals(1234567, $oTerc->getTercId());
34 | 
35 |         $oTerc = new Terc(123456);
36 |         $this->assertEquals('01', $oTerc->getProvinceId());
37 |         $this->assertEquals('23', $oTerc->getDistrictId());
38 |         $this->assertEquals('45', $oTerc->getCommuneId());
39 |         $this->assertEquals('6', $oTerc->getCommuneTypeId());
40 |         $this->assertEquals(123456, $oTerc->getTercId());
41 | 
42 |         $oTerc = new Terc(null);
43 |         $this->assertEquals(null, $oTerc->getProvinceId());
44 |         $this->assertEquals(null, $oTerc->getDistrictId());
45 |         $this->assertEquals(null, $oTerc->getCommuneId());
46 |         $this->assertEquals(null, $oTerc->getCommuneTypeId());
47 |         $this->assertEquals(null, $oTerc->getTercId());
48 | 
49 |         $oTerc = new Terc();
50 |         $oTerc->setIds('1', '2', '3', '4');
51 |         $this->assertEquals('01', $oTerc->getProvinceId());
52 |         $this->assertEquals('02', $oTerc->getDistrictId());
53 |         $this->assertEquals('03', $oTerc->getCommuneId());
54 |         $this->assertEquals('4', $oTerc->getCommuneTypeId());
55 |         $this->assertEquals(102034, $oTerc->getTercId());
56 |     }
57 | }
58 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/JednostkaTerytorialna.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 06.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
20 | 
21 | /**
22 |  * Class JednostkaTerytorialna
23 |  */
24 | class JednostkaTerytorialna extends AbstractResponseModel
25 | {
26 |     /**
27 |      * Nazwa jednostki
28 |      *
29 |      * @var string
30 |      */
31 |     public $name;
32 |     /**
33 |      * Typ jednostki podziału terytorialnego
34 |      *
35 |      * @var string
36 |      */
37 |     public $typeName;
38 | 
39 |     /**
40 |      * JednostkaTerytorialna constructor.
41 |      *
42 |      * @param \stdClass $oData Obiekt zwrócony z TerytWS1
43 |      *
44 |      * @throws \mrcnpdlk\Teryt\Exception
45 |      */
46 |     public function __construct(\stdClass $oData)
47 |     {
48 |         $this->provinceId    = $oData->WOJ;
49 |         $this->districtId    = $oData->POW;
50 |         $this->communeId     = $oData->GMI;
51 |         $this->communeTypeId = $oData->RODZ;
52 |         $this->name          = $oData->NAZWA;
53 |         $this->typeName      = $oData->NAZWA_DOD;
54 |         $this->statusDate    = $oData->STAN_NA;
55 | 
56 |         try {
57 |             $this->statusDate = $oData->STAN_NA ? (new \DateTime($oData->STAN_NA))->format('Y-m-d') : null;
58 |         } catch (\Exception $e) {
59 |             $this->statusDate = null;
60 |         }
61 | 
62 |         if ($this->provinceId && $this->districtId && $this->communeId && $this->communeTypeId) {
63 |             $this->tercId = (int)sprintf('%s%s%s%s',
64 |                 $this->provinceId,
65 |                 $this->districtId,
66 |                 $this->communeId,
67 |                 $this->communeTypeId);
68 |         }
69 | 
70 |         parent::__construct();
71 |     }
72 | }
73 | 


--------------------------------------------------------------------------------
/tests/suits/ApiTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2019 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin.
16 |  * Date: 09.09.2017
17 |  * Time: 20:12
18 |  */
19 | 
20 | namespace Tests\mrcnpdlk\Teryt;
21 | 
22 | use mrcnpdlk\Teryt\Api;
23 | use mrcnpdlk\Teryt\Client;
24 | use mrcnpdlk\Teryt\Config;
25 | use mrcnpdlk\Teryt\Exception\NotFound;
26 | use mrcnpdlk\Teryt\Model\City;
27 | use mrcnpdlk\Teryt\Model\Commune;
28 | use mrcnpdlk\Teryt\Model\District;
29 | use mrcnpdlk\Teryt\Model\Province;
30 | 
31 | class ApiTest extends TestCase
32 | {
33 |     /**
34 |      * @var \mrcnpdlk\Teryt\Api
35 |      */
36 |     private $oApi;
37 | 
38 |     public function setUp(): void
39 |     {
40 |         parent::setUp(); // TODO: Change the autogenerated stub
41 |         $oConfig    = new Config();
42 |         $this->oApi = new Api($oConfig);
43 |     }
44 | 
45 |     public function testGetCity(): void
46 |     {
47 |         $oResp      = $this->oApi->getCity('0700884');
48 | 
49 |         $this->assertInstanceOf(City::class, $oResp);
50 |         $this->assertEquals(true, isset($oResp->commune));
51 |         $this->assertInstanceOf(Commune::class, $oResp->commune);
52 |         $this->assertEquals(true, isset($oResp->commune->district));
53 |         $this->assertInstanceOf(District::class, $oResp->commune->district);
54 |         $this->assertEquals(true, isset($oResp->commune->district->province));
55 |         $this->assertInstanceOf(Province::class, $oResp->commune->district->province);
56 |     }
57 | 
58 |     /**
59 |      * @throws \mrcnpdlk\Teryt\Exception
60 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
61 |      * @throws \mrcnpdlk\Teryt\Exception\InvalidArgument
62 |      * @throws \mrcnpdlk\Teryt\Exception\NotFound
63 |      */
64 |     public function testGetCityNotFound(): void
65 |     {
66 |         $this->expectException(NotFound::class);
67 |         $oResp      = $this->oApi->getCity('0700884000000');
68 |     }
69 | }
70 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/WyszukanaMiejscowosc.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 06.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
20 | 
21 | /**
22 |  * Class WyszukanaMiejscowosc
23 |  */
24 | class WyszukanaMiejscowosc extends Miejscowosc
25 | {
26 |     /**
27 |      * Identyfikator miejscowości podstawowej
28 |      *
29 |      * @var string
30 |      */
31 |     public $cityParentId;
32 |     /**
33 |      * Symbol rodzaju miejscowości
34 |      *
35 |      * @var string
36 |      */
37 |     public $rmId;
38 |     /**
39 |      * Nazwa rodzaju miejscowości
40 |      *
41 |      * @var string
42 |      */
43 |     public $rmName;
44 | 
45 |     /**
46 |      * WyszukanaMiejscowosc constructor.
47 |      *
48 |      * @param \stdClass $oData Obiekt zwrócony z TerytWS1
49 |      *
50 |      * @throws \mrcnpdlk\Teryt\Exception
51 |      */
52 |     public function __construct(\stdClass $oData)
53 |     {
54 |         $this->communeId     = $oData->Gmi;
55 |         $this->communeName   = $oData->Gmina;
56 |         $this->cityName      = $oData->Nazwa;
57 |         $this->districtId    = $oData->Pow;
58 |         $this->districtName  = $oData->Powiat;
59 |         $this->rmId          = $oData->Rm;
60 |         $this->rmName        = $oData->RodzajMiejscowosci;
61 |         $this->communeTypeId = $oData->RodzajGminy;
62 |         $this->cityId        = $oData->Symbol;
63 |         $this->cityParentId  = $oData->SymbolPodst;
64 |         $this->provinceId    = $oData->Woj;
65 |         $this->provinceName  = $oData->Wojewodztwo;
66 | 
67 |         try {
68 |             $this->statusDate = $oData->DataStanu ? (new \DateTime($oData->DataStanu))->format('Y-m-d') : null;
69 |         } catch (\Exception $e) {
70 |             $this->statusDate = null;
71 |         }
72 | 
73 |         parent::__construct();
74 |     }
75 | }
76 | 


--------------------------------------------------------------------------------
/src/Model/District.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 07.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\Model;
20 | 
21 | use mrcnpdlk\Teryt\Exception\NotFound;
22 | use mrcnpdlk\Teryt\NativeApi;
23 | 
24 | /**
25 |  * Class District
26 |  */
27 | class District extends EntityAbstract
28 | {
29 |     /**
30 |      * 4 znakowy symbol powiatu
31 |      * sklada sie z 2 cyfr województwa i 2 powiatu
32 |      *
33 |      * @var string
34 |      */
35 |     public $id;
36 |     /**
37 |      * Nazwa powiatu
38 |      *
39 |      * @var string
40 |      */
41 |     public $name;
42 |     /**
43 |      * Nazwa typu powiatu
44 |      *
45 |      * @var string
46 |      */
47 |     public $typeName;
48 |     /**
49 |      * Obiekt z informacjami o wojewodztwie
50 |      *
51 |      * @var \mrcnpdlk\Teryt\Model\Province
52 |      */
53 |     public $province;
54 | 
55 |     /**
56 |      * District constructor.
57 |      *
58 |      * @param string $id 4-znakowy symbol powiatu
59 |      *
60 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
61 |      * @throws \mrcnpdlk\Teryt\Exception
62 |      * @throws NotFound
63 |      *
64 |      * @return $this
65 |      */
66 |     public function find(string $id)
67 |     {
68 |         $provinceId = substr($id, 0, 2);
69 |         $districtId = substr($id, 2, 2);
70 |         foreach (NativeApi::getInstance()->PobierzListePowiatow($provinceId) as $i) {
71 |             if ($i->districtId === $districtId) {
72 |                 $this->id       = $id;
73 |                 $this->name     = $i->name;
74 |                 $this->typeName = $i->typeName;
75 |             }
76 |         }
77 |         if (!$this->id) {
78 |             throw new NotFound(sprintf('District [id:%s] not exists', $id));
79 |         }
80 |         $this->province = (new Province())->find($provinceId);
81 | 
82 |         return $this;
83 |     }
84 | }
85 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/ZweryfikowanyAdresBezUlic.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 06.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
20 | 
21 | /**
22 |  * Class ZweryfikowanyAdresBezUlic
23 |  */
24 | class ZweryfikowanyAdresBezUlic extends AbstractResponseModel
25 | {
26 |     /**
27 |      * Nazwa miejscowości
28 |      *
29 |      * @var string
30 |      */
31 |     public $cityName;
32 |     /**
33 |      * Nazwa rodzaju miejscowości
34 |      *
35 |      * @var string
36 |      */
37 |     public $cityTypeName;
38 |     /**
39 |      * Poprzedni rodzaj miejscowości
40 |      *
41 |      * @var string
42 |      */
43 |     public $historicalCityType;
44 |     /**
45 |      * 7 znakowy identyfikator miejscowości
46 |      *
47 |      * @var string
48 |      */
49 |     public $cityId;
50 | 
51 |     /**
52 |      * ZweryfikowanyAdresBezUlic constructor.
53 |      *
54 |      * @param \stdClass $oData Obiekt zwrócony z TerytWS1
55 |      *
56 |      * @throws \mrcnpdlk\Teryt\Exception
57 |      */
58 |     public function __construct(\stdClass $oData)
59 |     {
60 |         $this->historicalCityType = $oData->HistorycznyRodzajMiejscowosci;
61 |         $this->communeName        = $oData->NazwaGmi;
62 |         $this->cityName           = $oData->NazwaMiejscowosci;
63 |         $this->districtName       = $oData->NazwaPow;
64 |         $this->provinceName       = $oData->NazwaWoj;
65 |         $this->communeTypeName    = $oData->RodzajGmi;
66 |         $this->cityTypeName       = $oData->RodzajMiejscowosci;
67 |         $this->communeId          = $oData->SymbolGmi;
68 |         $this->cityId             = $oData->SymbolMiejscowosci;
69 |         $this->districtId         = $oData->SymbolPow;
70 |         $this->communeTypeId      = $oData->SymbolRodzajuGmi;
71 |         $this->provinceId         = $oData->SymbolWoj;
72 | 
73 |         parent::__construct();
74 |     }
75 | }
76 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/WyszukanaUlica.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 06.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
20 | 
21 | use stdClass;
22 | use Throwable;
23 | 
24 | /**
25 |  * Class WyszukanaUlica
26 |  */
27 | class WyszukanaUlica extends Ulica
28 | {
29 |     /**
30 |      * Nazwa uliczy cz. 1
31 |      *
32 |      * @var string
33 |      */
34 |     public $streetName1;
35 |     /**
36 |      * Nazwa ulicy cz. 2
37 |      *
38 |      * @var string
39 |      */
40 |     public $streetName2;
41 | 
42 |     /**
43 |      * WyszukanaUlica constructor.
44 |      *
45 |      * @param \stdClass|null $oData Obiekt zwrócony z TerytWS1
46 |      *
47 |      * @throws \mrcnpdlk\Teryt\Exception
48 |      */
49 |     public function __construct(stdClass $oData = null)
50 |     {
51 |         if ($oData) {
52 |             $this->streetIdentity = $oData->Cecha;
53 |             $this->communeId      = $oData->Gmi;
54 |             $this->communeName    = $oData->Gmina;
55 |             $this->cityName       = $oData->Miejscowosc;
56 |             $this->streetName     = $oData->Nazwa;
57 |             $this->streetName1    = $oData->Nazwa1;
58 |             $this->streetName2    = $oData->Nazwa2;
59 |             $this->districtId     = $oData->Pow;
60 |             $this->districtName   = $oData->Powiat;
61 |             $this->communeTypeId  = $oData->RodzajGminy;
62 |             $this->streetId       = $oData->Symbol;
63 |             $this->cityId         = $oData->SymbolSimc;
64 |             $this->provinceId     = $oData->Woj;
65 |             $this->provinceName   = $oData->Wojewodztwo;
66 | 
67 |             try {
68 |                 $this->statusDate = $oData->DataStanu ? (new \DateTime($oData->DataStanu))->format('Y-m-d') : null;
69 |             } catch (Throwable $e) {
70 |                 $this->statusDate = null;
71 |             }
72 |         }
73 | 
74 |         parent::__construct();
75 |     }
76 | }
77 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/JednostkaNomenklaturyNTS.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 06.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
20 | 
21 | /**
22 |  * Class JednostkaNomenklaturyNTS
23 |  */
24 | class JednostkaNomenklaturyNTS extends AbstractResponseModel
25 | {
26 |     /**
27 |      * Jednoznakowy symbol poziomu
28 |      *
29 |      * @var string
30 |      */
31 |     public $level;
32 |     /**
33 |      * Jednoznakowy symbol regionu
34 |      *
35 |      * @var string
36 |      */
37 |     public $regionId;
38 |     /**
39 |      * Dwuznakowy symbol podregionu
40 |      *
41 |      * @var string
42 |      */
43 |     public $subregionId;
44 |     /**
45 |      * Nazwa jednostki
46 |      *
47 |      * @var string
48 |      */
49 |     public $name;
50 |     /**
51 |      * Typ jednostki podziału terytorialnego
52 |      *
53 |      * @var string
54 |      */
55 |     public $typeName;
56 | 
57 |     /**
58 |      * JednostkaNomenklaturyNTS constructor.
59 |      *
60 |      * @param \stdClass|null $oData
61 |      *
62 |      * @throws \mrcnpdlk\Teryt\Exception
63 |      */
64 |     public function __construct(\stdClass $oData = null)
65 |     {
66 |         if (null !== $oData) {
67 |             parent::__construct();
68 |             $this->communeId     = $oData->GMI;
69 |             $this->name          = $oData->NAZWA;
70 |             $this->typeName      = $oData->NAZWA_DOD;
71 |             $this->subregionId   = $oData->PODREG;
72 |             $this->districtId    = $oData->POW;
73 |             $this->level         = $oData->POZIOM;
74 |             $this->regionId      = $oData->REGION;
75 |             $this->communeTypeId = $oData->RODZ;
76 |             $this->provinceId    = $oData->WOJ;
77 | 
78 |             try {
79 |                 $this->statusDate = $oData->STAN_NA ? (new \DateTime($oData->STAN_NA))->format('Y-m-d') : null;
80 |             } catch (\Exception $e) {
81 |                 $this->statusDate = null;
82 |             }
83 | 
84 |             $this->expandData();
85 |         }
86 |     }
87 | }
88 | 


--------------------------------------------------------------------------------
/src/Model/City.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 07.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\Model;
20 | 
21 | use mrcnpdlk\Teryt\Exception\NotFound;
22 | use mrcnpdlk\Teryt\NativeApi;
23 | 
24 | /**
25 |  * Class City
26 |  */
27 | class City extends EntityAbstract
28 | {
29 |     /**
30 |      * 7 znakowy identyfikator miejscowości
31 |      *
32 |      * @var string
33 |      */
34 |     public $id;
35 |     /**
36 |      * 7 znakowy identyfikator miejscowości nadrzędnej
37 |      *
38 |      * @var string
39 |      */
40 |     public $parentId;
41 |     /**
42 |      * Symbol rodzaju miejscowości
43 |      *
44 |      * @var string
45 |      */
46 |     public $rmId;
47 |     /**
48 |      * Nazwa rodzaju miejscowości
49 |      *
50 |      * @var string
51 |      */
52 |     public $rmName;
53 |     /**
54 |      * Nazwa miejscowości
55 |      *
56 |      * @var string
57 |      */
58 |     public $name;
59 |     /**
60 |      * Obiekt z danymi o gminie w której znajduje się miasto/miejscowość
61 |      *
62 |      * @var \mrcnpdlk\Teryt\Model\Commune
63 |      */
64 |     public $commune;
65 | 
66 |     /**
67 |      * @param string $id
68 |      *
69 |      * @throws \mrcnpdlk\Teryt\Exception
70 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
71 |      * @throws \mrcnpdlk\Teryt\Exception\InvalidArgument
72 |      * @throws \mrcnpdlk\Teryt\Exception\NotFound
73 |      *
74 |      * @return \mrcnpdlk\Teryt\Model\City
75 |      */
76 |     public function find(string $id): City
77 |     {
78 |         $res = NativeApi::getInstance()->WyszukajMiejscowoscWRejestrze(null, $id);
79 |         if (!empty($res) && 1 === count($res)) {
80 |             $oCity          = $res[0];
81 |             $this->id       = $id;
82 |             $this->parentId = $oCity->cityParentId;
83 |             $this->name     = $oCity->cityName;
84 |             $this->rmId     = $oCity->rmId;
85 |             $this->rmName   = $oCity->rmName;
86 |             $this->commune  = (new Commune())->find((string)($oCity->tercId));
87 |         }
88 | 
89 |         if (!$this->id) {
90 |             throw new NotFound(sprintf('City [id:%s] not exists', $id));
91 |         }
92 | 
93 |         return $this;
94 |     }
95 | }
96 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/Ulica.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * TERYT-API
 4 |  *
 5 |  * Copyright (c) 2017 pudelek.org.pl
 6 |  *
 7 |  * @license MIT License (MIT)
 8 |  *
 9 |  * For the full copyright and license information, please view source file
10 |  * that is bundled with this package in the file LICENSE
11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
12 |  */
13 | 
14 | /**
15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
16 |  * Date: 06.09.2017
17 |  */
18 | 
19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
20 | 
21 | /**
22 |  * Class Ulica
23 |  */
24 | class Ulica extends AbstractResponseModel
25 | {
26 |     /**
27 |      * Zawiera cechę ulicy
28 |      *
29 |      * @var string
30 |      */
31 |     public $streetIdentity;
32 |     /**
33 |      * Nazwa ulicy
34 |      *
35 |      * @var string
36 |      */
37 |     public $streetName;
38 |     /**
39 |      * Identyfikator ulicy
40 |      *
41 |      * @var string
42 |      */
43 |     public $streetId;
44 |     /**
45 |      * 7 znakowy identyfikator miejscowości
46 |      *
47 |      * @var string
48 |      */
49 |     public $cityId;
50 |     /**
51 |      * Nazwa ulicy
52 |      *
53 |      * @var string
54 |      */
55 |     public $cityName;
56 | 
57 |     /**
58 |      * Ulica constructor.
59 |      *
60 |      * @param \stdClass|null $oData Obiekt zwrócony z TerytWS1
61 |      *
62 |      * @throws \mrcnpdlk\Teryt\Exception
63 |      */
64 |     public function __construct(\stdClass $oData = null)
65 |     {
66 |         if ($oData) {
67 |             $this->streetIdentity = $oData->Cecha;
68 |             $this->communeTypeId  = $oData->GmiRodzaj ?? $oData->RodzGmi ?? null;
69 |             $this->communeId      = $oData->GmiSymbol ?? $oData->Gmi ?? null;
70 |             $this->communeName    = $oData->Gmina     ?? null;
71 |             $this->cityId         = $oData->IdentyfikatorMiejscowosci;
72 |             $this->streetId       = $oData->IdentyfikatorUlicy ?? $oData->SymbolUlicy ?? null;
73 |             $this->streetName     = $oData->Nazwa              ?? null;
74 |             $this->cityName       = $oData->NazwaMiejscowosci  ?? null;
75 |             $this->districtId     = $oData->PowSymbol          ?? $oData->Pow          ?? null;
76 |             $this->districtName   = $oData->Powiat             ?? null;
77 |             $this->provinceId     = $oData->WojSymbol          ?? $oData->Woj          ?? null;
78 |             $this->provinceName   = $oData->Wojewodztwo        ?? null;
79 | 
80 |             $dataStanu = $oData->DataStanu ?? $oData->StanNa ?? null;
81 |             try {
82 |                 $this->statusDate = $dataStanu ? (new \DateTime($dataStanu))->format('Y-m-d') : null;
83 |             } catch (\Exception $e) {
84 |                 $this->statusDate = null;
85 |             }
86 |         }
87 | 
88 |         parent::__construct();
89 |     }
90 | }
91 | 


--------------------------------------------------------------------------------
/src/WSASoap.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * TERYT-API
  4 |  *
  5 |  * Copyright (c) 2017 pudelek.org.pl
  6 |  *
  7 |  * @license MIT License (MIT)
  8 |  *
  9 |  * For the full copyright and license information, please view source file
 10 |  * that is bundled with this package in the file LICENSE
 11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
 12 |  */
 13 | 
 14 | namespace mrcnpdlk\Teryt;
 15 | 
 16 | use DOMDocument;
 17 | use DOMXPath;
 18 | 
 19 | /**
 20 |  * @see https://github.com/robrichards/wse-php/issues/31
 21 |  */
 22 | class WSASoap
 23 | {
 24 |     public const WSANS  = 'http://www.w3.org/2005/08/addressing';
 25 |     public const WSAPFX = 'wsa';
 26 |     /**
 27 |      * @var string|null
 28 |      */
 29 |     private $soapNS;
 30 |     /**
 31 |      * @var string|null
 32 |      */
 33 |     private $soapPFX;
 34 |     /**
 35 |      * @var \DOMDocument|null
 36 |      */
 37 |     private $soapDoc   = null;
 38 |     /**
 39 |      * @var \DOMElement|null
 40 |      */
 41 |     private $envelope  = null;
 42 |     /**
 43 |      * @var \DOMXPath|null
 44 |      */
 45 |     private $SOAPXPath = null;
 46 |     /**
 47 |      * @var \DOMElement|\DOMNode|null
 48 |      */
 49 |     private $header    = null;
 50 | 
 51 |     public function __construct(DOMDocument $doc)
 52 |     {
 53 |         $this->soapDoc   = $doc;
 54 |         $this->envelope  = $doc->documentElement;
 55 |         $this->soapNS    = $this->envelope->namespaceURI;
 56 |         $this->soapPFX   = $this->envelope->prefix;
 57 |         $this->SOAPXPath = new DOMXPath($doc);
 58 |         $this->SOAPXPath->registerNamespace('wssoap', $this->soapNS);
 59 |         $this->SOAPXPath->registerNamespace('wswsa', static::WSANS);
 60 |         $this->envelope->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:' . self::WSAPFX, static::WSANS);
 61 |         $this->locateHeader();
 62 |     }
 63 | 
 64 |     /**
 65 |      * @param string $action
 66 |      */
 67 |     public function addAction($action): void
 68 |     {
 69 |         /* Add the WSA Action */
 70 |         $header     = $this->locateHeader();
 71 |         $nodeAction = $this->soapDoc->createElementNS(static::WSANS, self::WSAPFX . ':Action', $action);
 72 |         $header->appendChild($nodeAction);
 73 |     }
 74 | 
 75 |     /**
 76 |      * @return \DOMDocument
 77 |      */
 78 |     public function getDoc(): DOMDocument
 79 |     {
 80 |         return $this->soapDoc;
 81 |     }
 82 | 
 83 |     /**
 84 |      * @return \DOMElement|\DOMNode
 85 |      */
 86 |     private function locateHeader()
 87 |     {
 88 |         if (null === $this->header) {
 89 |             $headers = $this->SOAPXPath->query('//wssoap:Envelope/wssoap:Header');
 90 |             $header  = $headers->item(0);
 91 |             if (!$header) {
 92 |                 $header = $this->soapDoc->createElementNS($this->soapNS, $this->soapPFX . ':Header');
 93 |                 $this->envelope->insertBefore($header, $this->envelope->firstChild);
 94 |             }
 95 |             $this->header = $header;
 96 |         }
 97 | 
 98 |         return $this->header;
 99 |     }
100 | }
101 | 


--------------------------------------------------------------------------------
/src/Model/Province.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * TERYT-API
  4 |  *
  5 |  * Copyright (c) 2017 pudelek.org.pl
  6 |  *
  7 |  * @license MIT License (MIT)
  8 |  *
  9 |  * For the full copyright and license information, please view source file
 10 |  * that is bundled with this package in the file LICENSE
 11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
 12 |  */
 13 | 
 14 | /**
 15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
 16 |  * Date: 07.09.2017
 17 |  */
 18 | 
 19 | namespace mrcnpdlk\Teryt\Model;
 20 | 
 21 | use mrcnpdlk\Teryt\Exception;
 22 | use mrcnpdlk\Teryt\NativeApi;
 23 | 
 24 | /**
 25 |  * Class Province
 26 |  */
 27 | class Province extends EntityAbstract
 28 | {
 29 |     /**
 30 |      * Dwuznakowy symbol województwa
 31 |      *
 32 |      * @var string
 33 |      */
 34 |     public $id;
 35 |     /**
 36 |      * Nazwa województwa
 37 |      *
 38 |      * @var string
 39 |      */
 40 |     public $name;
 41 | 
 42 |     /**
 43 |      * Province constructor.
 44 |      *
 45 |      * @param string $id Dwuznakowy symbol województwa
 46 |      *
 47 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 48 |      * @throws \mrcnpdlk\Teryt\Exception
 49 |      * @throws Exception\NotFound
 50 |      *
 51 |      * @return $this
 52 |      */
 53 |     public function find(string $id)
 54 |     {
 55 |         foreach (NativeApi::getInstance()->PobierzListeWojewodztw() as $w) {
 56 |             if ($w->provinceId === $id) {
 57 |                 $this->id   = $w->provinceId;
 58 |                 $this->name = $w->name;
 59 |             }
 60 |         }
 61 |         if (!$this->id) {
 62 |             throw new Exception\NotFound(sprintf('Province [id:%s] not exists', $id));
 63 |         }
 64 | 
 65 |         return $this;
 66 |     }
 67 | 
 68 |     /**
 69 |      * Pełnokontekstowe wyszukiwanie powiatów w województwie
 70 |      *
 71 |      * @param string|null $phrase Szukana fraza, gdy NULL zwraca wszystkie powiaty w województwie
 72 |      *
 73 |      * @throws \Exception
 74 |      *
 75 |      * @return \mrcnpdlk\Teryt\Model\District[]
 76 |      */
 77 |     public function searchDistricts(string $phrase = null)
 78 |     {
 79 |         try {
 80 |             $answer = [];
 81 |             if ($phrase) {
 82 |                 $tList = NativeApi::getInstance()->WyszukajJednostkeWRejestrze($phrase, NativeApi::CATEGORY_POW_ALL);
 83 |                 foreach ($tList as $p) {
 84 |                     if ($p->provinceId === $this->id) {
 85 |                         $answer[] = (new District())->find($p->provinceId . $p->districtId);
 86 |                     }
 87 |                 }
 88 |             } else {
 89 |                 $tList = NativeApi::getInstance()->PobierzListePowiatow($this->id);
 90 |                 foreach ($tList as $p) {
 91 |                     $answer[] = (new District())->find($p->provinceId . $p->districtId);
 92 |                 }
 93 |             }
 94 | 
 95 |             return $answer;
 96 |         } catch (Exception\NotFound $e) {
 97 |             return [];
 98 |         } catch (\Exception $e) {
 99 |             throw $e;
100 |         }
101 |     }
102 | }
103 | 


--------------------------------------------------------------------------------
/src/ResponseModel/Territory/AbstractResponseModel.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * TERYT-API
  4 |  *
  5 |  * Copyright (c) 2017 pudelek.org.pl
  6 |  *
  7 |  * @license MIT License (MIT)
  8 |  *
  9 |  * For the full copyright and license information, please view source file
 10 |  * that is bundled with this package in the file LICENSE
 11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
 12 |  */
 13 | 
 14 | /**
 15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
 16 |  * Date: 06.09.2017
 17 |  */
 18 | 
 19 | namespace mrcnpdlk\Teryt\ResponseModel\Territory;
 20 | 
 21 | use mrcnpdlk\Teryt\Model\Terc;
 22 | use stdClass;
 23 | 
 24 | /**
 25 |  * Class AbstractResponseModel
 26 |  */
 27 | abstract class AbstractResponseModel
 28 | {
 29 |     /**
 30 |      * Dwuznakowy symbol województwa
 31 |      *
 32 |      * @var string
 33 |      */
 34 |     public $provinceId;
 35 |     /**
 36 |      * Dwuznakowy symbol powiatu
 37 |      *
 38 |      * @var string|null
 39 |      */
 40 |     public $districtId;
 41 |     /**
 42 |      * Dwuznakowy symbol gminy
 43 |      *
 44 |      * @var string|null
 45 |      */
 46 |     public $communeId;
 47 |     /**
 48 |      * Jednoznakowy symbol gminy
 49 |      *
 50 |      * @var string|null
 51 |      */
 52 |     public $communeTypeId;
 53 |     /**
 54 |      * Nazwa województwa
 55 |      *
 56 |      * @var string
 57 |      */
 58 |     public $provinceName;
 59 |     /**
 60 |      * Nazwa powiatu
 61 |      *
 62 |      * @var string
 63 |      */
 64 |     public $districtName;
 65 |     /**
 66 |      * Nazwa gminy
 67 |      *
 68 |      * @var string
 69 |      */
 70 |     public $communeName;
 71 |     /**
 72 |      * Nazwa rodzaju gminy
 73 |      *
 74 |      * @var string|null
 75 |      */
 76 |     public $communeTypeName;
 77 |     /**
 78 |      * Określa datę katalogu dla wskazanego stanu w formacie YYYY-MM-DD
 79 |      *
 80 |      * @var string|null
 81 |      */
 82 |     public $statusDate;
 83 |     /**
 84 |      * Identyfikator gminy wraz z RODZ
 85 |      *
 86 |      * @var int
 87 |      */
 88 |     public $tercId;
 89 | 
 90 |     /**
 91 |      * AbstractResponseModel constructor.
 92 |      *
 93 |      * @throws \mrcnpdlk\Teryt\Exception
 94 |      */
 95 |     public function __construct()
 96 |     {
 97 |         $this->expandData();
 98 |     }
 99 | 
100 |     /**
101 |      * Dociągnięcie informacji na pozostałe pola obiektu
102 |      *
103 |      * @throws \mrcnpdlk\Teryt\Exception
104 |      *
105 |      * @return $this
106 |      */
107 |     public function expandData(): self
108 |     {
109 |         if ($this->tercId) {
110 |             $oTerc               = new Terc($this->tercId);
111 |             $this->provinceId    = $oTerc->getProvinceId();
112 |             $this->districtId    = $oTerc->getDistrictId();
113 |             $this->communeId     = $oTerc->getCommuneId();
114 |             $this->communeTypeId = $oTerc->getCommuneTypeId();
115 |         } else {
116 |             if ($this->provinceId && $this->districtId && $this->communeId && $this->communeTypeId) {
117 |                 $oTerc        = (new Terc())->setIds($this->provinceId, $this->districtId, $this->communeId, $this->communeTypeId);
118 |                 $this->tercId = $oTerc->getTercId();
119 |             }
120 |         }
121 | 
122 |         $this->clearData();
123 | 
124 |         return $this;
125 |     }
126 | 
127 |     /**
128 |      * Clearing empty value
129 |      *
130 |      * @return $this
131 |      */
132 |     public function clearData(): self
133 |     {
134 |         //clearing data
135 |         foreach (get_object_vars($this) as $prop => $value) {
136 |             if ('' === $value) {
137 |                 $this->{$prop} = null;
138 |             }
139 |         }
140 | 
141 |         return $this;
142 |     }
143 | }
144 | 


--------------------------------------------------------------------------------
/src/Model/Commune.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * TERYT-API
  4 |  *
  5 |  * Copyright (c) 2017 pudelek.org.pl
  6 |  *
  7 |  * @license MIT License (MIT)
  8 |  *
  9 |  * For the full copyright and license information, please view source file
 10 |  * that is bundled with this package in the file LICENSE
 11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
 12 |  */
 13 | 
 14 | /**
 15 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
 16 |  * Date: 07.09.2017
 17 |  */
 18 | 
 19 | namespace mrcnpdlk\Teryt\Model;
 20 | 
 21 | use mrcnpdlk\Teryt\Exception\InvalidArgument;
 22 | use mrcnpdlk\Teryt\Exception\NotFound;
 23 | use mrcnpdlk\Teryt\NativeApi;
 24 | 
 25 | /**
 26 |  * Class Commune
 27 |  */
 28 | class Commune extends EntityAbstract
 29 | {
 30 |     /**
 31 |      * 6 (lub 7) znakowy symbol powiatu lub tercId
 32 |      * sklada sie z 2 cyfr województwa , 2 powiatu, 2 gminy i 1 rodzaj gminy (opcjonalny)
 33 |      *
 34 |      * @var string
 35 |      */
 36 |     public $id;
 37 |     /**
 38 |      * Pełen identyfikator gminy
 39 |      *
 40 |      * @var string
 41 |      */
 42 |     public $tercId;
 43 |     /**
 44 |      * Nazwa powiatu
 45 |      *
 46 |      * @var string
 47 |      */
 48 |     public $name;
 49 |     /**
 50 |      * ID typu gminy
 51 |      *
 52 |      * @var string
 53 |      */
 54 |     public $typeId;
 55 |     /**
 56 |      * Nazwa typu gminy
 57 |      *
 58 |      * @var string
 59 |      */
 60 |     public $typeName;
 61 |     /**
 62 |      * Obiekt z danymi o powiecie w którym znajduje się gmina
 63 |      *
 64 |      * @var \mrcnpdlk\Teryt\Model\District
 65 |      */
 66 |     public $district;
 67 | 
 68 |     /**
 69 |      * Commune constructor.
 70 |      *
 71 |      * @param string $id 6 lub 7-znakowy symbol gminy
 72 |      *
 73 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 74 |      * @throws \mrcnpdlk\Teryt\Exception
 75 |      * @throws InvalidArgument
 76 |      * @throws NotFound
 77 |      *
 78 |      * @return $this
 79 |      */
 80 |     public function find(string $id)
 81 |     {
 82 |         switch (strlen($id)) {
 83 |             case 6:
 84 |                 $provinceId = substr($id, 0, 2);
 85 |                 $districtId = substr($id, 2, 2);
 86 |                 $communeId  = substr($id, 2, 2);
 87 |                 $tercId     = null;
 88 |                 break;
 89 |             case 7:
 90 |                 $provinceId = substr($id, 0, 2);
 91 |                 $districtId = substr($id, 2, 2);
 92 |                 $communeId  = substr($id, 2, 2);
 93 |                 $tercId     = $id;
 94 |                 break;
 95 |             default:
 96 |                 throw new InvalidArgument(sprintf('CommuneSymbol malformed, it has %s chars', strlen($id)));
 97 |         }
 98 |         if (!$tercId) {
 99 |             foreach (NativeApi::getInstance()->PobierzListeGmin($provinceId, $districtId) as $i) {
100 |                 if ($i->districtId === $districtId) {
101 |                     $this->id       = $id;
102 |                     $this->name     = $i->name;
103 |                     $this->typeName = $i->typeName;
104 |                     $this->typeId   = $i->communeTypeId;
105 |                     $tercId         = sprintf('%s%s%s%s', $provinceId, $districtId, $communeId, $i->communeTypeId);
106 |                 }
107 |             }
108 |         } else {
109 |             $res = NativeApi::getInstance()->WyszukajJednostkeWRejestrze(null, NativeApi::CATEGORY_GMI_ALL, [], [$tercId]);
110 |             if (!empty($res) && 1 === count($res)) {
111 |                 $oCommune       = $res[0];
112 |                 $this->id       = $id;
113 |                 $this->name     = $oCommune->communeName;
114 |                 $this->typeName = $oCommune->communeTypeName;
115 |                 $this->typeId   = $oCommune->communeTypeId;
116 |             }
117 |         }
118 |         if (!$this->id) {
119 |             throw new NotFound(sprintf('Commune [id:%s] not exists', $id));
120 |         }
121 | 
122 |         $this->id       = sprintf('%s%s%s', $provinceId, $districtId, $communeId);
123 |         $this->tercId   = $tercId;
124 |         $this->district = (new District())->find(sprintf('%s%s', $provinceId, $districtId));
125 | 
126 |         return $this;
127 |     }
128 | }
129 | 


--------------------------------------------------------------------------------
/src/Model/Terc.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * TERYT-API
  4 |  *
  5 |  * Copyright (c) 2017 pudelek.org.pl
  6 |  *
  7 |  * @license MIT License (MIT)
  8 |  *
  9 |  * For the full copyright and license information, please view source file
 10 |  * that is bundled with this package in the file LICENSE
 11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
 12 |  */
 13 | 
 14 | /**
 15 |  * Created by Marcin.
 16 |  * Date: 06.09.2017
 17 |  * Time: 20:51
 18 |  */
 19 | 
 20 | namespace mrcnpdlk\Teryt\Model;
 21 | 
 22 | use mrcnpdlk\Teryt\Exception;
 23 | 
 24 | /**
 25 |  * Class Terc
 26 |  */
 27 | class Terc
 28 | {
 29 |     /**
 30 |      * Dwuznakowy id wojewodztwa
 31 |      *
 32 |      * @var string|null
 33 |      */
 34 |     private $provinceId;
 35 |     /**
 36 |      * Dwuznakowy id powiatu
 37 |      *
 38 |      * @var string|null
 39 |      */
 40 |     private $districtId;
 41 |     /**
 42 |      * dwuznakowy id gminy
 43 |      *
 44 |      * @var string|null
 45 |      */
 46 |     private $communeId;
 47 |     /**
 48 |      * Jednoznakowy id rodzaju gminy
 49 |      *
 50 |      * @var string|null
 51 |      */
 52 |     private $communeTypeId;
 53 |     /**
 54 |      * Identyfikator gminy wraz z RODZ
 55 |      *
 56 |      * @var int|null
 57 |      */
 58 |     private $tercId;
 59 | 
 60 |     /**
 61 |      * Terc constructor.
 62 |      *
 63 |      * @param int|null $tercId
 64 |      *
 65 |      * @throws \mrcnpdlk\Teryt\Exception
 66 |      */
 67 |     public function __construct(int $tercId = null)
 68 |     {
 69 |         $this->setTercId($tercId);
 70 |     }
 71 | 
 72 |     /**
 73 |      * @return string|null
 74 |      */
 75 |     public function getCommuneId()
 76 |     {
 77 |         return $this->communeId;
 78 |     }
 79 | 
 80 |     /**
 81 |      * @return string|null
 82 |      */
 83 |     public function getCommuneTypeId()
 84 |     {
 85 |         return $this->communeTypeId;
 86 |     }
 87 | 
 88 |     /**
 89 |      * @return string|null
 90 |      */
 91 |     public function getDistrictId()
 92 |     {
 93 |         return $this->districtId;
 94 |     }
 95 | 
 96 |     /**
 97 |      * @return string|null
 98 |      */
 99 |     public function getProvinceId()
100 |     {
101 |         return $this->provinceId;
102 |     }
103 | 
104 |     /**
105 |      * @return int|null
106 |      */
107 |     public function getTercId()
108 |     {
109 |         return $this->tercId;
110 |     }
111 | 
112 |     /**
113 |      * Ustawienie idk-ów
114 |      * tercId jest generowany w locie
115 |      *
116 |      * @param string $provinceId
117 |      * @param string $districtId
118 |      * @param string $communeId
119 |      * @param string $communeTypeId
120 |      *
121 |      * @return static
122 |      */
123 |     public function setIds(string $provinceId, string $districtId, string $communeId, string $communeTypeId)
124 |     {
125 |         $this->provinceId    = str_pad($provinceId, 2, '0', \STR_PAD_LEFT);
126 |         $this->districtId    = str_pad($districtId, 2, '0', \STR_PAD_LEFT);
127 |         $this->communeId     = str_pad($communeId, 2, '0', \STR_PAD_LEFT);
128 |         $this->communeTypeId = $communeTypeId;
129 |         $this->tercId        = (int)sprintf('%s%s%s%s',
130 |             $this->provinceId,
131 |             $this->districtId,
132 |             $this->communeId,
133 |             $this->communeTypeId);
134 | 
135 |         return $this;
136 |     }
137 | 
138 |     /**
139 |      * Ustawienie tercId
140 |      * Pozostałe pola są generowanie w locie
141 |      *
142 |      * @param int|null $tercId
143 |      *
144 |      * @throws Exception
145 |      *
146 |      * @return static
147 |      */
148 |     public function setTercId(int $tercId = null)
149 |     {
150 |         if ($tercId) {
151 |             $this->tercId = $tercId;
152 |             $sTercId      = str_pad((string)$tercId, 7, '0', \STR_PAD_LEFT);
153 |             if (strlen($sTercId) > 7) {
154 |                 throw new Exception(sprintf('TercId [%s] malformed', $sTercId));
155 |             }
156 |             $this->provinceId    = substr($sTercId, 0, 2);
157 |             $this->districtId    = substr($sTercId, 2, 2);
158 |             $this->communeId     = substr($sTercId, 4, 2);
159 |             $this->communeTypeId = substr($sTercId, 6, 1);
160 |         }
161 | 
162 |         return $this;
163 |     }
164 | }
165 | 


--------------------------------------------------------------------------------
/src/Helper.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * TERYT-API
  4 |  *
  5 |  * Copyright (c) 2017 pudelek.org.pl
  6 |  *
  7 |  * @license MIT License (MIT)
  8 |  *
  9 |  * For the full copyright and license information, please view source file
 10 |  * that is bundled with this package in the file LICENSE
 11 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
 12 |  */
 13 | 
 14 | namespace mrcnpdlk\Teryt;
 15 | 
 16 | use mrcnpdlk\Teryt\Exception\Connection;
 17 | use SoapFault;
 18 | use SplFileObject;
 19 | use stdClass;
 20 | 
 21 | /**
 22 |  * Class Helper
 23 |  */
 24 | class Helper
 25 | {
 26 |     /**
 27 |      * Converting value to boolean
 28 |      *
 29 |      * @param mixed $exclude
 30 |      *
 31 |      * @return bool
 32 |      */
 33 |     public static function convertToBoolean($exclude): bool
 34 |     {
 35 |         if (is_bool($exclude)) {
 36 |             return $exclude;
 37 |         }
 38 | 
 39 |         if (is_numeric($exclude)) {
 40 |             return 1 === $exclude;
 41 |         }
 42 | 
 43 |         if (is_string($exclude)) {
 44 |             return 'true' === strtolower(trim($exclude)) || '1' === trim($exclude);
 45 |         }
 46 | 
 47 |         return false;
 48 |     }
 49 | 
 50 |     /**
 51 |      * Return unique property/key values from array of object/array
 52 |      *
 53 |      * @param array<mixed> $tItems
 54 |      * @param string       $sKey
 55 |      * @param bool         $asUnique
 56 |      *
 57 |      * @throws Exception
 58 |      *
 59 |      * @return array<mixed>
 60 |      */
 61 |     public static function getKeyValues(array $tItems, string $sKey, bool $asUnique = true): array
 62 |     {
 63 |         $answer = [];
 64 |         foreach ($tItems as $item) {
 65 |             if (!is_object($item) && !is_array($item)) {
 66 |                 throw new Exception(sprintf('%s() elem of tInput is not an array|object, is %s', __METHOD__, gettype($item)));
 67 |             }
 68 |             $item = (array)$item;
 69 |             if (
 70 |                 array_key_exists($sKey, $item)
 71 |                 && (is_string($item[$sKey]) || is_numeric($item[$sKey]))
 72 |                 && !in_array($item[$sKey], $answer, true)
 73 |             ) {
 74 |                 $answer[] = $item[$sKey];
 75 |             }
 76 |         }
 77 | 
 78 |         return $asUnique ? array_unique($answer) : $answer;
 79 |     }
 80 | 
 81 |     /**
 82 |      * Fixing Teryt API bug
 83 |      *
 84 |      * If only one item exists in response, returned property is not a array but object type
 85 |      *
 86 |      * @param \stdClass $oObject
 87 |      * @param string    $sPropertyName
 88 |      *
 89 |      * @throws Exception
 90 |      *
 91 |      * @return array<mixed>
 92 |      */
 93 |     public static function getPropertyAsArray(stdClass $oObject, string $sPropertyName): array
 94 |     {
 95 |         if (!property_exists($oObject, $sPropertyName)) {
 96 |             throw new Exception\NotFound(sprintf('%s() Property [%s] not exist in object', __METHOD__, $sPropertyName));
 97 |         }
 98 |         if (!is_array($oObject->{$sPropertyName})) {
 99 |             return [$oObject->{$sPropertyName}];
100 |         }
101 | 
102 |         return $oObject->{$sPropertyName};
103 |     }
104 | 
105 |     /**
106 |      * Fixing Teryt API bug
107 |      *
108 |      * If only one item exists in response, returned property is not a array but object type
109 |      *
110 |      * @param \stdClass $oObject
111 |      * @param string    $sPropertyName
112 |      *
113 |      * @throws Exception
114 |      * @throws Exception\NotFound
115 |      *
116 |      * @return mixed
117 |      */
118 |     public static function getPropertyAsObject(stdClass $oObject, string $sPropertyName)
119 |     {
120 |         if (!property_exists($oObject, $sPropertyName)) {
121 |             throw new Exception\NotFound(sprintf('%s() Property [%s] not exist in object', __METHOD__, $sPropertyName));
122 |         }
123 |         if (!is_object($oObject->{$sPropertyName})) {
124 |             throw new Exception(sprintf('%s() Property [%s] is not an object type [is:%s]', __METHOD__, $sPropertyName, gettype($oObject->{$sPropertyName})));
125 |         }
126 | 
127 |         return $oObject->{$sPropertyName};
128 |     }
129 | 
130 |     /**
131 |      * Catching and managment of exceptions
132 |      *
133 |      * @param \Exception $e
134 |      *
135 |      * @return \Exception|Exception|Connection
136 |      */
137 |     public static function handleException(\Exception $e)
138 |     {
139 |         if ($e instanceof SoapFault) {
140 |             switch ($e->faultcode ?? null) {
141 |                 case 'a:InvalidSecurityToken':
142 |                     return new Connection(sprintf('Invalid Security Token'), 1, $e);
143 |                 case 'WSDL':
144 |                     return new Connection(sprintf('%s', $e->faultstring ?? 'Unknown'), 2, $e);
145 |                 case 'Client':
146 |                     return new Connection(sprintf('%s', $e->faultstring ?? 'Unknown'), 3, $e);
147 |                 default:
148 |                     return new Connection(sprintf('%s', 'Unknown'), 99, $e);
149 |             }
150 |         } else {
151 |             if ($e instanceof Exception) {
152 |                 return $e;
153 |             }
154 | 
155 |             return new Exception('Unknown Exception', 1, $e);
156 |         }
157 |     }
158 | 
159 |     /**
160 |      * Save file on disk
161 |      *
162 |      * @param string $sPath   Destination path
163 |      * @param string $content File content
164 |      *
165 |      * @throws \RuntimeException
166 |      * @throws \LogicException
167 |      *
168 |      * @return \SplFileObject
169 |      */
170 |     public static function saveFile(string $sPath, string $content): SplFileObject
171 |     {
172 |         if (!file_exists($sPath) || (md5_file($sPath) !== md5($content))) {
173 |             $oFile = new SplFileObject($sPath, 'w+');
174 |             $oFile->fwrite($content);
175 |         }
176 | 
177 |         return new SplFileObject($sPath);
178 |     }
179 | }
180 | 


--------------------------------------------------------------------------------
/tests/suits/NativeApiTest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * TERYT-API
  4 |  *
  5 |  * Copyright (c) 2019 pudelek.org.pl
  6 |  *
  7 |  * @license MIT License (MIT)
  8 |  *
  9 |  * For the full copyright and license information, please view source file
 10 |  * that is bundled with this package in the file LICENSE
 11 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
 12 |  */
 13 | 
 14 | /**
 15 |  * Created by Marcin.
 16 |  * Date: 09.09.2017
 17 |  * Time: 20:12
 18 |  */
 19 | 
 20 | namespace Tests\mrcnpdlk\Teryt;
 21 | 
 22 | use DateTime;
 23 | use mrcnpdlk\Teryt\Client;
 24 | use mrcnpdlk\Teryt\Config;
 25 | use mrcnpdlk\Teryt\NativeApi;
 26 | use mrcnpdlk\Teryt\ResponseModel\Territory\JednostkaNomenklaturyNTS;
 27 | use mrcnpdlk\Teryt\ResponseModel\Territory\JednostkaTerytorialna;
 28 | use mrcnpdlk\Teryt\ResponseModel\Territory\ZweryfikowanyAdresBezUlic;
 29 | use SplFileObject;
 30 | 
 31 | class NativeApiTest extends TestCase
 32 | {
 33 |     /**
 34 |      * @var \mrcnpdlk\Teryt\NativeApi
 35 |      */
 36 |     private $oNativeApi;
 37 |     /**
 38 |      * @var Config
 39 |      */
 40 |     private $oConfig;
 41 | 
 42 |     public function setUp(): void
 43 |     {
 44 |         parent::setUp(); // TODO: Change the autogenerated stub
 45 |         $this->oConfig    = new Config();
 46 |         $this->oNativeApi = NativeApi::create($this->oConfig);
 47 |     }
 48 | 
 49 |     public function testCatalog(): void
 50 |     {
 51 |         $oFile      = $this->oNativeApi->PobierzKatalogWMRODZ();
 52 | 
 53 |         $this->assertInstanceOf(SplFileObject::class, $oFile);
 54 |         $this->assertEquals(true, file_exists($oFile->getPath()));
 55 |         $this->assertEquals(true, is_readable($oFile->getPath()));
 56 |     }
 57 | 
 58 |     public function testChanges(): void
 59 |     {
 60 |         $fromDate   = new DateTime();
 61 |         $toDate     = new DateTime();
 62 |         $oFile      = $this->oNativeApi->PobierzZmianyTercAdresowy($fromDate->modify('-14 day'), $toDate);
 63 | 
 64 |         $this->assertInstanceOf(SplFileObject::class, $oFile);
 65 |         $this->assertEquals(true, file_exists($oFile->getPath()));
 66 |         $this->assertEquals(true, is_readable($oFile->getPath()));
 67 |     }
 68 | 
 69 |     public function testTerc(): void
 70 |     {
 71 |         $tResp =  $this->oNativeApi->PobierzListeWojewodztw();
 72 |         $this->assertEquals(true, is_array($tResp));
 73 |         $this->assertInstanceOf(JednostkaTerytorialna::class, $tResp[0]);
 74 | 
 75 |         $tResp =  $this->oNativeApi->PobierzListePowiatow('10');
 76 |         $this->assertEquals(true, is_array($tResp));
 77 |         $this->assertInstanceOf(JednostkaTerytorialna::class, $tResp[0]);
 78 | 
 79 |         $tResp =  $this->oNativeApi->PobierzListeGmin('10', '06');
 80 |         $this->assertEquals(true, is_array($tResp));
 81 |         $this->assertInstanceOf(JednostkaTerytorialna::class, $tResp[0]);
 82 | 
 83 |         $tResp =  $this->oNativeApi->PobierzGminyiPowDlaWoj('10');
 84 |         $this->assertEquals(true, is_array($tResp));
 85 |         $this->assertInstanceOf(JednostkaTerytorialna::class, $tResp[0]);
 86 |     }
 87 | 
 88 |     public function testNTS(): void
 89 |     {
 90 |         $tResp =  $this->oNativeApi->PobierzListeRegionow();
 91 |         $this->assertEquals(true, is_array($tResp));
 92 |         $this->assertInstanceOf(JednostkaNomenklaturyNTS::class, $tResp[0]);
 93 | 
 94 |         $tResp =  $this->oNativeApi->PobierzListeWojewodztwWRegionie('1');
 95 |         $this->assertEquals(true, is_array($tResp));
 96 |         $this->assertInstanceOf(JednostkaNomenklaturyNTS::class, $tResp[0]);
 97 | 
 98 |         $tResp =  $this->oNativeApi->PobierzListePodregionow('10');
 99 |         $this->assertEquals(true, is_array($tResp));
100 |         $this->assertInstanceOf(JednostkaNomenklaturyNTS::class, $tResp[0]);
101 | 
102 |         $tResp =  $this->oNativeApi->PobierzListePowiatowWPodregionie('19');
103 |         $this->assertEquals(true, is_array($tResp));
104 |         $this->assertInstanceOf(JednostkaNomenklaturyNTS::class, $tResp[0]);
105 | 
106 |         $tResp =  $this->oNativeApi->PobierzListeGminPowiecie('15', '19');
107 |         $this->assertEquals(true, is_array($tResp));
108 |         $this->assertInstanceOf(JednostkaNomenklaturyNTS::class, $tResp[0]);
109 |     }
110 | 
111 |     public function testDictionary(): void
112 |     {
113 |         $tResp = $this->oNativeApi->PobierzSlownikCechULIC();
114 |         $this->assertEquals(true, is_array($tResp));
115 |         $tResp = $this->oNativeApi->PobierzSlownikRodzajowSIMC();
116 |         $this->assertEquals(true, is_array($tResp));
117 |         $tResp = $this->oNativeApi->PobierzSlownikCechULIC();
118 |         $this->assertEquals(true, is_array($tResp));
119 |     }
120 | 
121 |     public function testVerification(): void
122 |     {
123 |         $oResp = $this->oNativeApi->WeryfikujAdresDlaMiejscowosci('0976050');
124 |         $this->assertInstanceOf(ZweryfikowanyAdresBezUlic::class, $oResp);
125 |         $oResp = $this->oNativeApi->WeryfikujAdresDlaMiejscowosciAdresowy('0976050');
126 |         $this->assertInstanceOf(ZweryfikowanyAdresBezUlic::class, $oResp);
127 |         $tResp = $this->oNativeApi->WeryfikujAdresWmiejscowosci('łódzkie', 'sieradzki', 'sieradz', 'sieradz', null);
128 |         $this->assertEquals(true, is_array($tResp));
129 |         $this->assertInstanceOf(ZweryfikowanyAdresBezUlic::class, $tResp[0]);
130 |         $tResp = $this->oNativeApi->WeryfikujAdresWmiejscowosciAdresowy('łódzkie', 'sieradzki', 'sieradz', 'sieradz', null);
131 |         $this->assertEquals(true, is_array($tResp));
132 |         $this->assertInstanceOf(ZweryfikowanyAdresBezUlic::class, $tResp[0]);
133 | 
134 |         $oResp = $this->oNativeApi->WeryfikujAdresDlaUlic('0976050', '00157');
135 |         $this->assertInstanceOf(ZweryfikowanyAdresBezUlic::class, $oResp);
136 |         $oResp = $this->oNativeApi->WeryfikujAdresDlaUlicAdresowy('0976050', '00157');
137 |         $this->assertInstanceOf(ZweryfikowanyAdresBezUlic::class, $oResp);
138 |     }
139 | }
140 | 


--------------------------------------------------------------------------------
/src/Config.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | declare(strict_types=1);
  4 | /**
  5 |  * TERYT-API
  6 |  *
  7 |  * Copyright (c) 2019 pudelek.org.pl
  8 |  *
  9 |  * @license MIT License (MIT)
 10 |  *
 11 |  * For the full copyright and license information, please view source file
 12 |  * that is bundled with this package in the file LICENSE
 13 |  * @author  Marcin Pudełek <marcin@pudelek.org.pl>
 14 |  */
 15 | 
 16 | /**
 17 |  * Created by Marcin Pudełek <marcin@pudelek.org.pl>
 18 |  * Date: 24.12.2019
 19 |  * Time: 12:29
 20 |  */
 21 | 
 22 | namespace mrcnpdlk\Teryt;
 23 | 
 24 | use DateTime;
 25 | use Mrcnpdlk\Lib\ConfigurationOptionsAbstract;
 26 | use mrcnpdlk\Psr16Cache\Adapter;
 27 | use mrcnpdlk\Teryt\Exception\Connection;
 28 | use mrcnpdlk\Teryt\Exception\Response;
 29 | use Psr\SimpleCache\CacheInterface;
 30 | 
 31 | class Config extends ConfigurationOptionsAbstract
 32 | {
 33 |     public const SERVICE_URL_TEST      = 'https://uslugaterytws1test.stat.gov.pl/wsdl/terytws1.wsdl';
 34 |     public const SERVICE_URL           = 'https://uslugaterytws1.stat.gov.pl/wsdl/terytws1.wsdl';
 35 |     public const SERVICE_USER_TEST     = 'TestPubliczny';
 36 |     public const SERVICE_PASSWORD_TEST = '1234abcd';
 37 | 
 38 |     /**
 39 |      * @var string
 40 |      */
 41 |     protected $username = self::SERVICE_USER_TEST;
 42 |     /**
 43 |      * @var string
 44 |      */
 45 |     protected $password = self::SERVICE_PASSWORD_TEST;
 46 |     /**
 47 |      * @var bool
 48 |      */
 49 |     protected $isProduction = false;
 50 |     /**
 51 |      * @var \mrcnpdlk\Psr16Cache\Adapter
 52 |      */
 53 |     private $oCacheAdapter;
 54 |     /**
 55 |      * SoapClient handler
 56 |      *
 57 |      * @var \mrcnpdlk\Teryt\TerytSoapClient|null
 58 |      */
 59 |     private $soapClient;
 60 |     /**
 61 |      * @var \Psr\SimpleCache\CacheInterface|null
 62 |      */
 63 |     protected $cache;
 64 |     /**
 65 |      * @var string
 66 |      */
 67 |     private $serviceUrl;
 68 | 
 69 |     /**
 70 |      * Config constructor.
 71 |      *
 72 |      * @param array<string,mixed> $config
 73 |      *
 74 |      * @throws \Mrcnpdlk\Lib\ConfigurationException
 75 |      */
 76 |     public function __construct(array $config = [])
 77 |     {
 78 |         parent::__construct($config);
 79 |         $this->oCacheAdapter = new Adapter($this->cache, $this->getLogger());
 80 |         $this->serviceUrl    = $this->isProduction ? self::SERVICE_URL : self::SERVICE_URL_TEST;
 81 |     }
 82 | 
 83 |     /**
 84 |      * Making request to Teryt WS1 API
 85 |      *
 86 |      * @param string               $method  Method name
 87 |      * @param array<string, mixed> $args    Parameters
 88 |      * @param bool                 $addDate Add DataStanu to request
 89 |      *
 90 |      * @throws \mrcnpdlk\Teryt\Exception
 91 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 92 |      *
 93 |      * @return mixed
 94 |      */
 95 |     public function request(string $method, array $args = [], bool $addDate = true)
 96 |     {
 97 |         try {
 98 |             if (!array_key_exists('DataStanu', $args) && $addDate) {
 99 |                 $args['DataStanu'] = (new DateTime())->format('Y-m-d');
100 |             }
101 |             $self = $this;
102 |             $this->getLogger()->debug(sprintf('REQ: %s', $method), $args);
103 | 
104 |             $resp = $this->oCacheAdapter->useCache(
105 |                 static function () use ($self, $method, $args) {
106 |                     $res       = $self->getSoap()->__soapCall($method, [$args]);
107 |                     $resultKey = $method . 'Result';
108 |                     if (!property_exists($res, $resultKey)) {
109 |                         throw new Response(sprintf('%s doesnt exist in response', $resultKey));
110 |                     }
111 | 
112 |                     return $res->{$resultKey};
113 |                 },
114 |                 [__METHOD__, $method, $args]
115 |             );
116 | 
117 |             $this->getLogger()->debug(sprintf('RESP: %s, type is %s', $method, gettype($resp)));
118 | 
119 |             return $resp;
120 |         } catch (\Exception $e) {
121 |             throw Helper::handleException($e);
122 |         }
123 |     }
124 | 
125 |     /**
126 |      * @param \Psr\SimpleCache\CacheInterface|null $cache
127 |      *
128 |      * @return Config
129 |      */
130 |     public function setCache(?CacheInterface $cache): Config
131 |     {
132 |         $this->cache = $cache;
133 | 
134 |         return $this;
135 |     }
136 | 
137 |     /**
138 |      * @param bool $isProduction
139 |      *
140 |      * @return Config
141 |      */
142 |     public function setIsProduction(bool $isProduction): Config
143 |     {
144 |         $this->isProduction = $isProduction;
145 | 
146 |         return $this;
147 |     }
148 | 
149 |     /**
150 |      * @param string $password
151 |      *
152 |      * @return Config
153 |      */
154 |     public function setPassword(string $password): Config
155 |     {
156 |         $this->password = $password;
157 | 
158 |         return $this;
159 |     }
160 | 
161 |     /**
162 |      * @param string $username
163 |      *
164 |      * @return Config
165 |      */
166 |     public function setUsername(string $username): Config
167 |     {
168 |         $this->username = $username;
169 | 
170 |         return $this;
171 |     }
172 | 
173 |     /**
174 |      * Get SoapClient
175 |      *
176 |      * @return \mrcnpdlk\Teryt\TerytSoapClient
177 |      */
178 |     private function getSoap(): TerytSoapClient
179 |     {
180 |         try {
181 |             if (null === $this->soapClient) {
182 |                 $this->reinitSoap();
183 |             }
184 |         } catch (\Exception $e) {
185 |             Helper::handleException($e);
186 |         }
187 | 
188 |         return $this->soapClient;
189 |     }
190 | 
191 |     /**
192 |      * Reinit Soap Client
193 |      *
194 |      * @throws \Exception
195 |      * @throws Connection
196 |      * @throws Exception
197 |      *
198 |      * @return $this
199 |      */
200 |     private function reinitSoap(): self
201 |     {
202 |         try {
203 |             $this->soapClient = new TerytSoapClient($this->serviceUrl, [
204 |                 'soap_version' => SOAP_1_1,
205 |                 'exceptions'   => true,
206 |                 'cache_wsdl'   => WSDL_CACHE_BOTH,
207 |             ]);
208 |             $this->soapClient->addUserToken($this->username, $this->password);
209 |         } catch (\Exception $e) {
210 |             throw Helper::handleException($e);
211 |         }
212 | 
213 |         return $this;
214 |     }
215 | }
216 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | 
  2 | [![Latest Stable Version](https://img.shields.io/github/release/mrcnpdlk/teryt-api.svg)](https://packagist.org/packages/mrcnpdlk/teryt-api)
  3 | [![Latest Unstable Version](https://poser.pugx.org/mrcnpdlk/teryt-api/v/unstable.png)](https://packagist.org/packages/mrcnpdlk/teryt-api)
  4 | [![Total Downloads](https://img.shields.io/packagist/dt/mrcnpdlk/teryt-api.svg)](https://packagist.org/packages/mrcnpdlk/teryt-api)
  5 | [![Monthly Downloads](https://img.shields.io/packagist/dm/mrcnpdlk/teryt-api.svg)](https://packagist.org/packages/mrcnpdlk/teryt-api)
  6 | [![License](https://img.shields.io/packagist/l/mrcnpdlk/teryt-api.svg)](https://packagist.org/packages/mrcnpdlk/teryt-api)    
  7 | 
  8 | [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/mrcnpdlk/teryt-api/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/mrcnpdlk/teryt-api/?branch=master) 
  9 | [![Build Status](https://scrutinizer-ci.com/g/mrcnpdlk/teryt-api/badges/build.png?b=master)](https://scrutinizer-ci.com/g/mrcnpdlk/teryt-api/build-status/master)
 10 | [![Code Coverage](https://scrutinizer-ci.com/g/mrcnpdlk/teryt-api/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/mrcnpdlk/teryt-api/?branch=master)
 11 | 
 12 | [![Code Climate](https://codeclimate.com/github/mrcnpdlk/teryt-api/badges/gpa.svg)](https://codeclimate.com/github/mrcnpdlk/teryt-api) 
 13 | [![Issue Count](https://codeclimate.com/github/mrcnpdlk/teryt-api/badges/issue_count.svg)](https://codeclimate.com/github/mrcnpdlk/teryt-api)
 14 | 
 15 | 
 16 | [![Dependency Status](https://www.versioneye.com/user/projects/59b2679a368b08003d0e8455/badge.svg)](https://www.versioneye.com/user/projects/59b2679a368b08003d0e8455?child=summary) 
 17 | 
 18 | 
 19 | # TERYT WS1 API - Polish address database
 20 | 
 21 | ## Installation
 22 | 
 23 | Install the latest version with [composer](https://packagist.org/packages/mrcnpdlk/teryt-api)
 24 | ```bash
 25 | composer require mrcnpdlk/teryt-api
 26 | ```
 27 | 
 28 | ## Basic usage
 29 | 
 30 | ### Cache
 31 | Library supports Cache bundles based on [PSR-16](http://www.php-fig.org/psr/psr-16/) standard.
 32 | 
 33 | For below example was used [phpfastcache/phpfastcache](https://github.com/PHPSocialNetwork/phpfastcache).
 34 | `phpfastcache/phpfastcache` supports a lot of endpoints, i.e. `Files`, `Sqlite`, `Redis` and many other. 
 35 | More information about using cache and configuration it you can find in this [Wiki](https://github.com/PHPSocialNetwork/phpfastcache/wiki). 
 36 | 
 37 | ```php
 38 | 
 39 |     /**
 40 |      * Cache in system files
 41 |      */
 42 |     $oInstanceCacheFiles = new \phpFastCache\Helper\Psr16Adapter('files');
 43 | 
 44 | ```
 45 | 
 46 | ### Log
 47 | 
 48 | Library also supports logging packages based on [PSR-3](http://www.php-fig.org/psr/psr-3/) standard, i.e. very popular
 49 | [monolog/monolog](https://github.com/Seldaek/monolog).
 50 | 
 51 | ```php
 52 | 
 53 | $oInstanceLogger = new \Monolog\Logger('name_of_my_logger');
 54 | $oInstanceLogger->pushHandler(new \Monolog\Handler\ErrorLogHandler(
 55 |         \Monolog\Handler\ErrorLogHandler::OPERATING_SYSTEM,
 56 |         \Psr\Log\LogLevel::DEBUG
 57 |     )
 58 | );
 59 | 
 60 | ```
 61 | 
 62 | ### Teryt Authentication
 63 | Service TERYT WS1 shares API based on `SOAP Protocol`. More information about service you can find on 
 64 | this [site](http://eteryt.stat.gov.pl/eTeryt/rejestr_teryt/udostepnianie_danych/baza_teryt/usluga_sieciowa_interfejsy_api/jakkorzystac.aspx)
 65 | There are two ways to connect to the server:
 66 |  - `production database` - you need login/password
 67 |  - `testing database` - default authentication with default login/password pair
 68 | 
 69 | First of all we need configure connection calling `setTerytConfig()` method and 
 70 | optionally set cache and log instances
 71 | 
 72 | ```php
 73 | use mrcnpdlk\Teryt\Client;
 74 | use mrcnpdlk\Teryt\NativeApi;
 75 | use mrcnpdlk\Teryt\Config;
 76 | 
 77 | $oConfig = new Config([
 78 |     'logger'       => $oInstanceLogger,
 79 |     'cache'        => $oInstanceCacheFiles,
 80 |     'username'     => 'my_login',
 81 |     'password'     => 'my_password',
 82 |     'isProduction' => true,
 83 | ]);
 84 | $oNativeApi = NativeApi::create($oConfig);
 85 | ```
 86 | 
 87 | After that we able to call auxiliary static methods defined in NativeApi class, i.e:
 88 | ```php
 89 | var_dump($oNativeApi->CzyZalogowany());
 90 | var_dump($oNativeApi->PobierzSlownikCechULIC());
 91 | var_dump($oNativeApi->WyszukajMiejscowosc('skiernie',null));
 92 | ```
 93 | 
 94 | ## Defined methods (`\mrcnpdlk\Teryt\NativeApi`)
 95 | Almost all methods from official documentation have been mapped and defined.
 96 | 
 97 | Full list below `\mrcnpdlk\Teryt\NativeApi`:
 98 | 
 99 | ### General
100 | 
101 | 
102 | | Method | Status | Description|
103 | | ------ | ------ |------ |
104 | |`CzyZalogowany()`|:ok_hand:||
105 | |`PobierzDateAktualnegoKatTerc()`|:ok_hand:||
106 | |`PobierzDateAktualnegoKatNTS()`|:ok_hand:||
107 | |`PobierzDateAktualnegoKatSimc()`|:ok_hand:||
108 | |`PobierzDateAktualnegoKatUlic()`|:ok_hand:||
109 | 
110 | ### Catalog TERC
111 | 
112 | | Method | Status | Description|
113 | | ------ | ------ |------ |
114 | |`PobierzListeWojewodztw()`|:ok_hand:||
115 | |`PobierzListePowiatow()`|:ok_hand:||
116 | |`PobierzListeGmin()`|:ok_hand:||
117 | |`PobierzGminyiPowDlaWoj()`|:ok_hand:||
118 | 
119 | ### Catalog NTS
120 | 
121 | | Method | Status | Description|
122 | | ------ | ------ |------ |
123 | |`PobierzListeRegionow()`|:ok_hand:||
124 | |`PobierzListeWojewodztwWRegionie()`|:ok_hand:||
125 | |`PobierzListePodregionow()`|:ok_hand:||
126 | |`PobierzListePowiatowWPodregionie()`|:ok_hand:||
127 | |`PobierzListeGminPowiecie()`|:ok_hand:||
128 | 
129 | ### Catalog ULIC
130 | 
131 | | Method | Status | Description|
132 | | ------ | ------ |------ |
133 | |`PobierzListeUlicDlaMiejscowosci()`|:ok_hand:||
134 | 
135 | ### Catalog SIMC
136 | 
137 | | Method | Status | Description|
138 | | ------ | ------ |------ |
139 | |`PobierzListeMiejscowosciWGminie()`|:ok_hand:||
140 | |`PobierzListeMiejscowosciWRodzajuGminy()`|:ok_hand:||
141 | 
142 | ### Dictionary
143 | 
144 | | Method | Status | Description|
145 | | ------ | ------ |------ |
146 | |`PobierzSlownikRodzajowJednostek()`|:ok_hand:||
147 | |`PobierzSlownikRodzajowSIMC()`|:ok_hand:||
148 | |`PobierzSlownikCechULIC()`|:ok_hand:||
149 | 
150 | ### Catalog
151 | 
152 | | Method | Status | Description|
153 | | ------ | ------ |------ |
154 | |`PobierzKatalogTERCAdr()`|:ok_hand:||
155 | |`PobierzKatalogTERC()`|:ok_hand:||
156 | |`PobierzKatalogNTS()`|:ok_hand:||
157 | |`PobierzKatalogSIMCAdr()`|:ok_hand:||
158 | |`PobierzKatalogSIMC()`|:ok_hand:||
159 | |`PobierzKatalogSIMCStat()`|:ok_hand:||
160 | |`PobierzKatalogULIC()`|:ok_hand:||
161 | |`PobierzKatalogULICAdr()`|:ok_hand:||
162 | |`PobierzKatalogULICBezDzielnic()`|:ok_hand:||
163 | |`PobierzKatalogWMRODZ()`|:ok_hand:||
164 | 
165 | ### Changes
166 | 
167 | | Method | Status | Description|
168 | | ------ | ------ |------ |
169 | |`PobierzZmianyTercUrzedowy()`|:ok_hand:||
170 | |`PobierzZmianyTercAdresowy()`|:ok_hand:||
171 | |`PobierzZmianyNTS()`|:ok_hand:||
172 | |`PobierzZmianySimcUrzedowy()`|:ok_hand:||
173 | |`PobierzZmianySimcAdresowy()`|:ok_hand:||
174 | |`PobierzZmianySimcStatystyczny()`|:ok_hand:||
175 | |`PobierzZmianyUlicUrzedowy()`|:ok_hand:||
176 | |`PobierzZmianyUlicAdresowy()`|:ok_hand:||
177 | 
178 | ### Verification
179 | 
180 | | Method | Status | Description|
181 | | ------ | ------ |------ |
182 | |`WeryfikujAdresDlaMiejscowosci()`|:ok_hand:||
183 | |`WeryfikujAdresDlaMiejscowosciAdresowy()`|:ok_hand:||
184 | |`WeryfikujAdresWmiejscowosci()`|:ok_hand:||
185 | |`WeryfikujAdresWmiejscowosciAdresowy()`|:ok_hand:||
186 | |`WeryfikujAdresDlaUlic()`|:ok_hand:||
187 | |`WeryfikujAdresDlaUlicAdresowy()`|:ok_hand:||
188 | |`WeryfikujNazwaAdresUlic()`|:warning:|empty response|
189 | |`WeryfikujNazwaAdresUlicAdresowy()`|:ok_hand:||
190 | 
191 | ### Search
192 | 
193 | | Method | Status | Description|
194 | | ------ | ------ |------ |
195 | |`WyszukajJPT()`|:warning:|empty response|
196 | |`WyszukajMiejscowosc()`|:ok_hand:||
197 | |`WyszukajMiejscowoscWJPT()`|:ok_hand:||
198 | |`WyszukajUlice()`|:ok_hand:||
199 | |`WyszukajJednostkeWRejestrze()`|:ok_hand:||
200 | |`WyszukajMiejscowoscWRejestrze()`|:ok_hand:||
201 | |`WyszukajUliceWRejestrze()`|:ok_hand:||
202 | 
203 | ## Defined methods (`\mrcnpdlk\Teryt\Api`)
204 | 
205 | | Method | Status | Description|
206 | | ------ | ------ |------ |
207 | |`getCity()`|:ok_hand:||
208 | 
209 | ```php
210 | $oApi = new \mrcnpdlk\Teryt\Api($oClient);
211 | print_r($oApi->getCity('0700884'));
212 | ```
213 | 
214 | ```text
215 | mrcnpdlk\Teryt\Model\City Object
216 | (
217 |     [id] => 0700884
218 |     [parentId] => 0700884
219 |     [rmId] => 01
220 |     [rmName] => wieś
221 |     [name] => Burzenin
222 |     [commune] => mrcnpdlk\Teryt\Model\Commune Object
223 |         (
224 |             [id] => 101414
225 |             [tercId] => 1014052
226 |             [name] => Burzenin
227 |             [typeId] => 2
228 |             [typeName] => gmina wiejska
229 |             [district] => mrcnpdlk\Teryt\Model\District Object
230 |                 (
231 |                     [id] => 1014
232 |                     [name] => sieradzki
233 |                     [typeName] => powiat
234 |                     [province] => mrcnpdlk\Teryt\Model\Province Object
235 |                         (
236 |                             [id] => 10
237 |                             [name] => ŁÓDZKIE
238 |                         )
239 |                 )
240 |         )
241 | )
242 | ```
243 | 


--------------------------------------------------------------------------------
/src/NativeApi.php:
--------------------------------------------------------------------------------
   1 | <?php
   2 | 
   3 | declare(strict_types=1);
   4 | /**
   5 |  * TERYT-API
   6 |  *
   7 |  * Copyright (c) 2019 pudelek.org.pl
   8 |  *
   9 |  * @license MIT License (MIT)
  10 |  *
  11 |  * For the full copyright and license information, please view source file
  12 |  * that is bundled with this package in the file LICENSE
  13 |  * @author Marcin Pudełek <marcin@pudelek.org.pl>
  14 |  */
  15 | 
  16 | /**
  17 |  * Created by Marcin.
  18 |  * Date: 11.09.2017
  19 |  * Time: 23:01
  20 |  */
  21 | 
  22 | namespace mrcnpdlk\Teryt;
  23 | 
  24 | use DateTime;
  25 | use mrcnpdlk\Teryt\Model\Terc;
  26 | use mrcnpdlk\Teryt\ResponseModel\Dictionary\RodzajMiejscowosci;
  27 | use mrcnpdlk\Teryt\ResponseModel\Territory\JednostkaNomenklaturyNTS;
  28 | use mrcnpdlk\Teryt\ResponseModel\Territory\JednostkaPodzialuTerytorialnego;
  29 | use mrcnpdlk\Teryt\ResponseModel\Territory\JednostkaTerytorialna;
  30 | use mrcnpdlk\Teryt\ResponseModel\Territory\Miejscowosc;
  31 | use mrcnpdlk\Teryt\ResponseModel\Territory\Ulica;
  32 | use mrcnpdlk\Teryt\ResponseModel\Territory\UlicaDrzewo;
  33 | use mrcnpdlk\Teryt\ResponseModel\Territory\WyszukanaMiejscowosc;
  34 | use mrcnpdlk\Teryt\ResponseModel\Territory\WyszukanaUlica;
  35 | use mrcnpdlk\Teryt\ResponseModel\Territory\ZweryfikowanyAdres;
  36 | use mrcnpdlk\Teryt\ResponseModel\Territory\ZweryfikowanyAdresBezUlic;
  37 | use SplFileObject;
  38 | 
  39 | final class NativeApi
  40 | {
  41 |     /**
  42 |      * @var string Wyszukiwanie wśród wszystkich rodzajów jednostek
  43 |      */
  44 |     public const CATEGORY_ALL         = '0'; // Wyszukiwanie wśród wszystkich rodzajów jednostek
  45 |     public const CATEGORY_WOJ_ALL     = '1'; // Dla województw
  46 |     public const CATEGORY_POW_ALL     = '2'; // Dla wszystkich powiatów
  47 |     public const CATEGORY_POW_ZIE     = '21'; // Dla powiatów ziemskich (identyfikator powiatu 01-60)
  48 |     public const CATEGORY_POW_MIA     = '22'; // Dla miast na prawach powiatu (identyfikator powiatu 61-99)
  49 |     public const CATEGORY_GMI_ALL     = '3'; // Dla gmin ogółem
  50 |     public const CATEGORY_GMI_MIA     = '31'; // Dla gmin miejskich (identyfikator rodzaju gminy 1)
  51 |     public const CATEGORY_DELEG       = '32'; // Dla dzielnic i delegatur (identyfikator rodzaju 8 i 9)
  52 |     public const CATEGORY_GMI_WIE     = '33'; // Dla gmin wiejskich (identyfikator rodzaju 2)
  53 |     public const CATEGORY_GMI_MIE_WIE = '34'; // Dla gmin miejsko-wiejskich (3)
  54 |     public const CATEGORY_MIA         = '341'; // Dla miast w gminach miejsko-wiejskich(4)
  55 |     public const CATEGORY_MIA_OBS     = '342'; // Dla obszarów miejskich w gminach miejsko-wiejskich(5)
  56 |     public const CATEGORY_MIA_ALL     = '35'; // Dla miast ogółem (identyfikator 1 i 4)
  57 |     public const CATEGORY_WIE         = '36'; // Dla terenów wiejskich (identyfikator 2 i 5)
  58 | 
  59 |     /**
  60 |      * Określenie zakresu miejscowości
  61 |      */
  62 |     public const SEARCH_CITY_TYPE_ALL  = '000'; //Wszystkie
  63 |     public const SEARCH_CITY_TYPE_MAIN = '001'; //Miejscowości podstawowe
  64 |     public const SEARCH_CITY_TYPE_ADD  = '002'; //Części integralne miejscowości
  65 | 
  66 |     /**
  67 |      * @var \mrcnpdlk\Teryt\NativeApi|null
  68 |      */
  69 |     private static $instance = null;
  70 |     /**
  71 |      * @var \mrcnpdlk\Teryt\Config
  72 |      */
  73 |     private $oConfig;
  74 | 
  75 |     /**
  76 |      * NativeApi constructor.
  77 |      *
  78 |      * @param \mrcnpdlk\Teryt\Config $configuration
  79 |      */
  80 |     private function __construct(Config $configuration)
  81 |     {
  82 |         $this->oConfig = $configuration;
  83 |     }
  84 | 
  85 |     /**
  86 |      * @param \mrcnpdlk\Teryt\Config $configuration
  87 |      *
  88 |      * @return \mrcnpdlk\Teryt\NativeApi
  89 |      */
  90 |     public static function create(Config $configuration): NativeApi
  91 |     {
  92 |         static::$instance = new static($configuration);
  93 | 
  94 |         return static::$instance;
  95 |     }
  96 | 
  97 |     /**
  98 |      * @throws \mrcnpdlk\Teryt\Exception
  99 |      *
 100 |      * @return \mrcnpdlk\Teryt\NativeApi
 101 |      */
 102 |     public static function getInstance(): NativeApi
 103 |     {
 104 |         if (null === static::$instance) {
 105 |             throw new Exception(sprintf('First call CREATE method!'));
 106 |         }
 107 | 
 108 |         return static::$instance;
 109 |     }
 110 | 
 111 |     /**
 112 |      * Sprawdzenie czy użytkownik jest zalogowany
 113 |      *
 114 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 115 |      * @throws \mrcnpdlk\Teryt\Exception
 116 |      *
 117 |      * @return bool
 118 |      */
 119 |     public function CzyZalogowany(): bool
 120 |     {
 121 |         return $this->oConfig->request('CzyZalogowany');
 122 |     }
 123 | 
 124 |     /**
 125 |      * Data początkowa bieżącego stanu katalogu NTS
 126 |      *
 127 |      * @throws \mrcnpdlk\Teryt\Exception
 128 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 129 |      *
 130 |      * @return string|null Data w formacie YYY-MM-DD
 131 |      */
 132 |     public function PobierzDateAktualnegoKatNTS()
 133 |     {
 134 |         $res = $this->oConfig->request('PobierzDateAktualnegoKatNTS');
 135 | 
 136 |         try {
 137 |             return (new DateTime($res))->format('Y-m-d');
 138 |         } catch (\Exception $e) {
 139 |             return null;
 140 |         }
 141 |     }
 142 | 
 143 |     /**
 144 |      * Data początkowa bieżącego stanu katalogu SIMC
 145 |      *
 146 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 147 |      * @throws \mrcnpdlk\Teryt\Exception
 148 |      *
 149 |      * @return string|null Data w formacie YYY-MM-DD
 150 |      */
 151 |     public function PobierzDateAktualnegoKatSimc()
 152 |     {
 153 |         $res = $this->oConfig->request('PobierzDateAktualnegoKatSimc');
 154 | 
 155 |         try {
 156 |             return (new DateTime($res))->format('Y-m-d');
 157 |         } catch (\Exception $e) {
 158 |             return null;
 159 |         }
 160 |     }
 161 | 
 162 |     /**
 163 |      * Data początkowa bieżącego stanu katalogu TERC
 164 |      *
 165 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 166 |      * @throws \mrcnpdlk\Teryt\Exception
 167 |      *
 168 |      * @return string|null Data w formacie YYY-MM-DD
 169 |      */
 170 |     public function PobierzDateAktualnegoKatTerc()
 171 |     {
 172 |         $res = $this->oConfig->request('PobierzDateAktualnegoKatTerc');
 173 | 
 174 |         try {
 175 |             return (new DateTime($res))->format('Y-m-d');
 176 |         } catch (\Exception $e) {
 177 |             return null;
 178 |         }
 179 |     }
 180 | 
 181 |     /**
 182 |      * Data początkowa bieżącego stanu katalogu ULIC
 183 |      *
 184 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 185 |      * @throws \mrcnpdlk\Teryt\Exception
 186 |      *
 187 |      * @return string|null Data w formacie YYY-MM-DD
 188 |      */
 189 |     public function PobierzDateAktualnegoKatUlic()
 190 |     {
 191 |         $res = $this->oConfig->request('PobierzDateAktualnegoKatUlic');
 192 | 
 193 |         try {
 194 |             return (new DateTime($res))->format('Y-m-d');
 195 |         } catch (\Exception $e) {
 196 |             return null;
 197 |         }
 198 |     }
 199 | 
 200 |     /**
 201 |      * Lista powiatów i gmin we wskazanym województwie
 202 |      *
 203 |      * @param string $provinceId
 204 |      *
 205 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 206 |      * @throws \mrcnpdlk\Teryt\Exception
 207 |      *
 208 |      * @return JednostkaTerytorialna[]
 209 |      */
 210 |     public function PobierzGminyiPowDlaWoj(string $provinceId): array
 211 |     {
 212 |         $answer = [];
 213 |         $res    = $this->oConfig->request('PobierzGminyiPowDlaWoj', ['Woj' => $provinceId]);
 214 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaTerytorialna') as $p) {
 215 |             $answer[] = new JednostkaTerytorialna($p);
 216 |         }
 217 | 
 218 |         return $answer;
 219 |     }
 220 | 
 221 |     /**
 222 |      * Identyfikatory i nazwy jednostek nomenklatury z wybranego stanu katalogu
 223 |      *
 224 |      * @throws \RuntimeException
 225 |      * @throws \LogicException
 226 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 227 |      * @throws \mrcnpdlk\Teryt\Exception
 228 |      *
 229 |      * @return \SplFileObject
 230 |      */
 231 |     public function PobierzKatalogNTS(): SplFileObject
 232 |     {
 233 |         $res     = $this->oConfig->request('PobierzKatalogNTS');
 234 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 235 |         $content = base64_decode($res->plik_zawartosc);
 236 | 
 237 |         return Helper::saveFile($sPath, $content);
 238 |     }
 239 | 
 240 |     /**
 241 |      * Dane o miejscowościach z systemu identyfikatorów SIMC z wybranego stanu katalogu w wersji adresowej
 242 |      *
 243 |      * @throws \RuntimeException
 244 |      * @throws \LogicException
 245 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 246 |      * @throws \mrcnpdlk\Teryt\Exception
 247 |      *
 248 |      * @return \SplFileObject
 249 |      */
 250 |     public function PobierzKatalogSIMC(): SplFileObject
 251 |     {
 252 |         $res     = $this->oConfig->request('PobierzKatalogSIMC');
 253 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 254 |         $content = base64_decode($res->plik_zawartosc);
 255 | 
 256 |         return Helper::saveFile($sPath, $content);
 257 |     }
 258 | 
 259 |     /**
 260 |      * Dane o miejscowościach z systemu identyfikatorów SIMC z wybranego stanu katalogu w wersji adresowej
 261 |      *
 262 |      * @throws \RuntimeException
 263 |      * @throws \LogicException
 264 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 265 |      * @throws \mrcnpdlk\Teryt\Exception
 266 |      *
 267 |      * @return \SplFileObject
 268 |      */
 269 |     public function PobierzKatalogSIMCAdr(): SplFileObject
 270 |     {
 271 |         $res     = $this->oConfig->request('PobierzKatalogSIMCAdr');
 272 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 273 |         $content = base64_decode($res->plik_zawartosc);
 274 | 
 275 |         return Helper::saveFile($sPath, $content);
 276 |     }
 277 | 
 278 |     /**
 279 |      * Dane o miejscowościach z systemu identyfikatorów SIMC z wybranego stanu katalogu w wersji adresowej
 280 |      *
 281 |      * @throws \RuntimeException
 282 |      * @throws \LogicException
 283 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 284 |      * @throws \mrcnpdlk\Teryt\Exception
 285 |      *
 286 |      * @return \SplFileObject
 287 |      */
 288 |     public function PobierzKatalogSIMCStat(): SplFileObject
 289 |     {
 290 |         $res     = $this->oConfig->request('PobierzKatalogSIMCStat');
 291 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 292 |         $content = base64_decode($res->plik_zawartosc);
 293 | 
 294 |         return Helper::saveFile($sPath, $content);
 295 |     }
 296 | 
 297 |     /**
 298 |      * Dane z systemu identyfikatorów TERC z wybranego stanu katalogu w wersji urzędowej
 299 |      *
 300 |      * @throws \RuntimeException
 301 |      * @throws \LogicException
 302 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 303 |      * @throws \mrcnpdlk\Teryt\Exception
 304 |      *
 305 |      * @return \SplFileObject
 306 |      */
 307 |     public function PobierzKatalogTERC(): SplFileObject
 308 |     {
 309 |         $res     = $this->oConfig->request('PobierzKatalogTERC');
 310 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 311 |         $content = base64_decode($res->plik_zawartosc);
 312 | 
 313 |         return Helper::saveFile($sPath, $content);
 314 |     }
 315 | 
 316 |     /**
 317 |      * Dane z systemu identyfikatorów TERC z wybranego stanu katalogu w wersji adresowej
 318 |      *
 319 |      * @throws \RuntimeException
 320 |      * @throws \LogicException
 321 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 322 |      * @throws \mrcnpdlk\Teryt\Exception
 323 |      *
 324 |      * @return \SplFileObject
 325 |      */
 326 |     public function PobierzKatalogTERCAdr(): SplFileObject
 327 |     {
 328 |         $res     = $this->oConfig->request('PobierzKatalogTERCAdr');
 329 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 330 |         $content = base64_decode($res->plik_zawartosc);
 331 | 
 332 |         return Helper::saveFile($sPath, $content);
 333 |     }
 334 | 
 335 |     /**
 336 |      * Katalog ulic dla wskazanego stanu w wersji urzędowej
 337 |      *
 338 |      * @throws \RuntimeException
 339 |      * @throws \LogicException
 340 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 341 |      * @throws \mrcnpdlk\Teryt\Exception
 342 |      *
 343 |      * @return \SplFileObject
 344 |      */
 345 |     public function PobierzKatalogULIC(): SplFileObject
 346 |     {
 347 |         $res     = $this->oConfig->request('PobierzKatalogULIC');
 348 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 349 |         $content = base64_decode($res->plik_zawartosc);
 350 | 
 351 |         return Helper::saveFile($sPath, $content);
 352 |     }
 353 | 
 354 |     /**
 355 |      * Katalog ulic dla wskazanego stanu w wersji adresowej
 356 |      *
 357 |      * @throws \RuntimeException
 358 |      * @throws \LogicException
 359 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 360 |      * @throws \mrcnpdlk\Teryt\Exception
 361 |      *
 362 |      * @return \SplFileObject
 363 |      */
 364 |     public function PobierzKatalogULICAdr(): SplFileObject
 365 |     {
 366 |         $res     = $this->oConfig->request('PobierzKatalogULICAdr');
 367 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 368 |         $content = base64_decode($res->plik_zawartosc);
 369 | 
 370 |         return Helper::saveFile($sPath, $content);
 371 |     }
 372 | 
 373 |     /**
 374 |      * Katalog ulic dla wskazanego stanu w wersji urzędowej zmodyfikowany dla miast posiadający delegatury
 375 |      *
 376 |      * @throws \RuntimeException
 377 |      * @throws \LogicException
 378 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 379 |      * @throws \mrcnpdlk\Teryt\Exception
 380 |      *
 381 |      * @return \SplFileObject
 382 |      */
 383 |     public function PobierzKatalogULICBezDzielnic(): SplFileObject
 384 |     {
 385 |         $res     = $this->oConfig->request('PobierzKatalogULICBezDzielnic');
 386 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 387 |         $content = base64_decode($res->plik_zawartosc);
 388 | 
 389 |         return Helper::saveFile($sPath, $content);
 390 |     }
 391 | 
 392 |     /**
 393 |      * Katalog rodzajów miejscowości dla wskazanego stanu
 394 |      *
 395 |      * @throws \RuntimeException
 396 |      * @throws \LogicException
 397 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 398 |      * @throws \mrcnpdlk\Teryt\Exception
 399 |      *
 400 |      * @return \SplFileObject
 401 |      */
 402 |     public function PobierzKatalogWMRODZ(): SplFileObject
 403 |     {
 404 |         $res     = $this->oConfig->request('PobierzKatalogWMRODZ');
 405 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 406 |         $content = base64_decode($res->plik_zawartosc);
 407 | 
 408 |         return Helper::saveFile($sPath, $content);
 409 |     }
 410 | 
 411 |     /**
 412 |      * Lista gmin we wskazanym powiecie
 413 |      *
 414 |      * @param string $provinceId
 415 |      * @param string $districtId
 416 |      *
 417 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 418 |      * @throws \mrcnpdlk\Teryt\Exception
 419 |      *
 420 |      * @return JednostkaTerytorialna[]
 421 |      */
 422 |     public function PobierzListeGmin(string $provinceId, string $districtId): array
 423 |     {
 424 |         $answer = [];
 425 |         $res    = $this->oConfig->request('PobierzListeGmin', ['Woj' => $provinceId, 'Pow' => $districtId]);
 426 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaTerytorialna') as $p) {
 427 |             $answer[] = new JednostkaTerytorialna($p);
 428 |         }
 429 | 
 430 |         return $answer;
 431 |     }
 432 | 
 433 |     /**
 434 |      * Lista gmin w powiecie
 435 |      *
 436 |      * @param string $districtId  dwuznakowy symbol powiatu
 437 |      * @param string $subregionId dwuznakowy symbol podregionu
 438 |      *
 439 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 440 |      * @throws \mrcnpdlk\Teryt\Exception
 441 |      *
 442 |      * @return JednostkaNomenklaturyNTS[]
 443 |      */
 444 |     public function PobierzListeGminPowiecie(string $districtId, string $subregionId): array
 445 |     {
 446 |         $answer = [];
 447 |         $res    = $this->oConfig->request('PobierzListeGminPowiecie', ['Pow' => $districtId, 'Podreg' => $subregionId]);
 448 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaNomenklaturyNTS') as $p) {
 449 |             $answer[] = new JednostkaNomenklaturyNTS($p);
 450 |         }
 451 | 
 452 |         return $answer;
 453 |     }
 454 | 
 455 |     /**
 456 |      * Lista miejscowości znajdujących się we wskazanej gminie.
 457 |      * Wyszukiwanie odbywa się z uwzględnieniem nazw
 458 |      *
 459 |      * @param string $provinceName
 460 |      * @param string $districtName
 461 |      * @param string $communeName
 462 |      *
 463 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 464 |      * @throws \mrcnpdlk\Teryt\Exception
 465 |      *
 466 |      * @return Miejscowosc[]
 467 |      */
 468 |     public function PobierzListeMiejscowosciWGminie(string $provinceName, string $districtName, string $communeName): array
 469 |     {
 470 |         $answer = [];
 471 |         $res    = $this->oConfig->request('PobierzListeMiejscowosciWGminie',
 472 |             [
 473 |                 'Wojewodztwo' => $provinceName,
 474 |                 'Powiat'      => $districtName,
 475 |                 'Gmina'       => $communeName,
 476 |             ]);
 477 |         foreach (Helper::getPropertyAsArray($res, 'Miejscowosc') as $p) {
 478 |             $answer[] = new Miejscowosc($p);
 479 |         }
 480 | 
 481 |         return $answer;
 482 |     }
 483 | 
 484 |     /**
 485 |      * Lista miejscowości znajdujących się we wskazanej gminie.
 486 |      * Wyszukiwanie odbywa się z uwzględnieniem symboli
 487 |      *
 488 |      * @param int $tercId
 489 |      *
 490 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 491 |      * @throws \mrcnpdlk\Teryt\Exception
 492 |      *
 493 |      * @return Miejscowosc[]
 494 |      */
 495 |     public function PobierzListeMiejscowosciWRodzajuGminy(int $tercId): array
 496 |     {
 497 |         $answer = [];
 498 |         $oTerc  = new Terc($tercId);
 499 |         $res    = $this->oConfig->request('PobierzListeMiejscowosciWRodzajuGminy',
 500 |             [
 501 |                 'symbolWoj'  => $oTerc->getProvinceId(),
 502 |                 'symbolPow'  => $oTerc->getDistrictId(),
 503 |                 'symbolGmi'  => $oTerc->getCommuneId(),
 504 |                 'symbolRodz' => $oTerc->getCommuneTypeId(),
 505 |             ]);
 506 |         foreach (Helper::getPropertyAsArray($res, 'Miejscowosc') as $p) {
 507 |             $answer[] = new Miejscowosc($p);
 508 |         }
 509 | 
 510 |         return $answer;
 511 |     }
 512 | 
 513 |     /**
 514 |      * Lista podregionów w województwie
 515 |      *
 516 |      * @param string $provinceId Dwuznakowy symbol województwa
 517 |      *
 518 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 519 |      * @throws \mrcnpdlk\Teryt\Exception
 520 |      *
 521 |      * @return JednostkaNomenklaturyNTS[]
 522 |      */
 523 |     public function PobierzListePodregionow(string $provinceId): array
 524 |     {
 525 |         $answer = [];
 526 |         $res    = $this->oConfig->request('PobierzListePodregionow', ['Woj' => $provinceId]);
 527 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaNomenklaturyNTS') as $p) {
 528 |             $answer[] = new JednostkaNomenklaturyNTS($p);
 529 |         }
 530 | 
 531 |         return $answer;
 532 |     }
 533 | 
 534 |     /**
 535 |      * Pobieranie listy powiatów dla danego województwa
 536 |      *
 537 |      * @param string $provinceId
 538 |      *
 539 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 540 |      * @throws \mrcnpdlk\Teryt\Exception
 541 |      *
 542 |      * @return JednostkaTerytorialna[]
 543 |      */
 544 |     public function PobierzListePowiatow(string $provinceId): array
 545 |     {
 546 |         $answer = [];
 547 |         $res    = $this->oConfig->request('PobierzListePowiatow', ['Woj' => $provinceId]);
 548 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaTerytorialna') as $p) {
 549 |             $answer[] = new JednostkaTerytorialna($p);
 550 |         }
 551 | 
 552 |         return $answer;
 553 |     }
 554 | 
 555 |     /**
 556 |      * Lista powiatów w podregionie
 557 |      *
 558 |      * @param string $subregionId Dwuznakowy symbol podregionu
 559 |      *
 560 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 561 |      * @throws \mrcnpdlk\Teryt\Exception
 562 |      *
 563 |      * @return JednostkaNomenklaturyNTS[]
 564 |      */
 565 |     public function PobierzListePowiatowWPodregionie(string $subregionId): array
 566 |     {
 567 |         $answer = [];
 568 |         $res    = $this->oConfig->request('PobierzListePowiatowWPodregionie', ['Podreg' => $subregionId]);
 569 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaNomenklaturyNTS') as $p) {
 570 |             $answer[] = new JednostkaNomenklaturyNTS($p);
 571 |         }
 572 | 
 573 |         return $answer;
 574 |     }
 575 | 
 576 |     /**
 577 |      * Lista regionów
 578 |      *
 579 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 580 |      * @throws \mrcnpdlk\Teryt\Exception
 581 |      *
 582 |      * @return JednostkaNomenklaturyNTS[]
 583 |      */
 584 |     public function PobierzListeRegionow(): array
 585 |     {
 586 |         $answer = [];
 587 |         $res    = $this->oConfig->request('PobierzListeRegionow');
 588 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaNomenklaturyNTS') as $p) {
 589 |             $answer[] = new JednostkaNomenklaturyNTS($p);
 590 |         }
 591 | 
 592 |         return $answer;
 593 |     }
 594 | 
 595 |     /**
 596 |      * Lista ulic we wskazanej miejscowości
 597 |      *
 598 |      * @param int    $tercId
 599 |      * @param string $cityId
 600 |      * @param bool   $asAddress
 601 |      *
 602 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 603 |      * @throws \mrcnpdlk\Teryt\Exception
 604 |      *
 605 |      * @return UlicaDrzewo[]
 606 |      */
 607 |     public function PobierzListeUlicDlaMiejscowosci(int $tercId, string $cityId, bool $asAddress = false): array
 608 |     {
 609 |         $answer = [];
 610 |         $oTerc  = new Terc($tercId);
 611 |         $res    = $this->oConfig->request('PobierzListeUlicDlaMiejscowosci',
 612 |             [
 613 |                 'woj'               => $oTerc->getProvinceId(),
 614 |                 'pow'               => $oTerc->getDistrictId(),
 615 |                 'gmi'               => $oTerc->getCommuneId(),
 616 |                 'rodzaj'            => $oTerc->getCommuneTypeId(),
 617 |                 'msc'               => $cityId,
 618 |                 'czyWersjaUrzedowa' => !$asAddress,
 619 |                 'czyWersjaAdresowa' => $asAddress,
 620 |             ]
 621 |         );
 622 |         foreach (Helper::getPropertyAsArray($res, 'UlicaDrzewo') as $p) {
 623 |             $answer[] = new UlicaDrzewo($p);
 624 |         }
 625 | 
 626 |         return $answer;
 627 |     }
 628 | 
 629 |     /**
 630 |      * Lista województw
 631 |      *
 632 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 633 |      * @throws \mrcnpdlk\Teryt\Exception
 634 |      *
 635 |      * @return JednostkaTerytorialna[]
 636 |      */
 637 |     public function PobierzListeWojewodztw(): array
 638 |     {
 639 |         $answer = [];
 640 |         $res    = $this->oConfig->request('PobierzListeWojewodztw');
 641 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaTerytorialna') as $p) {
 642 |             $answer[] = new JednostkaTerytorialna($p);
 643 |         }
 644 | 
 645 |         return $answer;
 646 |     }
 647 | 
 648 |     /**
 649 |      * Lista województw regionie
 650 |      *
 651 |      * @param string $regionId Jednoznakowy symbol regionu
 652 |      *
 653 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 654 |      * @throws \mrcnpdlk\Teryt\Exception
 655 |      *
 656 |      * @return JednostkaNomenklaturyNTS[]
 657 |      */
 658 |     public function PobierzListeWojewodztwWRegionie(string $regionId): array
 659 |     {
 660 |         $answer = [];
 661 |         $res    = $this->oConfig->request('PobierzListeWojewodztwWRegionie', ['Reg' => $regionId]);
 662 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaNomenklaturyNTS') as $p) {
 663 |             $answer[] = new JednostkaNomenklaturyNTS($p);
 664 |         }
 665 | 
 666 |         return $answer;
 667 |     }
 668 | 
 669 |     /**
 670 |      * Zwraca listę cech obiektów z katalogu ulic
 671 |      *
 672 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 673 |      * @throws \mrcnpdlk\Teryt\Exception
 674 |      *
 675 |      * @return string[]
 676 |      */
 677 |     public function PobierzSlownikCechULIC(): array
 678 |     {
 679 |         $res = $this->oConfig->request('PobierzSlownikCechULIC');
 680 | 
 681 |         return Helper::getPropertyAsArray($res, 'string');
 682 |     }
 683 | 
 684 |     /**
 685 |      * Zwraca listę rodzajów jednostek
 686 |      *
 687 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 688 |      * @throws \mrcnpdlk\Teryt\Exception
 689 |      *
 690 |      * @return string[]
 691 |      */
 692 |     public function PobierzSlownikRodzajowJednostek(): array
 693 |     {
 694 |         $res = $this->oConfig->request('PobierzSlownikRodzajowJednostek');
 695 | 
 696 |         return Helper::getPropertyAsArray($res, 'string');
 697 |     }
 698 | 
 699 |     /**
 700 |      * Zwraca listę rodzajów miejscowości
 701 |      *
 702 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 703 |      * @throws \mrcnpdlk\Teryt\Exception
 704 |      *
 705 |      * @return RodzajMiejscowosci[]
 706 |      */
 707 |     public function PobierzSlownikRodzajowSIMC(): array
 708 |     {
 709 |         $answer = [];
 710 |         $res    = $this->oConfig->request('PobierzSlownikRodzajowSIMC');
 711 |         foreach (Helper::getPropertyAsArray($res, 'RodzajMiejscowosci') as $p) {
 712 |             $answer[] = new RodzajMiejscowosci($p);
 713 |         }
 714 | 
 715 |         return $answer;
 716 |     }
 717 | 
 718 |     /**
 719 |      * Zmiany w katalogu TERC w wersji adresowej rejestru
 720 |      *
 721 |      * @param \DateTime      $fromDate
 722 |      * @param \DateTime|null $toDate
 723 |      *
 724 |      * @throws \RuntimeException
 725 |      * @throws \LogicException
 726 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 727 |      * @throws \mrcnpdlk\Teryt\Exception
 728 |      *
 729 |      * @return \SplFileObject
 730 |      */
 731 |     public function PobierzZmianyNTS(DateTime $fromDate, DateTime $toDate = null): SplFileObject
 732 |     {
 733 |         $toDate  = $toDate ?? new DateTime();
 734 |         $res     = $this->oConfig->request(
 735 |             'PobierzZmianyNTS',
 736 |             [
 737 |                 'stanod' => $fromDate->format('Y-m-d'),
 738 |                 'stando' => $toDate->format('Y-m-d'),
 739 |             ],
 740 |             false);
 741 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 742 |         $content = base64_decode($res->plik_zawartosc);
 743 | 
 744 |         return Helper::saveFile($sPath, $content);
 745 |     }
 746 | 
 747 |     /**
 748 |      * Zmiany w katalogu SIMC w wersji adresowej rejestru
 749 |      *
 750 |      * @param \DateTime      $fromDate
 751 |      * @param \DateTime|null $toDate
 752 |      *
 753 |      * @throws \RuntimeException
 754 |      * @throws \LogicException
 755 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 756 |      * @throws \mrcnpdlk\Teryt\Exception
 757 |      *
 758 |      * @return \SplFileObject
 759 |      */
 760 |     public function PobierzZmianySimcAdresowy(DateTime $fromDate, DateTime $toDate = null): SplFileObject
 761 |     {
 762 |         $toDate  = $toDate ?? new DateTime();
 763 |         $res     = $this->oConfig->request(
 764 |             'PobierzZmianySimcAdresowy',
 765 |             [
 766 |                 'stanod' => $fromDate->format('Y-m-d'),
 767 |                 'stando' => $toDate->format('Y-m-d'),
 768 |             ],
 769 |             false);
 770 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 771 |         $content = base64_decode($res->plik_zawartosc);
 772 | 
 773 |         return Helper::saveFile($sPath, $content);
 774 |     }
 775 | 
 776 |     /**
 777 |      * Zmiany w katalogu SIMC w wersji statystycznej rejestru
 778 |      *
 779 |      * @param \DateTime      $fromDate
 780 |      * @param \DateTime|null $toDate
 781 |      *
 782 |      * @throws \RuntimeException
 783 |      * @throws \LogicException
 784 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 785 |      * @throws \mrcnpdlk\Teryt\Exception
 786 |      *
 787 |      * @return \SplFileObject
 788 |      */
 789 |     public function PobierzZmianySimcStatystyczny(DateTime $fromDate, DateTime $toDate = null): SplFileObject
 790 |     {
 791 |         $toDate  = $toDate ?? new DateTime();
 792 |         $res     = $this->oConfig->request(
 793 |             'PobierzZmianySimcStatystyczny',
 794 |             [
 795 |                 'stanod' => $fromDate->format('Y-m-d'),
 796 |                 'stando' => $toDate->format('Y-m-d'),
 797 |             ],
 798 |             false);
 799 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 800 |         $content = base64_decode($res->plik_zawartosc);
 801 | 
 802 |         return Helper::saveFile($sPath, $content);
 803 |     }
 804 | 
 805 |     /**
 806 |      * Zmiany w katalogu SIMC w wersji urzędowej rejestru
 807 |      *
 808 |      * @param \DateTime      $fromDate
 809 |      * @param \DateTime|null $toDate
 810 |      *
 811 |      * @throws \RuntimeException
 812 |      * @throws \LogicException
 813 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 814 |      * @throws \mrcnpdlk\Teryt\Exception
 815 |      *
 816 |      * @return \SplFileObject
 817 |      */
 818 |     public function PobierzZmianySimcUrzedowy(DateTime $fromDate, DateTime $toDate = null): SplFileObject
 819 |     {
 820 |         $toDate  = $toDate ?? new DateTime();
 821 |         $res     = $this->oConfig->request(
 822 |             'PobierzZmianySimcUrzedowy',
 823 |             [
 824 |                 'stanod' => $fromDate->format('Y-m-d'),
 825 |                 'stando' => $toDate->format('Y-m-d'),
 826 |             ],
 827 |             false);
 828 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 829 |         $content = base64_decode($res->plik_zawartosc);
 830 | 
 831 |         return Helper::saveFile($sPath, $content);
 832 |     }
 833 | 
 834 |     /**
 835 |      * Zmiany w katalogu TERC w wersji adresowej rejestru
 836 |      *
 837 |      * @param \DateTime      $fromDate
 838 |      * @param \DateTime|null $toDate
 839 |      *
 840 |      * @throws \RuntimeException
 841 |      * @throws \LogicException
 842 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 843 |      * @throws \mrcnpdlk\Teryt\Exception
 844 |      *
 845 |      * @return \SplFileObject
 846 |      */
 847 |     public function PobierzZmianyTercAdresowy(DateTime $fromDate, DateTime $toDate = null): SplFileObject
 848 |     {
 849 |         $toDate  = $toDate ?? new DateTime();
 850 |         $res     = $this->oConfig->request(
 851 |             'PobierzZmianyTercAdresowy',
 852 |             [
 853 |                 'stanod' => $fromDate->format('Y-m-d'),
 854 |                 'stando' => $toDate->format('Y-m-d'),
 855 |             ],
 856 |             false);
 857 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 858 |         $content = base64_decode($res->plik_zawartosc);
 859 | 
 860 |         return Helper::saveFile($sPath, $content);
 861 |     }
 862 | 
 863 |     /**
 864 |      * Zmiany w katalogu TERC w wersji urzędowej rejestru
 865 |      *
 866 |      * @param \DateTime      $fromDate
 867 |      * @param \DateTime|null $toDate
 868 |      *
 869 |      * @throws \RuntimeException
 870 |      * @throws \LogicException
 871 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 872 |      * @throws \mrcnpdlk\Teryt\Exception
 873 |      *
 874 |      * @return \SplFileObject
 875 |      */
 876 |     public function PobierzZmianyTercUrzedowy(DateTime $fromDate, DateTime $toDate = null): SplFileObject
 877 |     {
 878 |         $toDate  = $toDate ?? new DateTime();
 879 |         $res     = $this->oConfig->request(
 880 |             'PobierzZmianyTercUrzedowy',
 881 |             [
 882 |                 'stanod' => $fromDate->format('Y-m-d'),
 883 |                 'stando' => $toDate->format('Y-m-d'),
 884 |             ],
 885 |             false);
 886 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 887 |         $content = base64_decode($res->plik_zawartosc);
 888 | 
 889 |         return Helper::saveFile($sPath, $content);
 890 |     }
 891 | 
 892 |     /**
 893 |      * Zmiany w katalogu ULIC w wersji adresowej rejestru
 894 |      *
 895 |      * @param \DateTime      $fromDate
 896 |      * @param \DateTime|null $toDate
 897 |      *
 898 |      * @throws \RuntimeException
 899 |      * @throws \LogicException
 900 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 901 |      * @throws \mrcnpdlk\Teryt\Exception
 902 |      *
 903 |      * @return \SplFileObject
 904 |      */
 905 |     public function PobierzZmianyUlicAdresowy(DateTime $fromDate, DateTime $toDate = null): SplFileObject
 906 |     {
 907 |         $toDate  = $toDate ?? new DateTime();
 908 |         $res     = $this->oConfig->request(
 909 |             'PobierzZmianyUlicAdresowy',
 910 |             [
 911 |                 'stanod' => $fromDate->format('Y-m-d'),
 912 |                 'stando' => $toDate->format('Y-m-d'),
 913 |             ],
 914 |             false);
 915 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 916 |         $content = base64_decode($res->plik_zawartosc);
 917 | 
 918 |         return Helper::saveFile($sPath, $content);
 919 |     }
 920 | 
 921 |     /**
 922 |      * Zmiany w katalogu ULIC w wersji urzędowej rejestru
 923 |      *
 924 |      * @param \DateTime      $fromDate
 925 |      * @param \DateTime|null $toDate
 926 |      *
 927 |      * @throws \RuntimeException
 928 |      * @throws \LogicException
 929 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 930 |      * @throws \mrcnpdlk\Teryt\Exception
 931 |      *
 932 |      * @return \SplFileObject
 933 |      */
 934 |     public function PobierzZmianyUlicUrzedowy(DateTime $fromDate, DateTime $toDate = null): SplFileObject
 935 |     {
 936 |         $toDate  = $toDate ?? new DateTime();
 937 |         $res     = $this->oConfig->request(
 938 |             'PobierzZmianyUlicUrzedowy',
 939 |             [
 940 |                 'stanod' => $fromDate->format('Y-m-d'),
 941 |                 'stando' => $toDate->format('Y-m-d'),
 942 |             ],
 943 |             false);
 944 |         $sPath   = sprintf('%s/%s.zip', sys_get_temp_dir(), $res->nazwa_pliku);
 945 |         $content = base64_decode($res->plik_zawartosc);
 946 | 
 947 |         return Helper::saveFile($sPath, $content);
 948 |     }
 949 | 
 950 |     /**
 951 |      * Weryfikuje istnienie wskazanego obiektu w bazie TERYT do poziomu
 952 |      * miejscowości. Weryfikacja odbywa się za pomoca identyfikatorów
 953 |      *
 954 |      * @param string $cityId
 955 |      *
 956 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 957 |      * @throws \mrcnpdlk\Teryt\Exception\NotFound
 958 |      * @throws \mrcnpdlk\Teryt\Exception
 959 |      *
 960 |      * @return ZweryfikowanyAdresBezUlic
 961 |      */
 962 |     public function WeryfikujAdresDlaMiejscowosci(string $cityId): ZweryfikowanyAdresBezUlic
 963 |     {
 964 |         $res   = $this->oConfig->request('WeryfikujAdresDlaMiejscowosci', ['symbolMsc' => $cityId]);
 965 |         $oData = Helper::getPropertyAsObject($res, 'ZweryfikowanyAdresBezUlic');
 966 | 
 967 |         return new ZweryfikowanyAdresBezUlic($oData);
 968 |     }
 969 | 
 970 |     /**
 971 |      * Weryfikuje istnienie wskazanego obiektu w bazie TERYT,w wersji
 972 |      * adresowej rejestru do poziomu miejscowości. Weryfikacja odbywa się za pomoca identyfikatorów
 973 |      *
 974 |      * @param string $cityId
 975 |      *
 976 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 977 |      * @throws \mrcnpdlk\Teryt\Exception\NotFound
 978 |      * @throws \mrcnpdlk\Teryt\Exception
 979 |      *
 980 |      * @return ZweryfikowanyAdresBezUlic
 981 |      */
 982 |     public function WeryfikujAdresDlaMiejscowosciAdresowy(string $cityId): ZweryfikowanyAdresBezUlic
 983 |     {
 984 |         $res   = $this->oConfig->request('WeryfikujAdresDlaMiejscowosciAdresowy', ['symbolMsc' => $cityId]);
 985 |         $oData = Helper::getPropertyAsObject($res, 'ZweryfikowanyAdresBezUlic');
 986 | 
 987 |         return new ZweryfikowanyAdresBezUlic($oData);
 988 |     }
 989 | 
 990 |     /**
 991 |      * Weryfikuje istnienie wskazanego obiektu w bazie
 992 |      * TERYT do poziomu ulic.Weryfikacja odbywa się za pomoca nazw
 993 |      *
 994 |      * @param string $cityId
 995 |      * @param string $streetId
 996 |      *
 997 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
 998 |      * @throws \mrcnpdlk\Teryt\Exception\NotFound
 999 |      * @throws \mrcnpdlk\Teryt\Exception
1000 |      *
1001 |      * @return ZweryfikowanyAdres
1002 |      */
1003 |     public function WeryfikujAdresDlaUlic(string $cityId, string $streetId): ZweryfikowanyAdres
1004 |     {
1005 |         $res   = $this->oConfig->request('WeryfikujAdresDlaUlic', ['symbolMsc' => $cityId, 'SymUl' => $streetId]);
1006 |         $oData = Helper::getPropertyAsObject($res, 'ZweryfikowanyAdres');
1007 | 
1008 |         return new ZweryfikowanyAdres($oData);
1009 |     }
1010 | 
1011 |     /**
1012 |      * Weryfikuje istnienie wskazanego obiektu w bazie
1013 |      * TERYT do poziomu ulic w wersji adresowej. Weryfikacja odbywa się za pomoca nazw
1014 |      *
1015 |      * @param string $cityId
1016 |      * @param string $streetId
1017 |      *
1018 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1019 |      * @throws \mrcnpdlk\Teryt\Exception\NotFound
1020 |      * @throws \mrcnpdlk\Teryt\Exception
1021 |      *
1022 |      * @return ZweryfikowanyAdres
1023 |      */
1024 |     public function WeryfikujAdresDlaUlicAdresowy(string $cityId, string $streetId): ZweryfikowanyAdres
1025 |     {
1026 |         $res   = $this->oConfig->request('WeryfikujAdresDlaUlicAdresowy', ['symbolMsc' => $cityId, 'SymUl' => $streetId]);
1027 |         $oData = Helper::getPropertyAsObject($res, 'ZweryfikowanyAdres');
1028 | 
1029 |         return new ZweryfikowanyAdres($oData);
1030 |     }
1031 | 
1032 |     /**
1033 |      * Weryfikuje istnienie wskazanego obiektu w bazie TERYT do poziomu
1034 |      * miejscowości. Weryfikacja odbywa się za pomoca nazw
1035 |      *
1036 |      * Nazwa miejscowości nie musibyć pełna - nastąpi wtedy wyszkiwanie pełnokontekstowe
1037 |      * w wtórym zostanie zwrócona tablica wyników
1038 |      *
1039 |      * @param string      $provinceName Nazwa województwa
1040 |      * @param string      $districtName Nazwa powiatu
1041 |      * @param string      $communeName  Nazwa gminy
1042 |      * @param string      $cityName     Nazwa miejscowości
1043 |      * @param string|null $cityTypeName Nazwa typu miejscowości
1044 |      *
1045 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1046 |      * @throws \mrcnpdlk\Teryt\Exception
1047 |      *
1048 |      * @return ZweryfikowanyAdresBezUlic[]
1049 |      */
1050 |     public function WeryfikujAdresWmiejscowosci(
1051 |         string $provinceName,
1052 |         string $districtName,
1053 |         string $communeName,
1054 |         string $cityName,
1055 |         string $cityTypeName = null
1056 |     ): array {
1057 |         $answer = [];
1058 |         $res    = $this->oConfig->request('WeryfikujAdresWmiejscowosci',
1059 |             [
1060 |                 'Wojewodztwo' => $provinceName,
1061 |                 'Powiat'      => $districtName,
1062 |                 'Gmina'       => $communeName,
1063 |                 'Miejscowosc' => $cityName,
1064 |                 'Rodzaj'      => $cityTypeName,
1065 |             ]);
1066 |         foreach (Helper::getPropertyAsArray($res, 'ZweryfikowanyAdresBezUlic') as $p) {
1067 |             $answer[] = new ZweryfikowanyAdresBezUlic($p);
1068 |         }
1069 | 
1070 |         return $answer;
1071 |     }
1072 | 
1073 |     /**
1074 |      * Weryfikuje istnienie wskazanego obiektu w bazie TERYT w wersji adresowej do poziomu
1075 |      * miejscowości. Weryfikacja odbywa się za pomoca nazw
1076 |      *
1077 |      * Nazwa miejscowości nie musibyć pełna - nastąpi wtedy wyszkiwanie pełnokontekstowe
1078 |      * w wtórym zostanie zwrócona tablica wyników
1079 |      *
1080 |      * @param string      $provinceName Nazwa województwa
1081 |      * @param string      $districtName Nazwa powiatu
1082 |      * @param string      $communeName  Nazwa gminy
1083 |      * @param string      $cityName     Nazwa miejscowości
1084 |      * @param string|null $cityTypeName Nazwa typu miejscowości
1085 |      *
1086 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1087 |      * @throws \mrcnpdlk\Teryt\Exception
1088 |      *
1089 |      * @return ZweryfikowanyAdresBezUlic[]
1090 |      */
1091 |     public function WeryfikujAdresWmiejscowosciAdresowy(
1092 |         string $provinceName,
1093 |         string $districtName,
1094 |         string $communeName,
1095 |         string $cityName,
1096 |         string $cityTypeName = null
1097 |     ): array {
1098 |         $answer = [];
1099 |         $res    = $this->oConfig->request('WeryfikujAdresWmiejscowosciAdresowy',
1100 |             [
1101 |                 'Wojewodztwo' => $provinceName,
1102 |                 'Powiat'      => $districtName,
1103 |                 'Gmina'       => $communeName,
1104 |                 'Miejscowosc' => $cityName,
1105 |                 'Rodzaj'      => $cityTypeName,
1106 |             ]);
1107 |         foreach (Helper::getPropertyAsArray($res, 'ZweryfikowanyAdresBezUlic') as $p) {
1108 |             $answer[] = new ZweryfikowanyAdresBezUlic($p);
1109 |         }
1110 | 
1111 |         return $answer;
1112 |     }
1113 | 
1114 |     /**
1115 |      * Weryfikuje istnienie wskazanego obiektu w bazie TERYT do poziomu ulic.
1116 |      * Weryfikacja odbywa się za pomoca nazw
1117 |      *
1118 |      * @param string      $provinceName
1119 |      * @param string      $districtName
1120 |      * @param string      $communeName
1121 |      * @param string      $cityName
1122 |      * @param string|null $cityTypeName
1123 |      * @param string      $streetName
1124 |      *
1125 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1126 |      * @throws \mrcnpdlk\Teryt\Exception
1127 |      *
1128 |      * @return ZweryfikowanyAdres[]
1129 |      *
1130 |      * @todo empty response
1131 |      */
1132 |     public function WeryfikujNazwaAdresUlic(
1133 |         string $provinceName,
1134 |         string $districtName,
1135 |         string $communeName,
1136 |         string $cityName,
1137 |         string $cityTypeName = null,
1138 |         string $streetName
1139 |     ): array {
1140 |         $answer = [];
1141 |         $res    = $this->oConfig->request('WeryfikujNazwaAdresUlic',
1142 |             [
1143 |                 'nazwaWoj'         => $provinceName,
1144 |                 'nazwaPow'         => $districtName,
1145 |                 'nazwaGmi'         => $communeName,
1146 |                 'nazwaMiejscowosc' => $cityName,
1147 |                 'rodzajMiejsc'     => $cityTypeName,
1148 |                 'nazwaUlicy'       => $streetName,
1149 |             ]);
1150 | 
1151 |         $tData = Helper::getPropertyAsArray($res, 'ZweryfikowanyAdres');
1152 | 
1153 |         foreach ($tData as $datum) {
1154 |             $answer[] = new ZweryfikowanyAdres($datum);
1155 |         }
1156 | 
1157 |         return $answer;
1158 |     }
1159 | 
1160 |     /**
1161 |      * Weryfikuje istnienie wskazanego obiektu w bazie TERYT do poziomu ulic w wersji adresowej rejestru.
1162 |      * Weryfikacja odbywa się za pomoca nazw
1163 |      *
1164 |      * @param string      $provinceName
1165 |      * @param string      $districtName
1166 |      * @param string      $communeName
1167 |      * @param string      $cityName
1168 |      * @param string|null $cityTypeName
1169 |      * @param string      $streetName
1170 |      *
1171 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1172 |      * @throws \mrcnpdlk\Teryt\Exception
1173 |      *
1174 |      * @return ZweryfikowanyAdres[]
1175 |      */
1176 |     public function WeryfikujNazwaAdresUlicAdresowy(
1177 |         string $provinceName,
1178 |         string $districtName,
1179 |         string $communeName,
1180 |         string $cityName,
1181 |         string $cityTypeName = null,
1182 |         string $streetName
1183 |     ): array {
1184 |         $answer = [];
1185 |         $res    = $this->oConfig->request('WeryfikujNazwaAdresUlicAdresowy',
1186 |             [
1187 |                 'nazwaWoj'         => $provinceName,
1188 |                 'nazwaPow'         => $districtName,
1189 |                 'nazwaGmi'         => $communeName,
1190 |                 'nazwaMiejscowosc' => $cityName,
1191 |                 'rodzajMiejsc'     => $cityTypeName,
1192 |                 'nazwaUlicy'       => $streetName,
1193 |             ]);
1194 | 
1195 |         $tData = Helper::getPropertyAsArray($res, 'ZweryfikowanyAdres');
1196 | 
1197 |         foreach ($tData as $datum) {
1198 |             $answer[] = new ZweryfikowanyAdres($datum);
1199 |         }
1200 | 
1201 |         return $answer;
1202 |     }
1203 | 
1204 |     /**
1205 |      * Zwraca listę znalezionych jednostek w katalagu TERC
1206 |      *
1207 |      * @param string $name
1208 |      *
1209 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1210 |      * @throws \mrcnpdlk\Teryt\Exception
1211 |      *
1212 |      * @return JednostkaPodzialuTerytorialnego[]
1213 |      *
1214 |      * @todo Metoda zwraca 0 wyników
1215 |      */
1216 |     public function WyszukajJPT(string $name): array
1217 |     {
1218 |         $answer = [];
1219 |         $res    = $this->oConfig->request('WyszukajJPT', ['nazwa' => $name], false);
1220 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaPodzialuTerytorialnego') as $p) {
1221 |             $answer[] = new JednostkaPodzialuTerytorialnego($p);
1222 |         }
1223 | 
1224 |         return $answer;
1225 |     }
1226 | 
1227 |     /**
1228 |      * Zwraca listę znalezionych jednostek w katalagu TERC
1229 |      *
1230 |      * @param string|null $name     zawiera nazwę wyszukiwanej jednostki
1231 |      * @param string|null $category określa kategorię wyszukiwanych jednostek
1232 |      * @param string[]    $tSimc    lista identyfikatorów SIMC (cityId)
1233 |      * @param string[]    $tTerc    lista identyfikatorów TERC (tercId)
1234 |      *
1235 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1236 |      * @throws \mrcnpdlk\Teryt\Exception
1237 |      *
1238 |      * @return JednostkaPodzialuTerytorialnego[]
1239 |      */
1240 |     public function WyszukajJednostkeWRejestrze(
1241 |         string $name = null,
1242 |         string $category = null,
1243 |         array $tSimc = [],
1244 |         array $tTerc = []
1245 |     ): array {
1246 |         $answer     = [];
1247 |         $identyfiks = [];
1248 |         foreach ($tSimc as $simc) {
1249 |             $identyfiks[] = ['simc' => $simc];
1250 |         }
1251 |         foreach ($tTerc as $terc) {
1252 |             $identyfiks[] = ['terc' => $terc];
1253 |         }
1254 |         $res = $this->oConfig->request('WyszukajJednostkeWRejestrze',
1255 |             [
1256 |                 'nazwa'      => $name,
1257 |                 'kategoria'  => $category ?? self::CATEGORY_ALL,
1258 |                 'identyfiks' => $identyfiks,
1259 |             ]);
1260 |         foreach (Helper::getPropertyAsArray($res, 'JednostkaPodzialuTerytorialnego') as $p) {
1261 |             $answer[] = new JednostkaPodzialuTerytorialnego($p);
1262 |         }
1263 | 
1264 |         return $answer;
1265 |     }
1266 | 
1267 |     /**
1268 |      * Zwaraca listę znalezionych miejscowości w katalogu SIMC.
1269 |      *
1270 |      * @param string|null $cityName
1271 |      * @param string|null $cityId
1272 |      *
1273 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1274 |      * @throws \mrcnpdlk\Teryt\Exception
1275 |      *
1276 |      * @return Miejscowosc[]
1277 |      */
1278 |     public function WyszukajMiejscowosc(string $cityName = null, string $cityId = null): array
1279 |     {
1280 |         $answer = [];
1281 |         $res    = $this->oConfig->request('WyszukajMiejscowosc',
1282 |             ['nazwaMiejscowosci' => $cityName, 'identyfikatorMiejscowosci' => $cityId]);
1283 |         foreach (Helper::getPropertyAsArray($res, 'Miejscowosc') as $p) {
1284 |             $answer[] = new Miejscowosc($p);
1285 |         }
1286 | 
1287 |         return $answer;
1288 |     }
1289 | 
1290 |     /**
1291 |      * Zwaraca listę znalezionych miejscowości we wskazanej
1292 |      * jednostce podziału terytorialnego
1293 |      *
1294 |      * @param string $provinceName
1295 |      * @param string $districtName
1296 |      * @param string $communeName
1297 |      * @param string $cityName
1298 |      * @param string $cityId
1299 |      *
1300 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1301 |      * @throws \mrcnpdlk\Teryt\Exception
1302 |      *
1303 |      * @return Miejscowosc[]
1304 |      */
1305 |     public function WyszukajMiejscowoscWJPT(
1306 |         string $provinceName,
1307 |         string $districtName,
1308 |         string $communeName,
1309 |         string $cityName,
1310 |         string $cityId = null
1311 |     ): array {
1312 |         $answer = [];
1313 |         /**
1314 |          * @var \stdClass|null
1315 |          */
1316 |         $res = $this->oConfig->request('WyszukajMiejscowoscWJPT',
1317 |             [
1318 |                 'nazwaWoj'                  => $provinceName,
1319 |                 'nazwaPow'                  => $districtName,
1320 |                 'nazwaGmi'                  => $communeName,
1321 |                 'nazwaMiejscowosci'         => $cityName,
1322 |                 'identyfikatorMiejscowosci' => $cityId,
1323 |             ]);
1324 |         foreach (Helper::getPropertyAsArray($res, 'Miejscowosc') as $p) {
1325 |             $answer[] = new Miejscowosc($p);
1326 |         }
1327 | 
1328 |         return $answer;
1329 |     }
1330 | 
1331 |     /**
1332 |      * Zwaraca listę znalezionych miejscowości we wskazanej jednostcepodziału terytorialnego
1333 |      *
1334 |      * @param string|null $name         Nazwa miejscowości
1335 |      * @param string|null $cityId       ID miejscowości
1336 |      * @param string[]    $tSimc        Lista cityId w których szukamy
1337 |      * @param string[]    $tTerc        Lista tercId w których szukamy
1338 |      * @param string      $cityTypeName Predefiniowany typ wyszukiwania ('000','001','002') stałe: SEARCH_CITY_TYPE_*
1339 |      *
1340 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1341 |      * @throws \mrcnpdlk\Teryt\Exception
1342 |      *
1343 |      * @return WyszukanaMiejscowosc[]
1344 |      */
1345 |     public function WyszukajMiejscowoscWRejestrze(
1346 |         string $name = null,
1347 |         string $cityId = null,
1348 |         array $tSimc = [],
1349 |         array $tTerc = [],
1350 |         string $cityTypeName = NativeApi::SEARCH_CITY_TYPE_ALL
1351 |     ): array {
1352 |         $answer     = [];
1353 |         $identyfiks = [];
1354 |         foreach ($tSimc as $simc) {
1355 |             $identyfiks[] = ['simc' => $simc];
1356 |         }
1357 |         foreach ($tTerc as $terc) {
1358 |             $identyfiks[] = ['terc' => $terc];
1359 |         }
1360 |         $res = $this->oConfig->request('WyszukajMiejscowoscWRejestrze',
1361 |             [
1362 |                 'nazwa'              => $name,
1363 |                 'rodzajMiejscowosci' => $cityTypeName,
1364 |                 'symbol'             => $cityId,
1365 |                 'identyfiks'         => $identyfiks,
1366 |             ]);
1367 |         foreach (Helper::getPropertyAsArray($res, 'WyszukanaMiejscowosc') as $p) {
1368 |             $answer[] = new WyszukanaMiejscowosc($p);
1369 |         }
1370 | 
1371 |         return $answer;
1372 |     }
1373 | 
1374 |     /**
1375 |      * Wyszukuje wskazaną ulicę w katalogu ULIC. Wyszukiwanie odbywa się za pomoca nazw
1376 |      *
1377 |      * @param string|null $streetName
1378 |      * @param string|null $streetIdentityName
1379 |      * @param string|null $cityName
1380 |      *
1381 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1382 |      * @throws \mrcnpdlk\Teryt\Exception
1383 |      *
1384 |      * @return Ulica[]
1385 |      */
1386 |     public function WyszukajUlice(string $streetName = null, string $streetIdentityName = null, string $cityName = null): array
1387 |     {
1388 |         $answer = [];
1389 |         $res    = $this->oConfig->request('WyszukajUlice',
1390 |             [
1391 |                 'nazwaulicy'        => $streetName,
1392 |                 'cecha'             => $streetIdentityName,
1393 |                 'nazwamiejscowosci' => $cityName,
1394 |             ]);
1395 |         foreach (Helper::getPropertyAsArray($res, 'Ulica') as $p) {
1396 |             $answer[] = new Ulica($p);
1397 |         }
1398 | 
1399 |         return $answer;
1400 |     }
1401 | 
1402 |     /**
1403 |      * Wyszukuje wskazaną ulicę w katalogu ULIC
1404 |      *
1405 |      * @param string|null       $name         Nazwa ulicy
1406 |      * @param string            $identityName Nazwa cechy, wymagane
1407 |      * @param string|null       $streetId     ID ulicy
1408 |      * @param array<string,int> $tSimc        Lista cityId w których szukamy
1409 |      * @param array<string,int> $tTerc        Lista tercId w których szukamy
1410 |      *
1411 |      * @throws \mrcnpdlk\Teryt\Exception\Connection
1412 |      * @throws \mrcnpdlk\Teryt\Exception
1413 |      *
1414 |      * @return WyszukanaUlica[]
1415 |      */
1416 |     public function WyszukajUliceWRejestrze(
1417 |         string $name = null,
1418 |         string $identityName = 'ul.',
1419 |         string $streetId = null,
1420 |         array $tSimc = [],
1421 |         array $tTerc = []
1422 |     ): array {
1423 |         $answer     = [];
1424 |         $identyfiks = [];
1425 |         foreach ($tSimc as $simc) {
1426 |             $identyfiks[] = ['simc' => $simc];
1427 |         }
1428 |         foreach ($tTerc as $terc) {
1429 |             $identyfiks[] = ['terc' => $terc];
1430 |         }
1431 |         $res = $this->oConfig->request('WyszukajUliceWRejestrze',
1432 |             [
1433 |                 'nazwa'         => $name,
1434 |                 'cecha'         => $identityName,
1435 |                 'identyfikator' => $streetId,
1436 |                 'identyfiks'    => $identyfiks,
1437 |             ]);
1438 |         foreach (Helper::getPropertyAsArray($res, 'WyszukanaUlica') as $p) {
1439 |             $answer[] = new WyszukanaUlica($p);
1440 |         }
1441 | 
1442 |         return $answer;
1443 |     }
1444 | }
1445 | 


--------------------------------------------------------------------------------