Passer au contenu principal

Configurer la base de données MariaDB

Ce guide explique pas à pas comment préparer une base de données MariaDB dédiée pour Podcast Utilities. Cette configuration est optionnelle : par défaut, le système génère et utilise une base SQLite locale qui ne nécessite aucun paramétrage.

🎯 Objectif

Dans l'écosystème de Podcast Utilities, la base de données sert à stocker l'historique de vos épisodes et l'évolution de vos statistiques (écoutes Spotify et vues YouTube).

Si vous possédez déjà un serveur MariaDB (sur un NAS ou via Docker) et préférez y centraliser vos données, vous pouvez le connecter à l'application. L'avantage de cette intégration est son automatisation : vous avez uniquement besoin de fournir une base de données vide. Le script se chargera lui-même de créer toutes les tables nécessaires (episodes, ecoutes, vues) lors de son premier lancement.

 

⚠️ Points d'attention

    Solution de repli (Fallback automatique) : Si la connexion à MariaDB échoue (serveur hors ligne, mauvais mot de passe) ou si vous ne configurez pas cette section, Podcast Utilities basculera automatiquement et de manière totalement transparente sur une base SQLite locale.

    Automatisation : Le script est conçu pour générer et mettre à jour sa propre structure de données. Ne tentez pas d'importer un schéma SQL manuellement.

    Sécurité : Pour des raisons de sécurité évidentes, ne donnez jamais l'accès root de votre serveur MariaDB à l'application. Créez toujours un utilisateur restreint à cette seule base de données.

    📝 Étapes à suivre

    Puisque la structure est gérée automatiquement par le code, la préparation côté serveur est extrêmement rapide :

    1. Connectez-vous à votre serveur MariaDB en utilisant votre outil de gestion habituel (phpMyAdmin, Adminer, ou en ligne de commande).
    2. Créez une nouvelle base de données vide (par exemple, nommez-la podcast_utilities).
    3. Créez un nouvel utilisateur dédié à cette base.
    4. Attribuez à cet utilisateur un mot de passe sécurisé et accordez-lui tous les privilèges (ALL PRIVILEGES) uniquement sur la base de données que vous venez de créer.
    5. C'est tout ! Ne créez aucune table manuellement.

    Note : L'adresse de votre serveur (Hôte), le port de connexion et le nom de la base de données devront être renseignés dans votre fichier de configuration général (.ini). Le fichier .env ne gère que le stockage sécurisé des identifiants.

    ⚙️ Intégration dans le fichier .env

    Retournez dans votre fichier .env à la racine de votre dossier de déploiement, et renseignez le nom d'utilisateur et le mot de passe que vous venez de créer :

    MARIADB_USER=votre_nom_d_utilisateur
MARIADB_PASSWORD=votre_mot_de_passe_securise

    ⚠️ Points d'attention

      Solution de repli (Fallback automatique) : Si la connexion à MariaDB échoue (serveur hors ligne, mauvais mot de passe) ou si vous ne configurez pas cette section, Podcast Utilities basculera automatiquement et de manière totalement transparente sur une base SQLite locale. Automatisation : Le script est conçu pour générer et mettre à jour sa propre structure de données. Ne tentez pas d'importer un schéma SQL manuellement. Sécurité : Pour des raisons de sécurité évidentes, ne donnez jamais l'accès root de votre serveur MariaDB à l'application. Créez toujours un utilisateur restreint à cette seule base de données.