[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"doc-fr-connexion-mysql-serveur-fivem":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":20,"docGroup":26,"docGroupIcon":26,"link_en":27,"bodyHtml":28},"\u002Fdocs\u002Ffr\u002Fgaming\u002Ffivem\u002Fconnexion-mysql-serveur-fivem","connexion-mysql-serveur-fivem","Comment connecter son serveur FiveM à une base de données MySQL ?","Configurez la connexion MySQL de votre serveur FiveM chez Winheberg, chaîne de connexion, sécurité du mot de passe et résolution des erreurs courantes.","jeux","fivem","tabler:file-text","2026-07-24","Winheberg",15,"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Ffivem\u002Fconnexion-mysql-serveur-fivem.webp",[9,16,17,18,19],"mysql","base de données","oxmysql","configuration",[21,22,23,24,25],"fivem mysql","connexion base de données fivem","oxmysql configuration","mysql_connection_string","serveur fivem winheberg","","\u002Fen\u002Fdocs\u002Ffivem\u002Fconnect-mysql-fivem-server","\u003Ch2>Contexte\u003C\u002Fh2>\n\u003Cp>Vous gérez un \u003Cstrong>serveur FiveM\u003C\u002Fstrong> (GTA RP) et vous voulez le connecter à une \u003Cstrong>base de données MySQL\u003C\u002Fstrong> pour stocker les comptes joueurs, l'inventaire, les véhicules, l'argent ou tout autre élément persistant ? Que vous utilisiez \u003Cstrong>oxmysql\u003C\u002Fstrong>, \u003Cstrong>ghmattimysql\u003C\u002Fstrong> ou un autre connecteur, la configuration se fait toujours via la même variable \u003Ccode>mysql_connection_string\u003C\u002Fcode> dans votre \u003Ccode>server.cfg\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>Ce guide vous explique pas à pas comment configurer cette connexion correctement, avec les bonnes pratiques de sécurité et la résolution des erreurs les plus fréquentes.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-important\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z\"\u002F>\u003Cpath d=\"M12 8v4\"\u002F>\u003Cpath d=\"M12 16h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Assurez-vous que les informations sensibles telles que les mots de passe sont sécurisées et ne sont pas partagées publiquement. Ne commitez jamais votre \u003Ccode>server.cfg\u003C\u002Fcode> sur un dépôt Git public, même temporairement.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Prérequis\u003C\u002Fh2>\n\u003Cp>Avant de commencer, assurez-vous d'avoir les éléments suivants.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Un \u003Cstrong>serveur FiveM\u003C\u002Fstrong> actif sur votre panel gaming Winheberg\u003C\u002Fli>\n\u003Cli>Un \u003Cstrong>connecteur MySQL\u003C\u002Fstrong> installé sur votre serveur FiveM (oxmysql, ghmattimysql, mysql-async, etc.)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>1. Créer une base de données depuis le panel gaming\u003C\u002Fh2>\n\u003Cp>La création de votre base de données se fait directement depuis le \u003Cstrong>panel gaming Winheberg\u003C\u002Fstrong>, dans la section dédiée de votre serveur FiveM.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Connectez-vous à votre \u003Cstrong>panel gaming Winheberg\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Rendez-vous sur votre serveur FiveM\u003C\u002Fli>\n\u003Cli>Ouvrez l'onglet \u003Cstrong>Databases\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Cliquez sur \u003Cstrong>Create Database\u003C\u002Fstrong> (ou équivalent) pour créer une nouvelle base\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Ffivem\u002Fconnexion-mysql-serveur-fivem-1779545714832-dbc8aa8fc6367a6a869e8ad4.webp\" alt=\"Capture d'écran de l'onglet Databases du panel gaming avec le bouton Create Database\" width=\"800\" \u002F>\n\n\u003Cp>Une fois la base créée, vous obtiendrez un nom de base, un nom d'utilisateur et un mot de passe. Ces informations apparaîtront immédiatement dans le tableau des bases de données.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Ffivem\u002Fconnexion-mysql-serveur-fivem-1779546184099-9bf5177916be09045aa783f5.webp\" alt=\"Capture d'écran du tableau récapitulatif après création (Name, Username, Endpoint)\" width=\"800\" \u002F>\n\n\u003Ch2>2. Récupérer la chaîne de connexion prête à l'emploi\u003C\u002Fh2>\n\u003Cp>Pour vous simplifier la vie, Winheberg génère automatiquement la \u003Cstrong>chaîne de connexion complète\u003C\u002Fstrong> dans la section \u003Cstrong>Database Details\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Cliquez sur votre base de données fraîchement créée\u003C\u002Fli>\n\u003Cli>Descendez jusqu'à la section \u003Cstrong>Database Details\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Repérez la ligne \u003Cstrong>Fxserver Database\u003C\u002Fstrong> qui contient la \u003Ccode>mysql_connection_string\u003C\u002Fcode> prête à copier\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Ffivem\u002Fconnexion-mysql-serveur-fivem-1779545831004-15e546e228cb9281253bcccd.webp\" alt=\"Capture d'écran du bouton Database Details\" width=\"800\" \u002F>\n\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Ffivem\u002Fconnexion-mysql-serveur-fivem-1779545902055-32b4b4047822492c6df3be3c.webp\" alt=\"Capture d'écran de la section Database Details avec la ligne Fxserver Database\" width=\"800\" \u002F>\n\n\u003Cp>Cette ligne ressemble à ceci.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">set mysql_connection_string "server=dbXX.wh-nodes.net;database=sxx_Exemple;userid=uxxx_Exemple;password=MOT_DE_PASSE"\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Il vous suffit ensuite de la copier dans votre \u003Ccode>server.cfg\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Si votre mot de passe contient des caractères comme \u003Ccode>=\u003C\u002Fcode>, \u003Ccode>;\u003C\u002Fcode>, \u003Ccode>"\u003C\u002Fcode> ou \u003Ccode>'\u003C\u002Fcode>, le parsing de la chaîne de connexion va échouer (notamment avec OXMYSQL). Dans ce cas, \u003Cstrong>régénérez le mot de passe\u003C\u002Fstrong> depuis le panel (option \u003Cstrong>Rotate password\u003C\u002Fstrong> ou équivalent) jusqu'à obtenir un mot de passe propre. Voir la section "Mot de passe contenant des caractères problématiques" plus bas.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>3. Ajouter la chaîne dans server.cfg\u003C\u002Fh2>\n\u003Cp>Ouvrez votre fichier \u003Ccode>server.cfg\u003C\u002Fcode> (à la racine de votre serveur FiveM) et \u003Cstrong>collez la ligne\u003C\u002Fstrong> que vous venez de copier depuis le panel.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">set mysql_connection_string "server=dbXX.wh-nodes.net;database=sxx_Exemple;userid=uxxx_Exemple;password=VOTRE_MOT_DE_PASSE"\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Si la ligne \u003Ccode>mysql_connection_string\u003C\u002Fcode> existe déjà dans votre \u003Ccode>server.cfg\u003C\u002Fcode>, \u003Cstrong>remplacez-la\u003C\u002Fstrong> entièrement par la nouvelle.\u003C\u002Fp>\n\u003Ch2>4. Redémarrer votre serveur FiveM\u003C\u002Fh2>\n\u003Cp>Après avoir sauvegardé les modifications, \u003Cstrong>redémarrez complètement votre serveur\u003C\u002Fstrong> pour que la nouvelle configuration soit prise en compte. Un simple \u003Ccode>restart\u003C\u002Fcode> d'une ressource ne suffit pas, car la \u003Ccode>mysql_connection_string\u003C\u002Fcode> est chargée au démarrage du serveur.\u003C\u002Fp>\n\u003Ch2>5. Vérifier la connexion\u003C\u002Fh2>\n\u003Cp>Une fois le serveur redémarré, consultez les logs FiveM. Si la connexion fonctionne, vous devriez voir un message du type.\u003C\u002Fp>\n\u003Cpre>\u003Ccode>[oxmysql] Database server connection established!\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Si vous voyez une erreur à la place, consultez la section "En cas de problème" en fin de guide.\u003C\u002Fp>\n\u003Ch2>Mot de passe contenant des caractères problématiques\u003C\u002Fh2>\n\u003Cp>Certains caractères spéciaux (\u003Ccode>=\u003C\u002Fcode>, \u003Ccode>;\u003C\u002Fcode>, \u003Ccode>"\u003C\u002Fcode>, \u003Ccode>'\u003C\u002Fcode>) sont utilisés dans la \u003Cstrong>syntaxe même\u003C\u002Fstrong> de la \u003Ccode>mysql_connection_string\u003C\u002Fcode> et empêcheront le bon parsing de la chaîne. C'est particulièrement le cas avec \u003Cstrong>OXMYSQL\u003C\u002Fstrong>, qui est très strict.\u003C\u002Fp>\n\u003Cp>Si votre mot de passe contient l'un de ces caractères, la solution la plus simple est de \u003Cstrong>régénérer le mot de passe\u003C\u002Fstrong> depuis le panel.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Retournez dans l'onglet \u003Cstrong>Databases\u003C\u002Fstrong> du panel gaming\u003C\u002Fli>\n\u003Cli>Cliquez sur votre base de données\u003C\u002Fli>\n\u003Cli>Utilisez l'option \u003Cstrong>Rotate password\u003C\u002Fstrong> (ou équivalent)\u003C\u002Fli>\n\u003Cli>Vérifiez que le nouveau mot de passe ne contient aucun des caractères problématiques\u003C\u002Fli>\n\u003Cli>Si nécessaire, recommencez la rotation jusqu'à obtenir un mot de passe propre\u003C\u002Fli>\n\u003Cli>Récupérez à nouveau la chaîne \u003Cstrong>Fxserver Database\u003C\u002Fstrong> mise à jour dans \u003Cstrong>Database Details\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Remplacez-la dans votre \u003Ccode>server.cfg\u003C\u002Fcode> et redémarrez votre serveur\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2>Bonnes pratiques de sécurité\u003C\u002Fh2>\n\u003Cp>Quelques règles à respecter pour sécuriser votre connexion MySQL.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Ne partagez jamais votre \u003Ccode>server.cfg\u003C\u002Fcode>\u003C\u002Fstrong> sur des forums ou GitHub publics, il contient votre mot de passe MySQL en clair\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Régénérez votre mot de passe\u003C\u002Fstrong> depuis le panel si vous suspectez une fuite, par exemple si vous avez accidentellement partagé votre \u003Ccode>server.cfg\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Faites des sauvegardes régulières\u003C\u002Fstrong> de votre base de données avec \u003Ccode>mysqldump\u003C\u002Fcode> ou via le panel\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Ne donnez pas l'accès au panel\u003C\u002Fstrong> à des personnes non autorisées, elles pourraient voir votre mot de passe MySQL en clair dans Database Details\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>En cas de problème\u003C\u002Fh2>\n\u003Cp>Voici les erreurs les plus fréquentes que vous pourriez rencontrer.\u003C\u002Fp>\n\u003Ch3>❌ Access denied for user\u003C\u002Fh3>\n\u003Cp>Le nom d'utilisateur ou le mot de passe est incorrect. Vérifiez les points suivants.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Que vous avez bien recopié la ligne complète depuis \u003Cstrong>Database Details\u003C\u002Fstrong> sans tronquer\u003C\u002Fli>\n\u003Cli>Que le mot de passe ne contient pas de caractères interdits (\u003Ccode>=\u003C\u002Fcode>, \u003Ccode>;\u003C\u002Fcode>, \u003Ccode>"\u003C\u002Fcode>, \u003Ccode>'\u003C\u002Fcode>), si c'est le cas, régénérez-le depuis le panel\u003C\u002Fli>\n\u003Cli>Qu'il n'y a pas d'espace en trop avant ou après les valeurs dans votre \u003Ccode>mysql_connection_string\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Can't connect to MySQL server\u003C\u002Fh3>\n\u003Cp>FiveM n'arrive pas à joindre le serveur MySQL. Vérifiez les points suivants.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Que l'adresse du serveur (\u003Ccode>dbXX.wh-nodes.net\u003C\u002Fcode>) est correctement orthographiée dans votre \u003Ccode>mysql_connection_string\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Que votre base de données est bien active dans le panel gaming, pas suspendue ou supprimée\u003C\u002Fli>\n\u003Cli>Que votre serveur FiveM dispose bien d'un accès réseau sortant, normalement toujours le cas chez Winheberg\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Le serveur démarre mais aucune donnée n'est sauvegardée\u003C\u002Fh3>\n\u003Cp>Consultez les logs FiveM au démarrage. Vous y verrez probablement une erreur de connexion silencieuse. Si vous utilisez oxmysql, lancez la commande suivante dans la console FiveM pour activer le mode debug.\u003C\u002Fp>\n\u003Cpre>\u003Ccode>oxmysql_debug true\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Cela activera les logs détaillés des requêtes MySQL et vous aidera à identifier le problème.\u003C\u002Fp>\n\u003Ch3>❌ Unknown collation 'utf8mb4_0900_ai_ci'\u003C\u002Fh3>\n\u003Cp>Cette erreur arrive quand vous importez une base de données exportée depuis MySQL 8 vers MariaDB. Avant d'importer, remplacez dans votre fichier SQL toutes les occurrences de \u003Ccode>utf8mb4_0900_ai_ci\u003C\u002Fcode> par \u003Ccode>utf8mb4_unicode_ci\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>Besoin d'aide ?\u003C\u002Fh2>\n\u003Cp>Si malgré ces étapes votre serveur FiveM ne se connecte toujours pas à MySQL, notre équipe est là. Ouvrez un ticket dans le département \u003Cstrong>Technique\u003C\u002Fstrong> depuis votre espace client, renseignez le champ \u003Cstrong>Produit lié\u003C\u002Fstrong> avec le serveur concerné, et joignez les logs de démarrage de votre serveur FiveM.\u003C\u002Fp>\n\u003Cp>Votre serveur FiveM est maintenant connecté à sa base de données et prêt à sauvegarder les données de vos joueurs 🎮\u003C\u002Fp>\n",1788993135760]