MDT — Installation (hébergeur / Plesk)

Application PHP (8.1+, recommandé 8.4), MariaDB/MySQL, sessions natives.
Racine web documentaire typique : httpdocs/ (Plesk).

Prérequis

• PHP 8.1 minimum (8.4 recommandé), extensions : pdo_mysql, mysqli, curl, json, mbstring, openssl

• MariaDB ou MySQL 10.x

• Certificat HTTPS (Let’s Encrypt dans Plesk) — requis pour les cookies de session sécurisés

• Espace disque pour le dump SQL + fichiers du site

Migration depuis une copie sans *.local.php

Si vous mettez à jour le code sans passer par l’assistant, créez config/database.local.php à partir de config/database.local.php.example en reprenant les identifiants de votre ancien config/database.php. Créez aussi config/config.local.php à partir de config.local.php.example avec votre SITE_URL et vos clés Discord.

Déploiement des fichiers

1. Téléversez l’intégralité du projet dans le dossier du domaine (ex. httpdocs/).

2. Placez le dump principal à la racine : de préférence mdt_service_public_import_ready.sql (mutualisé / phpMyAdmin), sinon mdt_service_public.sql, si vous souhaitez l’import automatique. Pour générer la version « import ready » : python database/prepare_sql_for_shared_hosting.py.

3. Le fichier database/mdt_ref_v2.sql peut être importé par l’assistant ou à la main.

Assistant graphique (recommandé)

1. Dans un navigateur, ouvrez :
   https://VOTRE-DOMAINE/install.php

2. Suivez les étapes : prérequis → base MySQL → options d’import SQL → URL du site, Discord, APIs → finalisation (mot de passe admin optionnel).

3. L’assistant crée :

   • config/database.local.php — connexion BDD

   • config/config.local.php — URL du site, Discord, bot, option debug

   • install/installed.lock — verrou (réinstallation : supprimer ce fichier)

4. Supprimez ou renommez install.php après succès (sécurité).

Base de données (Plesk)

Créez au préalable une base vide et un utilisateur avec tous les privilèges sur cette base (Plesk → Bases de données). Notez hôte (souvent localhost), nom de la base, utilisateur, mot de passe.

Import SQL volumineux (et hébergement mutualisé)

Si l’import automatique du gros dump échoue (timeout PHP), importez le dump principal via phpMyAdmin (onglet Importer), puis relancez l’assistant en cochant uniquement l’import de database/mdt_ref_v2.sql ou importez ce fichier à la main.

Sur Plesk / mutualisé, n’importez pas le fichier brut mdt_service_public.sql tel quel : les clauses DEFINER= provoquent l’erreur #1227 (privilèges SUPER), et DELIMITER peut casser l’analyseur de phpMyAdmin. Générez d’abord mdt_service_public_import_ready.sql avec python database/prepare_sql_for_shared_hosting.py (ou php database/prepare_sql_for_shared_hosting.php), puis importez ce fichier. Détail : docs/IMPORT_BASE_DONNEES.md.

Installation manuelle (sans assistant)

1. Copiez config/database.local.php.example → config/database.local.php et renseignez les constantes.

2. Copiez config/config.local.php.example → config/config.local.php et renseignez SITE_URL, Discord, etc.

3. Importez les fichiers SQL via phpMyAdmin dans l’ordre : dump principal, puis database/mdt_ref_v2.sql si besoin.

4. Créez install/installed.lock vide (optionnel) ou ignorez — l’assistant vérifie ce fichier pour se bloquer.

Discord OAuth (après installation)

Dans le portail développeur Discord → OAuth2 → Redirects, ajoutez exactement :

• https://VOTRE-DOMAINE/auth/discord-callback.php

• Pour la liaison tablette / code : URL de la forme utilisée par auth/discord-link.php (voir auth/DISCORD_OAUTH_FIVEM.txt).

Variables d’environnement (optionnel)

• MDT_SITE_URL — surcharge de SITE_URL si config.local.php n’existe pas (ex. Docker).

Dépannage

• Erreur de connexion BDD : vérifiez database.local.php, utilisateur MySQL, droits sur la base.

• Page blanche : activez temporairement MDT_DISPLAY_ERRORS à true dans config.local.php (puis repassez à false).

• Cookies / session : domaine en HTTPS, pas de mélange www / non-www sans redirection cohérente.

• Réinstaller : supprimez install/installed.lock, config.local.php, database.local.php, puis réouvrez install.php.

Documentation client simplifiée : voir docs/GUIDE_INSTALLATION_CLIENTS.md.
Import BDD sur mutualisé (erreur #1227, phpMyAdmin) : voir docs/IMPORT_BASE_DONNEES.md.