Installazione tramite archivio ZIP

Indice dei contenuti
  1. Perché usare l’archivio ZIP
  2. Requisiti di sistema
  3. Scaricare l’archivio ZIP
  4. Copiare il codice nella cartella di destinazione
  5. Eseguire la procedura di installazione
  6. Esempio di installazione su Altervista
  7. Installazione su server di produzione

Perché usare l’archivio ZIP

L’uso dell’archivio ZIP (che cosa è un archivio ZIP?) permette di semplificare la procedura di installazione, nel caso si utilizzi un apposito servizio di hosting.

E’ possibile usare questa installazione per provare il registro elettronico sul proprio computer, ma si dovrà installare anche il web server Apache e il database server MySql. Si consiglia pertanto di utilizzare, in alternativa, l’installazione tramite Docker.

Si tenga presente che questa modalità non permette l’installazione di applicazioni esterne, necessarie per alcune funzionalità non essenziali del registro elettronico: non è pertanto operativa la conversione automatica in PDF dei documenti.

Requisiti di sistema

Per consentire l’utilizzo corretto dell’applicazione, il servizio di hosting usato dovrà rispettare i seguenti requisiti fondamentali:

  • web server Apache 2.x o superiore;
  • database server MySQL 5.5 o superiore, oppure MariaDB 10.0 o superiore;
  • PHP 7.4 o superiore.

Durante la procedura di installazione saranno verificati ulteriori requisiti di sistema, evidenziandone le criticità.

Scaricare l’archivio ZIP

Si dovrà scaricare l’archivio ZIP dell’ultima versione stabile dell’applicazione:

Copiare il codice nella cartella di destinazione

L’archivio ZIP va decompresso nella cartella principale che il servizio di hosting mette a disposizione.

Si faccia attenzione che solo la cartella public/ deve essere esposta pubblicamente sul web, mentre tutto il resto deve rimanere inaccessibile.

Per far questo, alcuni servizi di hosting permettono di scegliere la cartella da pubblicare (spesso indicata come domain_root): in tal caso, impostare il percorso della cartella public/ caricata in precedenza.

Altri servizi di hosting, invece, hanno una cartella predefinita da usare per la pubblicazione (spesso indicata come public_html): in questo caso, sarà necessario copiare tutto il contenuto della cartella public/ all’interno di quella di pubblicazione.

A questo punto, la pagina principale del registro elettronico dovrebbe essere visibile andando all’indirizzo:

  • https://nome_sito

Eseguire la procedura di installazione

Per eseguire la procedura di installazione iniziale, andare alla pagina seguente e seguire le istruzioni:

  • https://nome_sito/install/app.php

Al termine della procedura, il file PHP della procedura viene rimosso, per ragioni di sicurezza.

Esempio di installazione su Altervista

La procedura per l’installazione iniziale usando il servizio di hosting Altervista viene descritta di seguito: si raccomanda di eseguire con attenzione ogni passaggio.

  1. Per prima cosa, se non l’hai già fatto, registrati su Altervista e scegli il nome del tuo dominio. In fase di registrazione, assicurati di scegliere il servizio Hosting con file manager. Se non sai come fare, segui questo tutorial.

  2. Vai al pannello di controllo di Altervista e clicca sul menu RISORSE. Cerca nella pagina il riquadro PHP e clicca sul collegamento Modifica Impostazioni PHP. A questo punto cerca la configurazione della versione PHP e impostala su PHP8; infine clicca sul pulsante SALVA.

  3. Scarica il file ZIP dell’ultima versione e decomprimilo sul tuo computer.

  4. Usa un programma FTP come FileZilla (scaricalo da qui se non ce l’hai). FileZilla ti permette di caricare i file sul tuo spazio Altervista: se non conosci questo programma guarda questo tutorial.

  5. Connettiti con FileZilla al tuo spazio Altervista, utilizzando le credenziali FTP che ti hanno inviato. I file del tuo spazio Altervista appariranno nel riquadro SITO REMOTO. Imposta nel riquadro SITO LOCALE la cartella presente nel tuo computer con i file estratti dallo ZIP di giua@school. Effettua il trasferimento di tutti i file dal sito LOCALE al sito REMOTO (richiederà un po’ di tempo, sono tanti file). Alla fine, controlla se ci sono stati errori: in tal caso ricarica solo i file indicati come errati.

  6. Quando sei sicuro di aver caricato tutto, esegui la procedura di installazione andando all’indirizzo: http://nome_sito_altervista/public/install/app.php

Installazione su server di produzione

Nel momento in cui si decide di usare il registro elettronico per l’uso scolastico quotidiano, è opportuno rafforzare la sicurezza del sistema utilizzato.

Per prima cosa, è indispensabile che il registro elettronico utilizzi il protocollo HTTPS.

Inoltre, si controlli che i file al di fuori della cartella public/ siano inaccessibili.

In particolare, è fondamentale che il file .env non possa mai essere visualizzato dal web.

Per controllarlo, andare all’indirizzo seguente e verificare che sia mostrato un messaggio di errore:

  • https://nome_sito/.env

ATTENZIONE: se si dovessero esporre pubblicamente sul web i file al di fuori della cartella public/, ci saranno gravi conseguenze dal punto di vista della sicurezza.