3.2 La base de données d'un projet

Créer la base et l'utilisateur

La section a une partie pour MySQL et une pour MongoDB (avec « utilisé par le projet » si le kit voit que le projet l'utilise). Si le projet utilise SQLite, une note explique que la base de données est un fichier du projet et qu'aucun serveur n'est nécessaire.

1. Appuyez sur « Créer la base et l'utilisateur » dans la partie du serveur qu'il vous faut.
2. Le kit installe et démarre le serveur si nécessaire, puis crée une base de données et un utilisateur au nom du projet (minuscules, chiffres et tiret bas : gestionale-fatture devient gestionale_fatture) et un mot de passe de 32 caractères.
3. La partie affiche « Base de données », « Utilisateur », « Mot de passe » et « Chaîne » (masqués, avec « Afficher » et « Copier ») et « Adresse ».

Écrire la connexion dans le fichier .env

1. Appuyez sur « Écrire dans .env ».
2. « Lignes de .env qui changent » apparaît : pour chaque clé, l'ancienne valeur barrée et la nouvelle (mots de passe masqués).
3. Appuyez sur « Écrire » pour confirmer ou sur « Annuler ».

Le kit choisit les clés en fonction de votre fichier .env :

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=gestionale
DB_USERNAME=gestionale
DB_PASSWORD=3f9c…(32 caractères générés par le 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

• Si le fichier .env n'existe pas, il est créé en copiant .env.example. Les autres lignes et les commentaires restent.
• Si la connexion est déjà la bonne : « Le fichier .env contient déjà cette connexion. »
• « Copier le bloc .env », juste à côté, ne touche pas le fichier : il copie les lignes du tableau (DB_* pour Laravel, sinon DATABASE_URL ou MONGODB_URI) à coller dans un autre .env, un fichier de configuration ou un terminal ; « Copié » apparaît. Les lignes contiennent le mot de passe : le kit ne les lit que lorsque vous appuyez sur le bouton.

Copies et restauration

1. Dans la partie « Copies », appuyez sur « Exporter » : « Copie enregistrée : … » apparaît et la copie s'ajoute à la liste.
2. Pour revenir à une copie, appuyez sur « Restaurer… » à côté du fichier et confirmez : « Les données actuelles sont remplacées. »
3. Avant de restaurer, le kit copie ce que la base contient maintenant, dans <base>-prima-del-ripristino-<date et heure> : si la copie échoue, la restauration n'a pas lieu. Ainsi, la restauration du mauvais fichier s'annule en restaurant cette copie.
4. « Ouvrir le dossier des copies » ouvre le dossier : pour restaurer une copie venue de l'extérieur (d'un collègue, d'un autre kit), placez-la là et elle apparaîtra dans la liste.

Des copies de sécurité (« prima-del-ripristino » et « prima-del-cambio-di-versione »), le kit garde les 3 dernières de chaque type et supprime les plus anciennes. Les copies faites avec « Exporter » ne sont jamais supprimées.

Changer la version du serveur

Si vous avez plusieurs versions de MySQL ou MongoDB, le menu « Version du serveur » choisit sur laquelle tourne la base de données du projet. Quand vous la changez, la base et l'utilisateur sont créés aussi sur la nouvelle version, vides : les données se transfèrent avec une copie (Exporter sur l'ancienne, Restaurer sur la nouvelle). Si la version choisie n'est pas installée, « Installer … » apparaît. Avant le changement, le kit copie la base sur la version qu'il quitte, dans <base>-prima-del-cambio-di-versione-<date et heure> : si la copie échoue, la version ne change pas (si cette version n'est plus installée, il n'y a rien à copier et le changement se fait).