Download the PHP package datomatic/carta-del-docente without Composer
On this page you can find all versions of the php package datomatic/carta-del-docente. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download datomatic/carta-del-docente
More information about datomatic/carta-del-docente
Files in datomatic/carta-del-docente
Package carta-del-docente
Short Description Un pacchetto per poter integrare la Carta del Docente in un progetto PHP
License MIT
Homepage https://github.com/datomatic/carta-del-docente
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package carta-del-docente
CARTA del DOCENTE
Il pacchetto non ufficiale per integrare facilmente la Carta del Docente in un progetto PHP.
Se utilizzate il framework Laravel ho creato anche un pacchetto ad hoc datomatic/laravel-carta-del-docente.
Requisiti
- PHP >= 8.0
- ext-soap
Installazione
Puoi installare il pacchetto via composer:
Configurazione
Per poter utilizzare il pacchetto bisogna leggere la documentazione ufficiale che spiega tutto il processo della Carta del Docente.
Per la parte di test è già tutto pronto senza dover generare nessun certificato (l'ho già fatto io per voi); basta solo richiedere dei voucher di test tramite email a [email protected].
Attenzione: Per la parte di produzione, invece, va generato un certificato seguendo la guida.
Utilizzo
Per prima cosa bisogna inizializzare il client con i dati relativi al certificato e la password del certificato.
Per l'ambiente di test il certificato e la password sono già inclusi nel pacchetto (essendo uguali per tutti).
Per l'ambiente di produzione è necessario fornire il path al certificato (possibilmente non mettetelo accessibile esternamente) e la relativa password.
Una volta ottenuto il client è possibile utilizzare le poche funzionalità necessarie.
Attivazione esercente
Questa operazione va fatta solo una volta all'inizio ed è disponibile solo per la produzione in quanto in ambiente di test non è necessaria.
La funzione ritorna un oggetto CartaDelDocenteResponse oppure una eccezione RequestException in caso di errore.
Se tutto è andato a buon fine verrà ritornato il seguente oggetto:
Check
Per effettuare il Check del voucher basta chiamare la funzione check passando il tipo di operazione (1,2,3) e il codice del voucher.
La funzione ritorna un oggetto CartaDelDocenteResponse in caso di esito positivo oppure una eccezione RequestException in caso di errore.
L'oggetto CartaDelDocenteResponse è composto dalle seguenti proprietà:
Confirm
Per effettuare il Confirm del voucher basta chiamare la funzione confirm passando il tipo di operazione (1), il codice del voucher e l'importo da confermare.
Come generare un certificato valido
Per generare correttamente un certificato è necessario eseguire delle operazioni da terminale Linux / Mac OS oppure WSL di Windows.
NB:Se ottenete un errore di comando non valido potrebbe essere necessario scrivere a mano il comando intero invece che fare copia incolla.
Per prima cosa dobbiamo andare a creare la richiesta di certificato da usare sul sito cartadeldocente.
Per fare questo prima creiamo il file req.cer da caricare nel sito:
Una volta premuto invio dovremmo per prima cosa inserire una password (PEM pass) due volte, e Poi andare a compilare i seguenti campi:
- Country Name (2 letter code) [AU]: // la nazione in due cifre es: IT
- State or Province Name (full name) [Some-State]: // la provincia es: Vicenza
- Locality Name (eg, city) []: // la città es: Valdagno
- Organization Name (eg, company) [Internet Widgits Pty Ltd]: // l'organizzazione es: Acme srl
- Organizational Unit Name (eg, section) []: // sezione dell'organizzazione es: Shop
- Common Name (e.g. server FQDN or YOUR name) []: // nome del richiedente es: Mario Rossi
- Email Address []: // indirizzo email
- A challenge password []: // una nuova password che per comodità metteremo uguale a quella già inserita
Ottenuto il file req.der lo possiamo caricare sul sito cartadeldocente nella form di richiesta certificato ed dopo qualche secondo/minuto possiamo scaricare il file [PIVA-azienda].cer sempre dal sito online (comparirà un pulsante con scritto qualcosa tipo 'scarica certificato' dove prima c'era il pulsante per richiedere il certificato).
Questo certificato lo mettiamo nella stessa cartella dove abbiamo gli altri file sopra creati.
Andiamo a convertire il certificato .cer in un file .pem (i files per comodità li chiamo XXXXX ma voi avrete il numero della partita iva aziendale).
Poi lo convertiamo in un file .p12 combinandolo con la chiave generata nel primo passaggio:
Infine convertiamo il certificato .p12 nel certificato result.pem finale da usare in produzione
Quindi per usare il pacchetto in produzione bisognerà mettere il path al file result.pem.
N.B.: ricordatevi che il certificato ha valenza 3 anni e quindi andrà rigenerato ogni 3 anni
Cosa fare in caso di scadenza certificato
Quando ricevete l'errore Could not connect to host ci sono due possibilità o è offline il servizio di Sogei oppure avete il certificato scaduto.
Per vedere la scadenza del certificato eseguite il seguente comando:
Per rigenerarlo seguite la procedura qui per questo metodo.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Alberto Peripolli
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of carta-del-docente with dependencies
ext-soap Version *