Augmenter la taille maximale d’envoi de fichiers via PHP.ini sous WordPress

La taille limite d’envoi de fichiers sous WordPress est bien souvent restreinte à 2 Mo.

Cette limite ne vient pas de WordPress mais de la configuration de PHP sur votre hébergement : 2 Mo est la valeur par défaut de PHP. WordPress retient la plus petite de ces deux directives : upload_max_filesize, la taille maximale d’un fichier envoyé, et post_max_size, la taille maximale de l’ensemble des données envoyées en une fois. Pour augmenter la limite, il faut donc redéfinir ces directives, et la bonne méthode dépend de la façon dont votre hébergeur exécute PHP.

Vérifier la limite actuelle et le mode d’exécution de PHP

La limite en vigueur est indiquée sous la zone d’envoi de l’écran Médias > Ajouter un fichier média, par exemple « Taille de fichier maximale pour le téléversement : 2 Mo. »

Pour le détail, ouvrez Outils > Santé du site, onglet Informations, puis dépliez la section Serveur. Vous y trouverez la valeur de upload_max_filesize (ligne Taille maximale de téléversement de fichier), celle de post_max_size (Taille maximale d’envoi de PHP), la Limite de mémoire PHP et la ligne PHP SAPI, qui indique comment PHP est exécuté : apache2handler pour le module PHP d’Apache (mod_php), fpm-fcgi pour PHP-FPM et cgi-fcgi pour CGI/FastCGI. Pour toute autre valeur, reportez-vous à la documentation de votre hébergeur. La section Traitement des médias affiche quant à elle la Taille de fichier effective maximale retenue par WordPress.

Méthode 1 : passer par le panneau de votre hébergeur

Si votre hébergeur propose, dans son panneau de gestion, une page de configuration de PHP, c’est la méthode la plus simple : vous y modifiez upload_max_filesize et post_max_size sans toucher aux fichiers du site. Cherchez cette page dans la documentation de votre hébergeur.

Méthode 2 : créer un fichier .user.ini

Si la ligne PHP SAPI indique fpm-fcgi ou cgi-fcgi, PHP lit, en plus de sa configuration principale, les fichiers .user.ini placés dans le dossier du script exécuté et dans ses dossiers parents, jusqu’à la racine du site. Créez donc, à la racine de votre installation WordPress (le dossier qui contient wp-config.php), un fichier nommé .user.ini. Son nom commençant par un point, pensez à afficher les fichiers cachés dans votre client FTP.

Ajoutez-y les lignes suivantes, en adaptant les valeurs à vos besoins :

upload_max_filesize = 64M
post_max_size = 72M

La taille limite d’envoi de fichiers sera augmentée à 64 Mo. La valeur de post_max_size doit rester supérieure à celle de upload_max_filesize, puisqu’elle englobe le fichier et les autres données envoyées avec lui. D’après la documentation de PHP, memory_limit devrait à son tour dépasser post_max_size : si la Limite de mémoire PHP de votre site est plus basse, ajoutez une ligne memory_limit avec une valeur supérieure.

PHP ne relit pas ce fichier à chaque visite : il garde son contenu en cache 5 minutes par défaut (directive user_ini.cache_ttl). Patientez donc quelques minutes avant de vérifier le résultat.

Certains hébergeurs demandent plutôt un fichier php.ini, avec la même syntaxe : suivez alors leur documentation. Avec PHP-FPM, un fichier php.ini placé dans le dossier du site n’est en revanche pas lu. N’ajoutez pas non plus dans le fichier .htaccess la ligne suPHP_ConfigPath, que l’on recommandait autrefois pour déclarer ce php.ini : elle ne fonctionne qu’avec le module Apache mod_suphp et, sans lui, provoque une erreur 500 (Internal Server Error) sur tout le site.

Méthode 3 : le fichier .htaccess, uniquement avec mod_php

Si la ligne PHP SAPI indique apache2handler, PHP fonctionne comme module d’Apache et accepte ces directives dans le fichier .htaccess situé à la racine de WordPress. Ajoutez ces lignes en dehors du bloc compris entre # BEGIN WordPress et # END WordPress, que WordPress peut réécrire :

<IfModule mod_php.c>
	php_value upload_max_filesize 64M
	php_value post_max_size 72M
</IfModule>

Le bloc <IfModule mod_php.c>, valable pour PHP 8, évite l’erreur 500 que provoqueraient ces directives avec PHP-FPM ou CGI/FastCGI : elles y sont simplement ignorées, et c’est alors la méthode 2 qui s’applique.

Vérifier le résultat

Rechargez l’écran Médias > Ajouter un fichier média : la taille maximale indiquée doit correspondre à la plus petite de vos deux valeurs, soit 64 Mo dans cet exemple. Si un fichier dépasse encore la limite, la médiathèque affiche « … dépasse la limite de téléversement de ce site. »

Il est possible que d’autres restrictions existent au niveau de votre hébergeur. Par exemple, il est probable que la limite ait augmenté mais pas à la valeur désirée. Dans ce cas, contactez votre hébergeur.

Si vous administrez vous-même un serveur nginx, sa directive client_max_body_size, fixée à 1 Mo par défaut, bloque aussi les envois plus lourds avec une erreur 413 (Request Entity Too Large) : ajoutez par exemple client_max_body_size 72m; dans le bloc server de votre site, puis rechargez nginx.

Enfin, sur un réseau multisite, WordPress applique en plus son propre plafond, réglable dans l’administration du réseau, sous Réglages > Réglages du réseau : champ Taille maximale des fichiers téléversés, fixé à 1 500 Ko par défaut.

Autre limite fréquente à relever : augmenter la limite mémoire PHP de WordPress.