Dépannage WordPress
Erreur de téléversement WordPress : taille, type ou serveur ?
Diagnostiquer un téléversement WordPress refusé selon le code réel, le type, la taille, les limites PHP et les droits.
Lire le conseilUn fichier refusé par WordPress n’est pas forcément trop lourd. La requête peut être bloquée avant d’atteindre le site, dépasser une limite PHP, échouer à l’écriture ou être rejetée pour son type. Une image peut aussi être transférée correctement, puis poser problème au moment de créer ses miniatures. Le message exact permet de choisir le bon diagnostic.
Identifier l’étape qui bloque le téléversement
Notez l’heure, le message, le compte utilisé, le poids du fichier et son extension. Reproduisez avec un petit fichier connu et autorisé, sans utiliser de document confidentiel. Dans les outils réseau du navigateur, relevez le statut de la requête et sa réponse. N’exportez pas un journal complet contenant cookies, jetons ou données du formulaire.
- La requête reçoit une réponse HTTP 413 : sa taille dépasse une limite appliquée par un serveur. Identifiez celui qui répond avant de modifier PHP ou WordPress.
- WordPress refuse le type ou l’autorisation : examinez le format réel, les droits du compte et les règles du site, plutôt que d’augmenter le plafond de poids.
- Le fichier apparaît mais son traitement échoue : vérifiez l’original et les fichiers générés avant de recommencer. Le transfert et la création des miniatures sont deux étapes distinctes.
Une erreur403, un délai dépassé ou une réponse vide ne désignent pas à eux seuls une limite de taille. Croisez le résultat avec le journal de la même requête, côté serveur ou prestataire. Gardez seulement les informations utiles et accessibles aux personnes autorisées.
Comparer les limites réellement utilisées
Commencez par le plafond affiché dans la médiathèque et par les réglages du formulaire ou de l’extension concernée. Contrôlez ensuite les valeurs PHP chargées par le site web : la configuration d’un terminal peut être différente de celle utilisée pour la requête. Un réglage modifié dans le mauvais fichier ne corrige pas la limite active.
upload_max_filesize limite un fichier ; post_max_size porte sur l’ensemble des données de la requête POST. Ce second plafond doit donc laisser de la place aux autres champs et à l’encapsulation du formulaire. Dans son calcul standard, WordPress tient compte de ces limites PHP ; des filtres ou des règles supplémentaires peuvent encore réduire ce qui est accepté.
Le proxy, le serveur web, le CDN ou une protection intermédiaire peuvent intervenir avant PHP. Un quota d’hébergement ou de réseau multisite peut aussi limiter l’espace disponible. Pour une réponse 413, retrouvez la limite de la couche qui a refusé la requête. Ne relevez pas toutes les valeurs au hasard : fixez un besoin raisonnable et vérifiez chaque maillon concerné.
Lire l’erreur PHP sans la confondre avec un problème de droits
Lorsqu’un formulaire multipart est traité par PHP, l’entrée error du fichier reçu peut préciser l’échec. UPLOAD_ERR_INI_SIZE indique un dépassement du plafond PHP pour le fichier. UPLOAD_ERR_PARTIAL signale un transfert incomplet : contrôlez d’abord ce qui a interrompu la requête, sans conclure immédiatement à un disque plein.
UPLOAD_ERR_NO_TMP_DIR indique l’absence du dossier temporaire attendu. UPLOAD_ERR_CANT_WRITE signale un échec d’écriture sur disque. Dans ces cas, vérifiez le dossier réellement utilisé, son propriétaire, les accès nécessaires et le quota du compte. Le volume du serveur peut avoir de l’espace libre alors que le quota attribué au site est atteint.
Le détail de ce dernier cas est traité dans le guide sur l’échec d’écriture des fichiers WordPress. Donner tous les droits à tout le monde ou changer récursivement les permissions de l’hébergement ne constitue pas un diagnostic. Corrigez seulement le chemin et l’accès confirmés, avec les valeurs précédentes disponibles.
Vérifier le type réel et le traitement du média
L’extension du nom et le contenu du fichier doivent être cohérents. WordPress contrôle notamment le type et les formats autorisés pendant le téléversement. Renommer simplement une extension ou désactiver globalement ces vérifications peut masquer un problème et ouvrir des risques inutiles. Si un nouveau format est nécessaire, faites examiner son traitement et les comptes autorisés avant de l’ajouter.
Pour une image, un transfert terminé ne garantit pas que toutes les tailles dérivées ont été produites. Vérifiez si l’original est accessible, puis si les miniatures attendues existent et correspondent à la pièce jointe. Une image lourde à traiter peut échouer à cette étape même si son poids respecte le plafond d’envoi. Essayez une copie aux dimensions adaptées, en conservant l’original utile.
Si le média est bien enregistré mais s’affiche mal dans une page, poursuivez avec le diagnostic des images WordPress cassées. Distinguez un fichier absent, une taille manquante et une ancienne URL conservée dans un cache. Cela évite de téléverser plusieurs fois le même média sans corriger l’affichage.
Valider le correctif avec des fichiers maîtrisés
Avant de modifier une configuration ou des fichiers en production, vérifiez qu’une sauvegarde restaurable existe et conservez les réglages précédents. Pour une limite ou une autorisation sensible, commencez sur un environnement isolé avec un compte au rôle adapté. Ne créez pas silencieusement un compte administrateur de test sur le site public.
- Cas accepté : un petit fichier autorisé est enregistré, accessible et correctement traité dans la médiathèque puis dans la page concernée.
- Cas limité : un fichier sous le plafond annoncé fonctionne ; un dépassement contrôlé affiche une erreur compréhensible, sans laisser de doublon ou de fichier partiel inutile.
- Cas de droits ou de format : un compte ou un fichier non autorisé reste refusé, sans élargissement global des permissions pour faire passer le test.
Retirez ensuite les médias de test devenus inutiles et leurs variantes, après avoir vérifié qu’aucune page ne les utilise. Comparez l’espace disponible et contrôlez les autres parcours qui partagent le réglage modifié. Si le blocage vient du quota ou de la couche d’hébergement, transmettez au prestataire le statut, l’heure et le message précis plutôt que de multiplier les tentatives.
Références officielles
Les constantes d’erreur de téléversement PHP, la gestion des fichiers reçus par POST, le mécanisme de téléversement de WordPress et la définition du statut HTTP 413 permettent de confirmer le diagnostic. Les réglages doivent correspondre à l’environnement du site et au composant qui traite réellement la requête.
