Installer et configurer oxmysql sur FiveM : guide complet 2026

Juin 2026 · 16 min de lecture · Par GothamDev Studio

mysql-async était la norme il y a cinq ans. En 2026, oxmysql (Overextended) est plus rapide, mieux maintenu et supporte nativement async/await. C'est le standard sur les bases ESX, QBCore et sur notre Base Serveur FiveM Française. Ce guide reprend la méthode que nous appliquons sur chaque déploiement GothamDev — txAdmin, ZAP-Hosting, OVH ou machine locale.

1. Pourquoi oxmysql en 2026

oxmysql gère un pool de connexions, expose des exports modernes et reste compatible avec la majorité du code mysql-async existant.

Sans driver MySQL fiable, vos scripts jobs, inventaires et logs plantent silencieusement — ou pire, en pleine heure de pointe.

Dans le cadre de Installer et configurer oxmysql sur FiveM, la section « Pourquoi oxmysql en 2026 » s'articule autour de Plus rapide que mysql-async sur requêtes répétées, Support async/await natif (MySQL.query.await), Maintenu par l'écosystème Overextended (Ox Lib, Ox Inventory), entre autres points détaillés dans la liste ci-dessous. Priorisez selon votre contexte — tout n'a pas la même urgence.

Sur Pourquoi oxmysql en 2026, avancez une étape à la fois — validez chaque point avant le suivant.

Pour « Pourquoi oxmysql en 2026 », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Pourquoi oxmysql en 2026 » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Pourquoi oxmysql en 2026, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Pourquoi oxmysql en 2026 », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Pourquoi oxmysql en 2026 » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Pourquoi oxmysql en 2026 » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

• Plus rapide que mysql-async sur requêtes répétées
• Support async/await natif (MySQL.query.await)
• Maintenu par l'écosystème Overextended (Ox Lib, Ox Inventory)
• Compatible ESX Legacy, QBCore et ressources tierces

2. Prérequis

Serveur FiveM fonctionnel (artifact récent) avec accès fichiers et console — txAdmin, FTP ou panel hébergeur.

Base MySQL ou MariaDB accessible : locale, hébergée (ZAP, VeryCloud, OVH…) ou sur le même node que FXServer pour la latence.

Si la BDD n'existe pas encore, suivez d'abord notre guide créer une base MySQL pour serveur FiveM.

Prérequis : notez ce qui diffère de votre setup actuel, pas seulement ce qui est « théoriquement optimal ».

Pour « Prérequis », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Prérequis » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Prérequis, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Prérequis », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Prérequis » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Prérequis » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

3. Télécharger oxmysql

Récupérez le release officiel sur GitHub — fichier oxmysql.zip, pas le source code.

Lien : github.com/overextended/oxmysql/releases

Beaucoup bloquent sur Télécharger oxmysql faute de sauvegarde préalable — exportez configs et bases avant toute modification.

Pour « Télécharger oxmysql », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Télécharger oxmysql » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Télécharger oxmysql, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Télécharger oxmysql », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Télécharger oxmysql » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Télécharger oxmysql » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

Pour « Télécharger oxmysql », notez la version exacte de vos outils (OS, jeu, framework, thème). Un guide rédigé en 2026 peut diverger sur une version N-2.

4. Installer la ressource

Dans le dossier resources/ de votre serveur, créez un dossier d'organisation [mysql] si besoin.

Extrayez l'archive et placez le dossier oxmysql avec sa structure complète :

Pour Installer la ressource, gardez un journal simple (date, changement, résultat) : indispensable si vous déléguez plus tard.

Pour « Installer la ressource », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Installer la ressource » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Installer la ressource, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Installer la ressource », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Installer la ressource » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Installer la ressource » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

Pour « Installer la ressource », notez la version exacte de vos outils (OS, jeu, framework, thème). Un guide rédigé en 2026 peut diverger sur une version N-2.

resources/
└── [mysql]/
    └── oxmysql/
        ├── fxmanifest.lua
        ├── lib/
        ├── dist/
        └── README.md

5. Connection string dans server.cfg

Ajoutez la chaîne de connexion avant ensure oxmysql :

Sur Connection string dans server.cfg, avancez une étape à la fois — validez chaque point avant le suivant.

Pour « Connection string dans server.cfg », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Connection string dans server.cfg » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Connection string dans server.cfg, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Connection string dans server.cfg », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Connection string dans server.cfg » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Connection string dans server.cfg » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

Pour « Connection string dans server.cfg », notez la version exacte de vos outils (OS, jeu, framework, thème). Un guide rédigé en 2026 peut diverger sur une version N-2.

« Connection string dans server.cfg » : les débutants sur Installer et configurer oxmysql sur FiveM y passent souvent une heure ; les profils avancés trente minutes. Les deux sont normaux.

set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"
ensure oxmysql

set mysql_connection_string "mysql://fivem_user:MOTDEPASSE@127.0.0.1:3306/fivem_db?charset=utf8mb4"
ensure oxmysql

6. Redémarrer et vérifier

Redémarrez le serveur. Dans la console FXServer, vous devez voir :

Dans le cadre de Installer et configurer oxmysql sur FiveM, la section « Redémarrer et vérifier » s'articule autour de Access denied → mauvais identifiants ou IP serveur absente des GRANT MySQL, Connection refused → port 3306 fermé ou MySQL arrêté et Unknown database → la base n'existe pas — créez-la avant de relancer. Priorisez selon votre contexte — tout n'a pas la même urgence.

Redémarrer et vérifier : notez ce qui diffère de votre setup actuel, pas seulement ce qui est « théoriquement optimal ».

Pour « Redémarrer et vérifier », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Redémarrer et vérifier » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Redémarrer et vérifier, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Redémarrer et vérifier », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Redémarrer et vérifier » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Redémarrer et vérifier » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

Pour « Redémarrer et vérifier », notez la version exacte de vos outils (OS, jeu, framework, thème). Un guide rédigé en 2026 peut diverger sur une version N-2.

• Access denied → mauvais identifiants ou IP serveur absente des GRANT MySQL
• Connection refused → port 3306 fermé ou MySQL arrêté
• Unknown database → la base n'existe pas — créez-la avant de relancer

[oxmysql] Connection established
[oxmysql] Database 'fivem_db' is ready

7. Tester les exports en jeu

Ouvrez la console F8 et exécutez une requête test :

Résultat attendu dans la console serveur : [{"result":2}]. Si oui, la couche data est opérationnelle.

Beaucoup bloquent sur Tester les exports en jeu faute de sauvegarde préalable — exportez configs et bases avant toute modification.

Pour « Tester les exports en jeu », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Tester les exports en jeu » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Tester les exports en jeu, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Tester les exports en jeu », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Tester les exports en jeu » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Tester les exports en jeu » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

Pour « Tester les exports en jeu », notez la version exacte de vos outils (OS, jeu, framework, thème). Un guide rédigé en 2026 peut diverger sur une version N-2.

exports.oxmysql:query('SELECT 1+1 AS result', {}, function(rs) print(json.encode(rs)) end)

8. Méthodes principales

oxmysql expose plusieurs exports selon le type de requête :

Pour Méthodes principales, gardez un journal simple (date, changement, résultat) : indispensable si vous déléguez plus tard.

Pour « Méthodes principales », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Méthodes principales » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Méthodes principales, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Méthodes principales », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Méthodes principales » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Méthodes principales » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

Pour « Méthodes principales », notez la version exacte de vos outils (OS, jeu, framework, thème). Un guide rédigé en 2026 peut diverger sur une version N-2.

« Méthodes principales » : les débutants sur Installer et configurer oxmysql sur FiveM y passent souvent une heure ; les profils avancés trente minutes. Les deux sont normaux.

9. Exemple Lua — SELECT

SELECT avec placeholder (protection injection SQL) :

Sur Exemple Lua — SELECT, avancez une étape à la fois — validez chaque point avant le suivant.

Pour « Exemple Lua — SELECT », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Exemple Lua — SELECT » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Exemple Lua — SELECT, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Exemple Lua — SELECT », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Exemple Lua — SELECT » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Exemple Lua — SELECT » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

Pour « Exemple Lua — SELECT », notez la version exacte de vos outils (OS, jeu, framework, thème). Un guide rédigé en 2026 peut diverger sur une version N-2.

« Exemple Lua — SELECT » : les débutants sur Installer et configurer oxmysql sur FiveM y passent souvent une heure ; les profils avancés trente minutes. Les deux sont normaux.

exports.oxmysql:query(
    'SELECT money FROM users WHERE identifier = ?',
    { 'steam:110000XXX' },
    function(rs)
        if rs and rs[1] then
            print('Money:', rs[1].money)
        end
    end
)

10. Exemple Lua — INSERT async

INSERT en async/await (pattern recommandé 2026) :

Exemple Lua — INSERT async : notez ce qui diffère de votre setup actuel, pas seulement ce qui est « théoriquement optimal ».

Pour « Exemple Lua — INSERT async », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Exemple Lua — INSERT async » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Exemple Lua — INSERT async, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Exemple Lua — INSERT async », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Exemple Lua — INSERT async » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Exemple Lua — INSERT async » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

Pour « Exemple Lua — INSERT async », notez la version exacte de vos outils (OS, jeu, framework, thème). Un guide rédigé en 2026 peut diverger sur une version N-2.

« Exemple Lua — INSERT async » : les débutants sur Installer et configurer oxmysql sur FiveM y passent souvent une heure ; les profils avancés trente minutes. Les deux sont normaux.

local insertId = MySQL.insert.await(
    'INSERT INTO logs (action, player) VALUES (?, ?)',
    { 'login', 'steam:110000XXX' }
)
print('Inserted id:', insertId)

11. Performance et pooling

oxmysql gère automatiquement le pool. Options de tuning dans server.cfg :

Dans le cadre de Installer et configurer oxmysql sur FiveM, la section « Performance et pooling » s'articule autour de Toujours utiliser des placeholders ? — jamais concaténer des variables utilisateur, Indexer les colonnes filtrées souvent (identifier, license, citizenid) et BDD sur le même datacenter que FXServer si possible — latence divisée par 100. Priorisez selon votre contexte — tout n'a pas la même urgence.

Beaucoup bloquent sur Performance et pooling faute de sauvegarde préalable — exportez configs et bases avant toute modification.

Pour « Performance et pooling », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Performance et pooling » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Performance et pooling, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Performance et pooling », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Performance et pooling » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Performance et pooling » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

Pour « Performance et pooling », notez la version exacte de vos outils (OS, jeu, framework, thème). Un guide rédigé en 2026 peut diverger sur une version N-2.

• Toujours utiliser des placeholders ? — jamais concaténer des variables utilisateur
• Indexer les colonnes filtrées souvent (identifier, license, citizenid)
• BDD sur le même datacenter que FXServer si possible — latence divisée par 100

set mysql_debug "false"
set mysql_slow_query_warning 250

12. Aller plus loin

Migration depuis mysql-async : voir guide migration mysql-async → oxmysql.

Ordre ensure et OneSync : server.cfg essentiel FiveM.

Stack RP complète : Pack Ox GothamDev + Base Serveur FR sur LeGeekShop.

Pour Aller plus loin, gardez un journal simple (date, changement, résultat) : indispensable si vous déléguez plus tard.

Pour « Aller plus loin », bloquez une plage horaire sans interruption : la moitié des erreurs vient d'une étape sautée parce qu'on avait la tête ailleurs.

« Aller plus loin » dans le cadre de Installer et configurer oxmysql sur FiveM : si vous déléguez, rédigez une mini-checklist — votre futur vous remerciera.

Autour de Aller plus loin, gardez une copie de la config ou du fichier d'origine. Revenir en arrière doit rester possible en moins de dix minutes.

Sur « Aller plus loin », mesurez avant/après une seule métrique (temps de chargement, FPS, taux d'erreur, leads) — sinon vous ne saurez pas si ça valait le coup.

« Aller plus loin » peut sembler redondant avec un autre chapitre : en pratique, c'est le niveau de détail qui change, pas le sujet global de Installer et configurer oxmysql sur FiveM.

Avant d'appliquer « Aller plus loin » en production, testez sur un environnement restreint — compte démo, serveur privé, staging ou VM.

Synthèse : stabiliser son serveur RP

Appliquez ce guide par étapes — pas tout en même temps. Mesurez une métrique par semaine pour savoir ce qui fonctionne.

GothamDev peut prendre en charge tout ou partie de ce plan : audit initial gratuit, devis transparent et livrables testés.

• Audit resmon et ressources inutiles
• Stabilisation base + sauvegardes
• Site + Discord + boutique alignés
• Communication joueurs et changelog