Installer et configurer oxmysql sur FiveM : guide complet 2026

Juin 2026 · 14 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.

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

• 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.

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

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

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

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 :

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

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

5. Connection string dans server.cfg

Ajoutez la chaîne de connexion avant ensure oxmysql :

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

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 :

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

• 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.

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

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 :

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

9. Exemple Lua — SELECT

SELECT avec placeholder (protection injection SQL) :

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

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) :

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

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 :

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

• 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.

Nous développons scripts RP, interfaces NUI et ressources sur mesure — toujours open source, avec la même exigence que sur nos projets web clients.

LeGeekShop ne commercialise que des ressources FiveM open source — code livré en clair (.lua, config, assets), personnalisation totale côté serveur.

La stabilité serveur FiveM passe par moins de ressources mais mieux optimisées : profiling resmon, events réseau maîtrisés et scripts maintenus — philosophie appliquée sur LeGeekShop.

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