{"id":21312557,"url":"https://github.com/dfridrich/czechdatabox","last_synced_at":"2025-07-12T00:33:18.843Z","repository":{"id":36907430,"uuid":"41214457","full_name":"dfridrich/CzechDataBox","owner":"dfridrich","description":"Knihovna pro komunikaci s datovou schránkou v PHP","archived":false,"fork":false,"pushed_at":"2023-03-11T21:23:50.000Z","size":310,"stargazers_count":25,"open_issues_count":7,"forks_count":10,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-10-29T22:46:20.264Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dfridrich.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-22T15:56:08.000Z","updated_at":"2024-10-08T11:53:07.000Z","dependencies_parsed_at":"2023-02-14T02:30:50.236Z","dependency_job_id":null,"html_url":"https://github.com/dfridrich/CzechDataBox","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfridrich%2FCzechDataBox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfridrich%2FCzechDataBox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfridrich%2FCzechDataBox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfridrich%2FCzechDataBox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dfridrich","download_url":"https://codeload.github.com/dfridrich/CzechDataBox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225773842,"owners_count":17522077,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-21T17:34:22.212Z","updated_at":"2024-11-21T17:34:22.836Z","avatar_url":"https://github.com/dfridrich.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CzechDataBox\n\n[![PHPUnit](https://github.com/dfridrich/CzechDataBox/actions/workflows/test.yaml/badge.svg)](https://github.com/dfridrich/CzechDataBox/actions/workflows/test.yaml)\n[![Latest Stable Version](https://poser.pugx.org/dfridrich/czech-data-box/v/stable)](https://packagist.org/packages/dfridrich/czech-data-box)\n[![Total Downloads](https://poser.pugx.org/dfridrich/czech-data-box/downloads)](https://packagist.org/packages/dfridrich/czech-data-box)\n[![Monthly Downloads](https://poser.pugx.org/dfridrich/czech-data-box/d/monthly)](https://packagist.org/packages/dfridrich/czech-data-box)\n[![License](https://poser.pugx.org/dfridrich/czech-data-box/license)](https://packagist.org/packages/dfridrich/czech-data-box)\n\n\nKnihovna pro komunikaci s datovou schránkou v PHP.\n\n![Logo datových schránek](Resources/logo.png)\n\n## Instalace pomocí Composeru\n\n`composer require dfridrich/czech-data-box`\n\n## Příklady\n\nNíže uvedené příklady používají `Defr\\CzechDataBox\\DataBoxSimpleApi`, které nabízí jednodušší přístup k datové schránce. Pokud chcete použít standardní přístup, můžete využít tyto web services:\n\n```php\n\u003c?php\n\n$dataBox-\u003eDmOperationsWebService();\n$dataBox-\u003eDmInfoWebService();\n$dataBox-\u003eDataBoxSearch();\n$dataBox-\u003eDataBoxAccess();\n$dataBox-\u003eIsdsStat();\n```\n\n### Připojení k datové schránce\n\n```php\n\u003c?php\n\nrequire \"../vendor/autoload.php\";\n\nuse Defr\\CzechDataBox\\DataBox;\n\n$dataBox = new DataBox();\n$dataBox-\u003eloginWithUsernameAndPassword(\"login\", \"heslo\", true); // Pro ostrou verzi\n$dataBox-\u003eloginWithUsernameAndPassword(\"login\", \"heslo\", false); // Pro verzi s testovacím přístupem\n$dataBox-\u003eloginWithCertificateAndPassword(\"certifikat.cer\"); // Nebo pouzijte prihlaseni certifikatem\n\n/** @var \\Defr\\CzechDataBox\\DataBoxSimpleApi $simpleApi */\n$simpleApi = $dataBox-\u003egetSimpleApi();\n```\n\n### Informace o datové schránce\n\n```php\n$simpleApi-\u003egetDataBoxInfo(); // vrací Defr\\CzechDataBox\\Api\\tDbOwnerInfo\n```\n\n### Informace o přihlášeném uživateli\n\n```php\n$simpleApi-\u003egetUserInfo(); // Vrací Defr\\CzechDataBox\\Api\\tDbUserInfo;\n```\n\n### Informace o expiraci hesla\n\n```php\n$simpleApi-\u003egetPasswordExpires(); // \\DateTime|null\n```\n\n### Stažení přijatých zpráv\n\n```php\n$days = 90;\n$limit = 1000;\n\n$messages = $simpleApi-\u003egetListOfReceivedMessages($days, $limit);\nforeach ($messages as $message) {\n    echo \"\u003ch2\u003eMsg# \" . $message-\u003egetDmID() . \"\u003c/h2\u003e\";\n    // Defr\\CzechDataBox\\Api\\tIdDm\n    var_dump($message);\n\n    echo \"\u003ch3\u003eSigned message\u003c/h3\u003e\";\n    // Defr\\CzechDataBox\\DataBoxMessageFile\n    var_dump($simpleApi-\u003edownloadSignedReceivedMessage($message-\u003egetDmID()));\n\n    echo \"\u003ch3\u003eDelivery info\u003c/h3\u003e\";\n    // Defr\\CzechDataBox\\DataBoxMessageFile\n    var_dump($simpleApi-\u003edownloadDeliveryInfo($message-\u003egetDmID()));\n\n    echo \"\u003ch3\u003eAttachments\u003c/h3\u003e\";\n    // Defr\\CzechDataBox\\DataBoxMessageAttachment[]\n    var_dump($simpleApi-\u003egetReceivedDataMessageAttachments($message-\u003egetDmID()));\n}\n```\n\n### Stažení odeslaných zpráv\n\n```php\n$messages = $simpleApi-\u003egetListOfSentMessages();\nforeach ($messages as $message) {\n    echo \"\u003ch2\u003eMsg# \" . $message-\u003egetDmID() . \"\u003c/h2\u003e\";\n    var_dump($message);\n\n    echo \"\u003ch3\u003eSigned message\u003c/h3\u003e\";\n    var_dump($simpleApi-\u003edownloadSignedSentMessage($message-\u003egetDmID()));\n\n    echo \"\u003ch3\u003eDelivery info\u003c/h3\u003e\";\n    var_dump($simpleApi-\u003edownloadDeliveryInfo($message-\u003egetDmID()));\n}\n\n```\n\n### Nalezení datové schránky na základě jejího ID\n\n```php\n$simpleApi-\u003efindDataBoxById('wucb4dd');\n```\n\n\n### Odeslání datové zprávy včetně přílohy\n\nDatová schránka nepřijímá všechny typy souborů, testováno na pdf, jpg, png (Většina binary typů by měla projít).\nTXT soubory lze odeslat pouze, kdyz se 2x base64 encodují, výsledkem je přijatá datová zpráva s base64 encodovaným contentem uvnitř txt souboru\n\n```php\n$files = [\n    '/path/to/a/file.pdf',\n];\n$message = $simpleApi-\u003ecreateBasicDataMessage('wucb4dd', 'Test', $files);\n$sentMessage = $simpleApi-\u003esendDataMessage($message);\nif ($sentMessage-\u003egetDmStatus()-\u003egetDmStatusCode() !== \"0000\") {\n    // Handle errors\n}\n```\n\n## Závěrem\n\nVšechny příklady nejdete ve složce examples. Pro připojení k datové schránce budete potřebovat login a heslo nebo testovací přístup, který lze získat na základě vyplnění [tohoto formuláře](https://www.datoveschranky.info/documents/1744842/1746073/zadost_zrizeni_testovaci_ds.zfo/4b75d5bf-0272-4305-9cef-8ec8f019e9d3).\n\nJakmile přístupové údaje budete mít, vytvořte config.ini (z config.ini.dist).\n\n## Odkazy\n\n- Testovací prostředí datových schránek - https://www.czebox.cz/\n- Ostré prostředí datových schránek - https://www.mojedatovaschranka.cz/\n\n## Contributing\n\nBudu rád za každý návrh na vylepšení :-)\n\n## @TODO\n\n- Jednoduché hledání na základě jména, příjmení nebo názvu firmy nebo úřadu\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdfridrich%2Fczechdatabox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdfridrich%2Fczechdatabox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdfridrich%2Fczechdatabox/lists"}