Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL5 · Expert Advisors

Sauvegarder l’état d’un Expert Advisor MQL5 dans des fichiers

Conserver l’état d’un EA entre deux redémarrages avec FileOpen, FileWriteStruct et FileReadStruct, en écrivant de façon atomique grâce à un fichier temporaire et à FileMove.

Mis à jour le 23 octobre 2026Lecture : 8 minPar Alix, OptiBot Trading

Pour qu’un Expert Advisor MQL5 retrouve son état après un redémarrage, enregistrez cet état dans un fichier du bac à sable du terminal : regroupez les valeurs dans une structure, écrivez-la avec FileWriteStruct dans un fichier ouvert par FileOpen en mode binaire, et relisez-la avec FileReadStruct dans OnInit. Pour qu’une coupure pendant l’écriture ne corrompe pas la sauvegarde, écrivez d’abord dans un fichier temporaire, puis remplacez l’ancien fichier avec FileMove et le drapeau FILE_REWRITE.

Cette page de la rubrique Construire un Expert Advisor en MQL5 explique quand préférer un fichier aux variables globales du terminal, où les fichiers sont stockés, et comment écrire une sauvegarde fiable. Le format CSV, utile pour exporter des données lisibles, est détaillé dans Lire et écrire des fichiers CSV.

Ce qu’il faut sauvegarder, et ce qu’il ne faut pas

Un EA bien conçu reconstruit l’essentiel de son état à partir du serveur : les positions ouvertes se relisent avec PositionsTotal et PositionGetTicket, l’historique avec HistorySelect. Ces informations ne doivent pas être sauvegardées dans un fichier : la source de vérité est le compte, et une copie locale pourrait être périmée.

Le fichier sert à conserver ce que le serveur ne connaît pas :

  • les décisions internes de l’EA : mode pause, limite journalière atteinte, date du dernier signal traité ;
  • les références de calcul : capital de début de journée, plus haut des capitaux propres pour un coupe-circuit de drawdown ;
  • les compteurs : nombre de pertes consécutives, nombre de trades de la semaine ;
  • les données propres à une position que l’ordre ne porte pas : niveau d’entrée initial avant un passage à break-even, étape d’une sortie partielle.

Si l’état se limite à quelques nombres, les variables globales du terminal suffisent. Dès qu’il contient plusieurs champs liés, des dates, des tickets ou du texte, un fichier est plus adapté.

Où les fichiers sont-ils stockés ?

Les opérations sur fichiers en MQL5 sont limitées à un bac à sable : un programme ne peut pas lire ou écrire en dehors de deux emplacements.

EmplacementOuvertureUsage
Dossier MQL5\Files du terminalpar défautétat propre à un EA dans une installation
Dossier commun Terminal\Common\Filesdrapeau FILE_COMMONpartage entre plusieurs terminaux de la même machine

Pendant un test, les fichiers sont ouverts dans le dossier MQL5\Files de l’agent de test, et non dans celui du terminal. Un état sauvegardé en réel n’est donc pas relu par un backtest, ce qui est souhaitable. Le chemin exact s’obtient avec TerminalInfoString(TERMINAL_DATA_PATH) et TerminalInfoString(TERMINAL_COMMONDATA_PATH). Les sous-dossiers indiqués dans le nom du fichier sont créés automatiquement à l’ouverture en écriture.

Les fonctions utiles

  • int FileOpen(nom, drapeaux, séparateur, page_de_code) ouvre le fichier et renvoie un handle, ou INVALID_HANDLE en cas d’échec. Les drapeaux se combinent : FILE_READ, FILE_WRITE, FILE_BIN (binaire), FILE_CSV, FILE_TXT, FILE_ANSI ou FILE_UNICODE, FILE_SHARE_READ, FILE_COMMON.
  • uint FileWriteStruct(handle, structure) écrit une structure en binaire et renvoie le nombre d’octets écrits. La structure ne doit contenir ni chaîne, ni tableau dynamique, ni fonction virtuelle.
  • uint FileReadStruct(handle, structure) lit une structure et renvoie le nombre d’octets lus.
  • FileClose(handle) ferme le fichier ; FileFlush(handle) force l’écriture des données en mémoire tampon.
  • FileIsExist(nom) teste l’existence ; FileDelete(nom) supprime.
  • bool FileMove(source, drapeau_source, destination, drapeaux) renomme ou déplace. Sans FILE_REWRITE dans les drapeaux, un fichier de destination existant n’est pas remplacé et la fonction renvoie false.

Code : sauvegarde atomique d’une structure d’état

#property version "1.00"

sinput ulong InpMagic = 260110;

#define STATE_VERSION 1

//--- état persistant : types simples uniquement (pas de string, pas de tableau dynamique)
struct EAState
  {
   int      version;         // version du format, pour les évolutions futures
   datetime dayStart;        // début de la journée de référence
   double   dayEquity;       // capitaux propres de référence
   double   peakEquity;      // plus haut des capitaux propres
   int      lossStreak;      // pertes consécutives
   bool     paused;          // pause décidée par l'EA ou l'opérateur
   datetime lastSignalBar;   // dernière bougie ayant produit un signal
  };

EAState g_state;
string  g_file;   // ex. OptiBotState\260110_EURUSD.bin

//--- écrit l'état dans un fichier temporaire, puis remplace l'ancien fichier
bool SaveState()
  {
   string tmp = g_file + ".tmp";
   int h = FileOpen(tmp, FILE_WRITE | FILE_BIN);
   if(h == INVALID_HANDLE)
     {
      Print("Ouverture impossible de ", tmp, ", erreur ", GetLastError());
      return(false);
     }
   uint written = FileWriteStruct(h, g_state);
   FileClose(h);
   if(written != sizeof(EAState)) return(false);       // écriture incomplète : on garde l'ancien fichier
   if(!FileMove(tmp, 0, g_file, FILE_REWRITE))         // remplacement du fichier précédent
     {
      Print("Remplacement impossible, erreur ", GetLastError());
      return(false);
     }
   return(true);
  }

//--- relit l'état ; renvoie false s'il n'existe pas ou s'il est invalide
bool LoadState()
  {
   if(!FileIsExist(g_file)) return(false);
   int h = FileOpen(g_file, FILE_READ | FILE_BIN);
   if(h == INVALID_HANDLE) return(false);
   EAState s;
   uint read = FileReadStruct(h, s);
   FileClose(h);
   if(read != sizeof(EAState) || s.version != STATE_VERSION) return(false);
   g_state = s;
   return(true);
  }

void ResetState()
  {
   ZeroMemory(g_state);
   g_state.version    = STATE_VERSION;
   g_state.dayStart   = iTime(_Symbol, PERIOD_D1, 0);
   g_state.dayEquity  = AccountInfoDouble(ACCOUNT_EQUITY);
   g_state.peakEquity = g_state.dayEquity;
  }

int OnInit()
  {
   g_file = StringFormat("OptiBotState\\%I64u_%s.bin", InpMagic, _Symbol);
   if(MQLInfoInteger(MQL_TESTER) || !LoadState())       // pas de reprise d'état en test
      ResetState();
   else
      PrintFormat("État restauré : pause=%s, pertes consécutives=%d",
                  g_state.paused ? "oui" : "non", g_state.lossStreak);
   EventSetTimer(60);                                    // sauvegarde de sécurité chaque minute
   return(INIT_SUCCEEDED);
  }

void OnDeinit(const int reason)
  {
   EventKillTimer();
   SaveState();                                          // dernière sauvegarde à l'arrêt
  }

void OnTimer() { SaveState(); }

void OnTick()
  {
   double eq = AccountInfoDouble(ACCOUNT_EQUITY);
   if(eq > g_state.peakEquity)
     {
      g_state.peakEquity = eq;   // sauvegardé par la minuterie et à l'arrêt
     }
   if(g_state.paused) return;
   //--- ici : logique de trading, mise à jour de lossStreak, lastSignalBar, etc.
  }

Pourquoi passer par un fichier temporaire

Si le terminal ou la machine s’arrête au milieu d’une écriture directe, le fichier d’état peut se retrouver tronqué : au redémarrage, l’EA lirait une structure incomplète. En écrivant dans un fichier .tmp, puis en le renommant seulement quand l’écriture est complète, l’ancien fichier reste intact jusqu’au dernier moment. Le contrôle de la taille lue (read != sizeof(EAState)) et du numéro de version complète la protection : un fichier invalide est ignoré et l’EA repart d’un état par défaut, ce qui est toujours préférable à un état faux.

Recouper l’état restauré avec le compte

La restauration n’est que la première moitié du redémarrage. Juste après LoadState, l’EA doit confronter ce qu’il a relu à la réalité du compte. Trois vérifications suffisent dans la plupart des cas :

  1. La journée a-t-elle changé ? Si dayStart ne correspond plus à la bougie journalière en cours, les références journalières (capital, compteurs du jour) doivent être réinitialisées, même si le fichier est valide.
  2. Les positions attendues existent-elles encore ? Si l’état mentionne une position en cours de gestion (sortie partielle, break-even), vérifiez qu’elle est toujours ouverte. Sinon, consultez l’historique pour savoir comment elle s’est terminée et mettez à jour les compteurs, par exemple les pertes consécutives.
  3. Le compte est-il le bon ? Enregistrez le numéro de compte dans la structure et comparez-le à ACCOUNT_LOGIN. Un fichier copié depuis une autre installation ne doit pas être appliqué à un autre compte.

Journalisez le résultat de ces contrôles : en cas de comportement inattendu après une coupure, c’est la première chose que vous voudrez relire.

Pièges fréquents

  • Une chaîne dans la structure. FileWriteStruct refuse les structures contenant des string ou des tableaux dynamiques. Stockez les textes courts dans un tableau uchar de taille fixe, ou écrivez-les séparément avec FileWriteString.
  • Modifier la structure sans changer la version. Ajouter un champ change la taille de la structure : l’ancien fichier ne correspond plus. Incrémentez STATE_VERSION et prévoyez la valeur par défaut des nouveaux champs.
  • Un nom de fichier partagé par plusieurs instances. Deux graphiques avec le même EA écriraient dans le même fichier. Incluez le magic number et le symbole dans le nom, comme dans l’exemple.
  • Sauvegarder à chaque tick. L’écriture disque est lente comparée au calcul. Sauvegardez lors des changements d’état et à intervalle régulier avec OnTimer, pas à chaque variation de prix.
  • Faire confiance au fichier plutôt qu’au compte. Au démarrage, recoupez toujours l’état restauré avec les positions réellement ouvertes. Une position fermée pendant l’arrêt de l’EA, par son stop par exemple, doit être prise en compte.

Questions fréquentes

Quelle différence entre un fichier et une variable globale du terminal ?

Une variable globale du terminal ne stocke qu’un nombre et disparaît après quatre semaines sans accès. Un fichier peut contenir une structure complète, des textes et des tableaux, et n’expire jamais. Pour un état de plus de deux ou trois valeurs, le fichier est plus adapté.

Un EA peut-il écrire un fichier ailleurs que dans MQL5\Files ?

Non, les fonctions de fichiers de MQL5 sont confinées au bac à sable du terminal et au dossier commun. Le travail avec des fichiers situés dans d’autres répertoires est interdit.

Comment partager un état entre deux terminaux installés sur la même machine ?

Ajoutez le drapeau FILE_COMMON à l’ouverture, ainsi qu’à FileIsExist et FileMove : le fichier est alors placé dans le dossier commun à tous les terminaux. Prévoyez un nom de fichier qui identifie clairement le compte concerné.

Faut-il désactiver la reprise d’état dans le Strategy Tester ?

Oui, c’est recommandé. Un test doit partir d’un état connu pour être reproductible ; c’est pourquoi l’exemple réinitialise l’état quand MQLInfoInteger(MQL_TESTER) est vrai.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.