Augmenter la limite de mémoire WordPress

Quand WordPress ou un plugin s'arrête avec une erreur d'épuisement de mémoire, la solution consiste à augmenter la limite de mémoire PHP, et chez Kapsule c'est un menu déroulant dans KPanel plutôt qu'une édition de fichier. Ce guide explique ce que l'erreur signifie, comment modifier la limite, quelle valeur choisir, et que faire quand augmenter la mémoire ne suffit pas.

À quoi ressemble l'erreur

La forme la plus claire est une erreur fatale affichée sur la page ou écrite dans votre journal d'erreurs :

Fatal error: Allowed memory size of 268435456 bytes exhausted (tried to allocate 20480 bytes)

Divisez le chiffre en octets par 1 048 576 pour le lire en mégaoctets : 268435456 est 256 MB, 134217728 est 128 MB.

Elle ne s'annonce pas toujours aussi clairement. Le même problème sous-jacent se manifeste par :

• Une page complètement blanche sans aucun message, souvent sur un écran spécifique.
• Le tableau de bord WordPress qui se charge mais une seule page d'administration (Plugins, Produits, État du site) qui s'arrête.
• Un téléchargement de média ou une importation qui progresse partiellement et s'arrête.
• Une erreur 500 qui apparaît seulement sous charge.

Modifier la limite dans KPanel

1. Connectez-vous à KPanel et cliquez sur Sites web dans la barre latérale gauche.
2. Cliquez sur le site que vous voulez modifier.
3. Dans le menu du site, ouvrez Avancé, puis PHP.
4. Trouvez la carte Paramètres PHP et la ligne Limite de mémoire.
5. Choisissez une valeur dans le menu déroulant : 128M, 256M, 512M, 1024M ou 2048M.
6. Cliquez sur Enregistrer les paramètres.

Aucun redémarrage n'est nécessaire et le site reste actif tout du long. Vos paramètres sont écrits dans un fichier .user.ini à la racine de votre site, que KPanel gère pour vous.

La même carte contrôle quatre autres valeurs qui ont souvent besoin d'être ajustées en même temps que la mémoire :

La taille maximale de post n'est pas affichée car Kapsule la définit automatiquement, toujours 1 MB au-dessus de votre limite de téléchargement, donc un formulaire contenant un fichier à la limite rentre toujours.

Quelle valeur choisir

Chaque site Kapsule démarre à 256M, ce qui est déjà le double de la valeur par défaut de WordPress et suffisant pour la grande majorité des sites. Passez à une valeur supérieure seulement quand vous avez une erreur réelle.

Définir une limite dans wp-config.php

Le menu déroulant KPanel définit le plafond du serveur. WordPress a ses propres deux constantes qui demandent de la mémoire jusqu'à ce plafond, et certaines documentations vous diront de les définir :

define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );

WP_MEMORY_LIMIT s'applique à l'interface publique. WP_MAX_MEMORY_LIMIT s'applique à la zone d'administration, qui a généralement besoin de plus. Ajoutez-les avant la ligne /* That's all, stop editing! */ dans wp-config.php, en utilisant l'éditeur intégré à Fichiers, puis Gestionnaire de fichiers, ou via SFTP.

Pour la plupart des gens, les constantes ne sont pas nécessaires. Définissez la valeur KPanel et laissez wp-config.php inchangé.

Remarques sur WooCommerce

Les boutiques sont la raison la plus courante de dépasser 256M. Vérifiez la vision de la boutique sur la limite à WooCommerce, puis État dans wp-admin : le rapport État du système affiche la limite de mémoire PHP qu'il peut voir, ce qui est un bon moyen de confirmer que votre modification KPanel a effectivement été prise en compte.

Augmentez à 512M si vous utilisez l'un des éléments suivants :

• Produits variables avec des dizaines de variantes chacun.
• WooCommerce Subscriptions ou une extension de réservation.
• Deux ou plusieurs plugins de passerelle de paiement actifs à la fois.
• Une synchronisation d'inventaire ou de comptabilité qui s'exécute en arrière-plan.

Les pages d'administration WooCommerce lentes ou qui expirent sont généralement une combinaison de mémoire et de durée d'exécution. Augmentez Durée maximale d'exécution à 120 secondes en même temps, et envisagez les options de cache dans Configurer WooCommerce.

Vérifiez aussi votre version PHP

Si les erreurs de mémoire ont commencé juste après un changement de PHP, la version elle-même peut être impliquée : un ancien plugin peut fuir gravement sur un runtime plus récent. La carte Version PHP en haut du même onglet affiche ce que le site utilise et vous permet de basculer entre PHP 8.4, 8.3, 8.2 et 8.1.

Changer de version redémarre le pool PHP du site, donc attendez-vous à quelques secondes de temps d'arrêt. Les détails complets se trouvent dans Modifier votre version PHP.

Quand augmenter la mémoire ne le résout pas

Augmenter la limite deux fois sans amélioration signifie que quelque chose consomme de la mémoire qu'il ne devrait pas. Travaillez dans cet ordre :

1. Faites une sauvegarde. Faire une sauvegarde d'abord, chaque fois.
2. Trouvez le plugin. Désactivez les plugins par moitié plutôt qu'un par un : éteignez la moitié, retestez, puis divisez la moitié qui échoue toujours. Vous pouvez aussi utiliser le Mode sécurisé des plugins sur l'onglet WordPress, puis Plugins, qui désactive tous les plugins à la fois sans supprimer les données d'aucun plugin.
3. Testez le thème. Basculez temporairement vers un thème WordPress par défaut. Un thème exécutant des requêtes lourdes sur chaque chargement de page produit exactement ce schéma.
4. Regardez l'opération, pas le site. Si seules les importations échouent, le problème est la durée d'exécution et la taille du lot, pas la mémoire. Importez en plus petits lots.
5. Lisez le journal. Le Journal d'erreurs PHP sur l'onglet PHP nomme le fichier et la ligne qui ont manqué de mémoire, ce qui identifie généralement le plugin immédiatement.

Si vous êtes toujours bloqué après 512M et un test de plugin clean, envoyez un email à support@kapsulehost.com avec le domaine du site, la ligne d'erreur fatale exacte, et ce que vous faisiez quand c'est arrivé.