Download the PHP package padosoft/tessera-sanitaria without Composer

PROGETTO TESSERA SANITARIA

Il package permette la creazione di file XML delle prestazioni mediche per il servizio nazionale sanità secondo il formato XML della tessera sanitaria definito nel DM 31/07/2015. Per maggiori info si veda il Portale della Tessera Sanitaria: http://sistemats1.sanita.finanze.it/wps/portal/

Table of Contents

• PROGETTO TESSERA SANITARIA
• Table of Contents
• PREREQUISITI
  • INSTALLAZIONE OPENSSL
    • Windows
    • Linux
  • GENERAZIONE CERTIFICATO E CHIAVE PUBBLICA
    • Windows
    • Linux
    • Comandi da eseguire
  • CONFIGURAZIONE
    • Enviroment
    • Permission folder
• CHANGE LOG
• USO DELLA LIBRERIA
  • ESEMPIO BASE
  • OUTPUT
    • Output a video
    • Creazione File
  • VALIDAZIONE
• ESEMPIO COMPLETO
  • Screenshot esempio
• Contributing
• Security
• Credits
• About Padosoft
• License

PREREQUISITI

PHP 5.4+ OpenSSL

INSTALLAZIONE OPENSSL

Windows

Scaricare l'eseguibile da https://slproweb.com/products/Win32OpenSSL.html , lanciarlo e seguire le istruzioni a video.

Linux

OpenSSL é già installato di default in tutte le principali distribuzioni. Eventualmente, controllare la versione tramite il comando:

se non aggiornata, lanciare i comandi:

GENERAZIONE CERTIFICATO E CHIAVE PUBBLICA

Collocare i file del certificato e delle chiavi nella directory specificata nella classe PathHelper (default: /tests/certificates).

Se non in possesso dei file ufficiali del ministero, è possibile crearli a scopo di test della libreria seguendo le istruzioni seguenti:

Windows

Lanciare il comando dal prompt DOS posizionandosi nella directory dove si trova openssl, di default C:\OpenSSL-Win32\bin

Linux

Non é necessario spostarsi nel path, in quanto openSSL dovrebbe essere già essere disponibile all'avvio della shell.

Comandi da eseguire

generazione chiave privata

generazione chiave pubblica

generazione certificato

Vedere anche http://www.programmazione.it/index.php?entity=eitem&idItem=36568

CONFIGURAZIONE

Enviroment

Rinominare il file .env.example in .env aprirlo con un editor di testo e impostare le variabili: Esempio Windows:

TMP_PATH = "c:/xampp/htdocs/tessera-sanitaria/tests/tmp/";
CERT_FILE = "c:/xampp/htdocs/tessera-sanitaria/tests/certificates/test.crt";
OPENSSL_EXE_PATH = "c:/OpenSSL-Win32/bin/";

Esempio Linux:

TMP_PATH = "/var/www/html/tessera-sanitaria/tests/tmp/";
CERT_FILE = "/var/www/html/tessera-sanitaria/tests/certificates/test.crt";
OPENSSL_EXE_PATH = "";

Permission folder

Rendere queste directory scrivibili da php:

CHANGE LOG

Please see CHANGELOG for more information what has changed recently.

USO DELLA LIBRERIA

INSTALLAZIONE DEL PROGETTO

Per installare il progetto con il demo, andare nella directory del proprio web server, e lanciare il comando:

Supponendo un installazione su windows con XAMPP:

a questo punto è possibile visitare l'url http://localhost/tessera-sanitaria/tests/index.php e visualizzare la pagina demo.

ESEMPIO BASE

L'utilizzo base del pacchetto, al netto del caricamento delle dipendenze, prevede l'istanza della classe per il tracciato, il passaggio dei dati necessari alla creazione dell'XML e il successivo recupero del codice in una variabile di tipo stringa:

Successivamente, la stringa ricavata potrà essere usata per:

• Stampare direttamente il codice a video
• Creazione file XML
• Creazione file XML compresso

tramite vari metodi analizzati nel successivo paragrafo "Output".

OUTPUT

La stringa XML recuperata dal metodo getXml() della classe Tracciato può essere utilizzata nei seguenti modi:

Output a video

I metodi della classe PrintHelper stampano a video il codice XML generato. Servendosi della libreria Luminous (https://github.com/markwatkinson/luminous) , il codice viene formattato tramite un'interfaccia chiara ed esteticamente gradevole.

Creazione File

La classe IOHelper permette di trasformare la stringa XML nel corrispondente file, sia in versione estesa che compressa. I due metodi che si occupano di queste operazioni sono i seguenti:

VALIDAZIONE

La validazione dei dati passati al metodo doTracciato avviene in modo trasparente per l'utente, tramite la classe ValidateHelper richiamata dal metodo stesso. I parametri di validazione si basano sul documento ufficiale fornito dal ministero della sanità: http://sistemats1.sanita.finanze.it/wps/wcm/connect/487b0bba-6a65-42f9-8b43-2fb907fe7e91/730+Schema+dati+spesa+sanitaria+(28_09_2015)_v2.pdf?MOD=AJPERES&CACHEID=487b0bba-6a65-42f9-8b43-2fb907fe7e91

ESEMPIO COMPLETO

Un esempio esaustivo di tutte le funzionalità summenzionate si trova in /tests/index.php , che carica anche tutte le dipendenze necessarie. Tutti i precedenti esempi di codice sono stati ricavati da questo file.

Screenshot esempio

Uno screenshot di esempio si trova nella cartella resources/img

Contributing

Please see CONDUCT for details.

Security

If you discover any security related issues, please email instead of using the issue tracker.

Credits

• Lorenzo Padovani
• Raffaele Masi
• All contributors

About Padosoft

Padosoft is a software house based in Florence, Italy. Specialized in E-commerce and web sites.

License

The MIT License (MIT). Please see License File for more information.