tomas-kulhanek/czech-data-box

PHP library for connection to Integrated system of data box (ISDS) in Czech republic

v5.0.0 2024-05-24 12:05 UTC

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

MIT

• Tomáš Kulhánek

• czech
• ISDS
• datovky

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í

• orgány veřejné moci - odkaz
• ostatní - odkaz

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í