3.2 Il database di un progetto

Creare database e utente

La sezione ha una parte per MySQL e una per MongoDB (con «usato dal progetto» se il kit vede che il progetto lo usa). Se il progetto usa SQLite, una nota spiega che il database è un file del progetto e non serve nessun server.

1. Premi «Crea database e utente» nella parte del server che ti serve.
2. Il kit installa e avvia il server se serve, poi crea un database e un utente con il nome del progetto (minuscole, cifre e trattino basso: gestionale-fatture diventa gestionale_fatture) e una password di 32 caratteri.
3. La parte mostra «Database», «Utente», «Password» e «Stringa» (nascoste, con «Mostra» e «Copia») e «Indirizzo».

Scrivere la connessione nel file .env

1. Premi «Scrivi in .env».
2. Compare «Righe di .env che cambiano»: per ogni chiave il valore vecchio barrato e quello nuovo (password nascoste).
3. Premi «Scrivi» per confermare o «Annulla».

Il kit sceglie le chiavi in base al tuo file .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=gestionale
DB_USERNAME=gestionale
DB_PASSWORD=3f9c…(32 caratteri generati dal kit)

DATABASE_URL=mysql://portale:3f9c…@127.0.0.1:3306/portale
MONGODB_URI=mongodb://portale:a71e…@127.0.0.1:27017/portale?authSource=portale

• Se il file .env non esiste viene creato copiando .env.example. Le altre righe e i commenti restano.
• Se la connessione è già quella giusta: «Il file .env ha già questa connessione.»
• «Copia blocco .env», accanto, non tocca il file: copia le righe della tabella (DB_* per Laravel, altrimenti DATABASE_URL o MONGODB_URI) da incollare in un altro .env, in un file di configurazione o in un terminale; compare «Copiato». Le righe contengono la password: il kit le legge solo quando premi il pulsante.

Copie e ripristino

1. Nella parte «Copie» premi «Esporta»: compare «Copia salvata: …» e la copia si aggiunge all'elenco.
2. Per tornare a una copia premi «Ripristina…» accanto al file e conferma: «I dati attuali vengono sostituiti.»
3. Prima di ripristinare, il kit copia ciò che il database contiene ora, in <database>-prima-del-ripristino-<data e ora>: se la copia non riesce, il ripristino non si fa. Così un ripristino del file sbagliato si annulla ripristinando quella copia.
4. «Apri la cartella delle copie» apre la cartella: per ripristinare una copia arrivata da fuori (da un collega, da un altro kit) mettila lì e comparirà nell'elenco.

Delle copie di sicurezza («prima-del-ripristino» e «prima-del-cambio-di-versione») il kit tiene le ultime 3 di ogni tipo ed elimina le più vecchie. Le copie fatte con «Esporta» non vengono mai eliminate.

Cambiare la versione del server

Se hai più versioni di MySQL o MongoDB, il menu «Versione del server» sceglie su quale gira il database del progetto. Cambiandola, database e utente si creano anche sulla nuova versione, vuoti: i dati si portano con una copia (Esporta sulla vecchia, Ripristina sulla nuova). Se la versione scelta non è installata, compare «Installa …». Prima del cambio il kit copia il database sulla versione che lascia, in <database>-prima-del-cambio-di-versione-<data e ora>: se la copia non riesce, la versione non cambia (se quella versione non è più installata, non c'è niente da copiare e il cambio si fa).