PHP Fatal Error: Allowed Memory Size — brisons les mythes et configurons

Introduction : pourquoi votre script PHP « explose » ?

Avez-vous déjà vu un écran blanc avec le message glaçant « Fatal Error: Allowed Memory Size of 134217728 Bytes Exhausted » ? Si oui, vous n'êtes pas seul. Cette question sur Stack Overflow a recueilli des milliers de vues, et un développeur PHP sur deux l'a rencontrée au moins une fois dans sa vie.

Le nombre 134217728 octets correspond exactement à 128 mégaoctets (la limite standard pour de nombreux hébergements). Lorsque votre script tente d'en utiliser davantage, PHP dit « stop » et génère une erreur fatale. Mais ne paniquez pas ! Dans cet article, nous allons voir pourquoi cela se produit, comment le corriger et, surtout, comment optimiser les performances pour que cette erreur de mémoire ne vous inquiète plus.

Cet article est rédigé pour le site éducatif PythonLib, mais tout le code et les exemples sont en PHP. C'est parti !

Qu'est-ce que memory_limit et d'où vient « 134217728 » ?

En PHP, il existe la directive memory_limit qui définit la quantité maximale de mémoire disponible pour un script. Par défaut, dans de nombreuses configurations (notamment sur les hébergements mutualisés), la valeur est 128M (soit 134217728 octets).

Vous pouvez vérifier la limite actuelle ainsi :

<?php\necho ini_get('memory_limit'); // Affichera par exemple "128M"\n?>

Lorsque votre script dépasse cette limite, PHP termine immédiatement l'exécution avec une erreur fatale. Les causes peuvent être variées : code non optimal, chargement de fichiers volumineux en mémoire, etc.

Scénarios typiques provoquant l'erreur

\n
• Travail avec de grands tableaux — par exemple, lire un fichier CSV entièrement en mémoire.
\n
• Boucles avec fuites — oubli de libérer des variables ou utilisation de tableaux globaux.
\n
• Bibliothèques de traitement d'images — GD ou Imagick lors du travail avec des photos haute résolution.
\n
• Fonctions récursives — sans condition de base, elles deviennent infinies et consomment la pile.
\n
• ORM et mise en cache — certains ORM (comme Doctrine) peuvent charger une table entière en mémoire.
\n

Comment corriger l'erreur : 3 méthodes éprouvées

1. Augmentation temporaire de la limite avec ini_set()

La méthode la plus rapide consiste à augmenter la limite directement dans le script :

<?php\nini_set('memory_limit', '256M');\n// Désormais, le script peut utiliser jusqu'à 256 Mo\n?>

Important : cela ne fonctionne que si votre hébergement autorise la redéfinition de la directive. Sur certains hébergements, ini_set() pour memory_limit est bloqué.

2. Modification de php.ini ou .htaccess

Si vous avez accès au serveur, modifiez php.ini :

memory_limit = 256M

Ou via .htaccess (sur Apache) :

php_value memory_limit 256M

Après les modifications, redémarrez le serveur web ou PHP-FPM.

3. Optimisation du code — la meilleure solution

Augmenter la limite est une solution de fortune. La vraie solution est d'écrire un code efficace. Examinons des exemples.

Exemple concret : traitement d'un gros fichier CSV

Supposons que vous ayez un fichier CSV de 500 000 lignes. Un code naïf pourrait ressembler à ceci :

<?php\n$rows = file('data.csv'); // Charge TOUT le fichier en mémoire !\nforeach ($rows as $row) {\n    // traitement\n}\n?>

Avec un fichier de 200 Mo, le script plantera avec une erreur de mémoire.

Optimisation : lecture ligne par ligne

<?php\n$handle = fopen('data.csv', 'r');\nif ($handle) {\n    while (($row = fgetcsv($handle)) !== false) {\n        // traite une ligne à la fois\n        // la mémoire n'augmente presque pas\n    }\n    fclose($handle);\n}\n?>

Désormais, le script n'utilise que quelques mégaoctets, quelle que soit la taille du fichier.