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.
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.
| Emplacement | Ouverture | Usage |
|---|---|---|
Dossier MQL5\Files du terminal | par défaut | état propre à un EA dans une installation |
Dossier commun Terminal\Common\Files | drapeau FILE_COMMON | partage 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, ouINVALID_HANDLEen cas d’échec. Les drapeaux se combinent :FILE_READ,FILE_WRITE,FILE_BIN(binaire),FILE_CSV,FILE_TXT,FILE_ANSIouFILE_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. SansFILE_REWRITEdans les drapeaux, un fichier de destination existant n’est pas remplacé et la fonction renvoiefalse.
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 :
- La journée a-t-elle changé ? Si
dayStartne 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. - 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.
- 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.
FileWriteStructrefuse les structures contenant desstringou des tableaux dynamiques. Stockez les textes courts dans un tableauucharde taille fixe, ou écrivez-les séparément avecFileWriteString. - 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_VERSIONet 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.
- Structure d’un Expert Advisor
- Détecter une nouvelle bougie
- Coder un signal d’entrée
- Filtres horaires, de spread et de volatilité
- Intégrer la gestion du risque
- Limite de perte journalière
- EA multi-symboles
- Utiliser OnTimer
- Variables globales du terminal
- Alertes, e-mails et notifications push
- Panneaux et boutons (CAppDialog)
- L’assistant MQL5 (MQL5 Wizard)
- Déployer un EA sur VPS
- Checklist avant mise en production
