cetria/isdoc

PHP library for generating ISDOC files in PHP

2.1 2025-04-04 10:25 UTC

Requires

• php: ^8.0
• cetria/simple-xml-element: ^1.1
• smalot/pdfparser: ^2.8

Requires (Dev)

• cetria/reflection-helper: ^0.4.0
• nesbot/carbon: ^2.16
• phpunit/phpunit: ^8.5.8|^9.3.3

MIT

• sromdavid

README

Isdoc Knihovna na vytváření ISDOC souborů v PHP.

Předpoklady

• Composer - lze stáhnout z getcomposer.org.

Nainstalujte Isdoc přes Composer

composer require cetria/isdoc

Příklad

use Isdoc\Models\Invoice;
use Isdoc\Enums\DocumentType;

// Struktura objektů kopíruje strukturu z ISDOC dokumentace: https://isdoc.cz/6.0.2/doc-cs/isdoc-invoice-6.0.2.html

$taxDocument = new Invoice();

// K naplnění Invoice objektu daty používejte jeho settery. 
$taxDocument->setId('123456789');

// K vybrání povinného předdefinovaného atributu (např. DocumentType) používejte zahrnuté objekty s konstantami ve složce Enums.
$taxDocument->setDocumentType(DocumentType::INVOICE);

/* 
 * toXmlElement() metoda uvnitř každé třídy vytváří CetriaSimpleXmlElement objekt z jeho atributů. 
 * Nevyplněné povinné ISDOC elementy jsou ve výsledném souboru vytvořeny jako prázdné tagy. Nevyplněné nepovinné elementy jsou v souboru vynechány.
 * Pokud je atributem třídy objekt, který obsahuje své vlastní atributy (respektive elementy), pak je celý tento objekt přidán metodou appendSimpleXMLElement().  
 * Povinné elementy jsou přidány do CetriaSimpleXmlElement metodou addChild(). Nepovinné elementy jsou přidávány metodou addChildOptional(). 
 */ 

// Vytvořte ISDOC soubor z Invoice objektu. Např.: 
$fullFilePath = '/srv/www/web/test.isdoc'; 
$taxDocument->toIsdocFile($fullFilePath);