tomas-kulhanek / czech-data-box
PHP library for connection to Integrated system of data box (ISDS) in Czech republic
Fund package maintenance!
tomas-kulhanek
vojmani
Installs: 3 220
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 2
Forks: 1
Open Issues: 3
Requires
- php: >=8.2
- ext-curl: *
- ext-dom: *
- ext-mbstring: *
- ext-openssl: *
- ext-xml: *
- symfony/validator: ^7.0
- tomas-kulhanek/serializer: ^2.0.3
Requires (Dev)
- guzzlehttp/guzzle: ^7.8
- nyholm/psr7: ^1.8
- php-http/httplug: ^2.4
- phpstan/phpstan: ^1.11
- phpunit/phpunit: ^10.5
- rector/rector: ^1.0
- squizlabs/php_codesniffer: ^3.9
- symfony/http-client: 5.4.*|6.*|7.*
Suggests
- ext-curl: for comunication with czech databox servers
- guzzlehttp/guzzle: for usage with guzzle
- symfony/http-client: for usage with symfony
README
⚠ POZOR!! Pokud implementujete napojení na ISDS, je potřeba aby jste se řídili dle PROVOZNÍHO ŘÁDU⚠
Instalace
Composer
Pro instalaci balíčku je nutné jej instalovat skrze composer.
composer require tomas-kulhanek/czech-data-box
Dále je potřeba využít nějakého klienta. Buď je možné využít Guzzle nebo Symfony Http client
composer require tomas-kulhanek/czech-data-box guzzlehttp/guzzle:^7.0
composer require tomas-kulhanek/czech-data-box symfony/http-client
V případě využívání vlastního http klienta, stačí implementovat rozhraní TomasKulhanek\CzechDataBox\Provider\ClientProviderInterface
a předat ho do konstruktoru třídy TomasKulhanek\CzechDataBox\Connector
. Samozřejmostí je třeba zajistit správné nastavení hlaviček nebo SSL klientských certifikátů.
Popis
Tato knihovna slouží k základní komunikaci s Informačním systémem datových scrhánek ISDS nebo ISDS test
Základní použití
Pro každou operaci je potřebné zadat přístupové údaje
<?php $account = new \TomasKulhanek\CzechDataBox\Account(); $account->setPassword('mojeTajneHeslo') ->setLoginName('mujLogin') ->setLoginType(\TomasKulhanek\CzechDataBox\Enum\LoginTypeEnum::NAME_PASSWORD) ->setProduction(false);
Využití s Symfony HTTP client
Instalace
composer require tomas-kulhanek/czech-data-box symfony/http-client
Instancování
$serializer = \TomasKulhanek\Serializer\SerializerFactory::create(); $guzzleProvider = \TomasKulhanek\CzechDataBox\Provider\SymfonyClientProvider::create(); $connector = new \TomasKulhanek\CzechDataBox\Connector($serializer, $guzzleProvider);
Využití s Guzzle 7
Instalace
composer require tomas-kulhanek/czech-data-box guzzlehttp/guzzle:^7.0
Instancování
$serializer = \TomasKulhanek\Serializer\SerializerFactory::create(); $guzzleProvider = \TomasKulhanek\CzechDataBox\Provider\GuzzleClientProvider::create(); $connector = new \TomasKulhanek\CzechDataBox\Connector($serializer, $guzzleProvider);
Pomoc a řešní chyb
V případě že potřebujete poradit, nebo při implementaci Vám třída zobrazuje chybu vytvořte prosím nové Issues. Základní pomoc je poskytována zcela zdarma pomocí Issues.
Odkazy
- Produkční ISDS - https://mojedatoveschranky.cz
- Testovací ISDS - https://czebox.cz
- Provozní řád ISDS - https://info.mojedatovaschranka.cz/info/cs/80.html
- Poradna - https://poradnaisds.cz/
Žádosti o zřízení datové schránky
Produkční prostředí
Testovací prostředí
Zřízení testovací schránky v prostředí czecbox.cz je možné skrze formulář na produkčním portalu www.mojedatoveschranky.cz po přihlášení v nastavení