tecsiaron/ublrenderer

UBL 2 HTML renderer (PHP)

0.0.1-alpha 2024-07-18 10:26 UTC

Requires

• php: 8.1
• ext-bcmath: *
• ext-libxml: *
• ext-xmlreader: *
• ext-zip: *
• sabre/xml: ^4.0
• twig/twig: 3.4.3

Requires (Dev)

• phpunit/phpunit: ^11.2

Apache-2.0

• Tecsi Aron

README

STILL IN TESTING PHASE
Should not be used in production
PHP Library to convert RO eFactura UBL/ZIP files to HTML/PDF*
Check Sample PDF and Sample HTML
Uses Twig for templating and supports user defined templates.
Requirements:

• php 8.2 or newer
• ext-xmlreader
• ext-bcmath
• ext-zip
• ext-libxml

Instalation:

composer require tecsiaron/ublrenderer

Usage in shell:

php vendor/bin/ubl2html.php <input.xml or input.zip> <output.html>

Simple usage in php (with XML file):

$content=file_get_contents("path_to.xml");
$renderer = new UBLRenderer($content);
$renderer->WriteFile();

Simple usage with ANAF ZIP

$content=UBLRenderer::LoadUBLFromZip("test.zip")->ubl;
$renderer = new UBLRenderer($content);
$renderer->WriteFile();

In both of the above cases the file will be written to vendor/tecsiaron/ublrenderer/output
To specify where files are written call WriteFile (or WriteFiles) like this:

$renderer->WriteFiles(new HTMLFileWriter("path_to_output.html"));

Advanced usage:

// get the contents of the XML
$renderer = new UBLRenderer($content);
$invoice=$renderer->ParseUBL();
$validation=$invoice->CanRender();
$validationFailReason="Validation failed:\n";
if(is_array($validation))
{
	echo "Failed to render invoice: ". implode("\n", $validation)
}
else
{
	$html=$renderer->CreateHTML(invoice);
}

*For PDF support install ublrenderer-pdf and use PDFWriter

composer require tecsiaron/ublrenderer-pdf