zdenekgebauer / eet
EET client (www.etrzby.cz)
Installs: 14 109
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 4
Forks: 0
Open Issues: 0
Requires
- php: >=5.3.0
- ext-curl: *
- ext-openssl: *
- ext-soap: *
- robrichards/wse-php: 2.0.*
- robrichards/xmlseclibs: ^2.0
This package is auto-updated.
Last update: 2024-10-27 04:18:11 UTC
README
#PHP klient pro EET
Základní klient umožňující odeslat účtenku na EET server a získat FIK. Podporuje i PHP 5.3, nevyžaduje konverzi certifikátů z PKCS12 do PEM formátu. Pro komunikaci s bránou umožňuje použít SOAP nebo curl.
Implementace vychází z dokumentace http://www.etrzby.cz/assets/cs/prilohy/EET_popis_rozhrani_v3.1.1.pdf. Přístupové údaje a certifikáty pro testovací prostředí jsou popsány v http://www.etrzby.cz/assets/cs/prilohy/EET_pristupove_provozni_informace_playground_3.1.pdf.
##Instalace
Composer
composer require zdenekgebauer/eet
Ruční instalace
Soubory ze složky src je třeba začlenit do aplikace pomocí autoloadu
nebo pomocí require_once 'src/autoload.php'
##Použítí Příklady použití jsou ve složce example. Příklad připojení na produkční EET používá testovací certifikát, pro ostré nasazení je třeba nastavit certifikát vystavený obchodníkovi.
##Testy
V adresáři tests/integration jsou testy používajíci testovací i produkční server. U těchto serverů není možné
simulovat selhání spojení, proto se používá volání skriptů na lokálním serveru. Před jejich
spuštěním je třeba v souborech tests/_data/*.wsdl patřičně nastavit soap:address location
.
##Známé problémy
Starší verze PHP 5.3 mohou mít kvůli starší verzi OpenSSL problém s voláním EET serveru. V takovém případě může
pomoci vynucení použití curl pomocí Config::setUseCurl(true)
. Při tomto způsobu se může objevit problém
s ověřením certifikátu, jeho příčinou je zpravidla chybějící nebo zastaralý certifikát v nastavení curl.cainfo
v php.ini. Certifikáty jsou ke stažení na https://curl.haxx.se/docs/caextract.html. Není-li možné opravit toto
nastavení, je v krajním případě možné kontrolu certifikátu vyřadit pomocí Config::setCurlVerifySslPeer(false)
.
##Changelog
- 0.0.1
- první verze
- 0.0.2
- doplnění metody
Connector:sign()
pro podepsání účtenky bez odeslání - doplnění metody
Receipt::getPkpString()
pro získání PHP kódu v base64 - drobné opravy překlepů, odstranění zbytečností.
- doplnění metody
- 0.0.3
- možnost použití curl místo SOAP
- 0.0.4
- možnost potlačit kontrolu SSL certifikátu při použití curl
- oprava výjimek při použití curl
- 0.0.5
- vynechání prázdných údajů z datové zprávy