Pourquoi WordPress affiche « The link you followed has expired »
Corrigez l’erreur de lien expiré de WordPress lors des téléversements. Découvrez le rôle des limites PHP, vérifiez-les et choisissez la bonne solution.
WordPress affiche généralement « The link you followed has expired » (« Le lien que vous avez suivi a expiré » sur une installation en français) parce que le fichier téléversé dépassait la limite post_max_size de PHP. PHP rejette alors l’intégralité de la requête, la vérification du nonce de sécurité de WordPress échoue, et WordPress signale cet échec au lieu d’une erreur de taille de fichier.
Vous glissez l’archive zip de 70 Mo d’un thème premium dans l’outil de téléversement, la barre de progression arrive au bout, et vous obtenez une page évoquant un lien expiré. Le message laisse penser à une session périmée, mais le véritable problème est une limite côté serveur.
Cet article explique pourquoi PHP produit ce message trompeur, quels sont les trois paramètres qui en sont à l’origine, comment consulter vos limites actuelles et quelle correction appliquer selon la façon dont votre serveur exécute PHP.
Points clés
- Lorsqu’une requête dépasse
post_max_size, PHP laisse$_POSTet$_FILESvides : la vérification du nonce de WordPress échoue et le message « The link you followed has expired » s’affiche. upload_max_filesizeetpost_max_sizesont des paramètresINI_PERDIR: un appel àini_set()dans functions.php ou dans une extension de snippets ne peut pas les modifier.- Les lignes
php_valuedans .htaccess ne fonctionnent que lorsque PHP tourne en tant que module Apache. Sous PHP-FPM, utilisez plutôt .user.ini ou les réglages PHP de votre hébergeur. WP_MEMORY_LIMITdans wp-config.php contrôle la mémoire, pas la taille maximale de téléversement.- Téléverser le dossier décompressé d’un thème ou d’une extension via SFTP permet de contourner entièrement les limites de téléversement de PHP.
Pourquoi le lien a expiré après un téléversement
Lorsque le corps d’une requête dépasse post_max_size, PHP laisse $_POST et $_FILES vides, comme le précise l’entrée post_max_size du manuel PHP. Le nonce que WordPress a intégré au formulaire de téléversement fait partie de ces données rejetées : WordPress ne peut donc pas distinguer un téléversement trop volumineux d’une soumission falsifiée ou périmée. Il se rabat alors sur wp_nonce_ays(), dont la sortie par défaut est « The link you followed has expired. » avec un code de statut 403.
Le message « The link you followed has expired » peut aussi apparaître sans aucun téléversement. Si une page d’administration reste ouverte suffisamment longtemps, son nonce expire et l’envoi du formulaire produit le même texte. Recharger la page génère un nouveau nonce et règle le problème.
Les trois paramètres PHP à l’origine de l’erreur
Trois directives PHP régissent les téléversements volumineux dans WordPress : upload_max_filesize, post_max_size et max_execution_time. Deux d’entre elles provoquent l’erreur de lien expiré :
| Directive | Ce qu’elle limite | Modifiable avec ini_set() ? |
|---|---|---|
upload_max_filesize | Chaque fichier téléversé | Non (INI_PERDIR) |
post_max_size | L’intégralité du corps de la requête | Non (INI_PERDIR) |
max_execution_time | Durée d’exécution du script, en secondes | Oui |
post_max_size doit être légèrement supérieur à upload_max_filesize, car la requête transporte aussi les champs du formulaire et les délimiteurs multipart. La documentation PHP indique que, pour téléverser des fichiers volumineux, post_max_size doit être supérieur à upload_max_filesize. La même page classe les deux directives de taille comme INI_PERDIR. D’après le manuel PHP sur les modes, les paramètres INI_PERDIR peuvent être définis dans php.ini, .htaccess, httpd.conf ou .user.ini, mais pas depuis un script en cours d’exécution.
Puisque ces deux directives de taille sont INI_PERDIR, les snippets qui appellent ini_set() pour les modifier dans functions.php ou dans une extension de snippets ne peuvent pas fonctionner. Et même sans tenir compte de cette règle sur les modes de modification, PHP a déjà accepté ou rejeté le corps de la requête avant que le moindre code WordPress ne s’exécute. Un @ devant l’appel ne fait que masquer l’avertissement. Certains tutoriels utilisent également upload_max_size, qui n’est tout simplement pas une directive PHP.
Un fichier qui dépasse upload_max_filesize mais reste sous post_max_size échoue différemment. PHP transmet malgré tout les données du formulaire, si bien que WordPress peut signaler une erreur de téléversement liée à la taille. Un dépassement de max_execution_time se manifeste lui aussi autrement : vous obtenez généralement une erreur fatale mentionnant le temps d’exécution maximal ou un timeout de la passerelle (gateway timeout), et non le message de lien expiré.
Comment vérifier vos limites de téléversement actuelles
WordPress affiche la limite effective à deux endroits dans l’administration :
- Médias > Ajouter un fichier média indique la « Taille de fichier maximale pour le téléversement » sous la zone de dépôt.
- Outils > Santé du site > Infos comporte une section Serveur qui liste les limites de téléversement et de POST de PHP ainsi que le temps d’exécution. La section Gestion des médias affiche la taille maximale effective de téléversement.
Pour savoir quel fichier modifier, vous devez aussi savoir comment PHP est exécuté. Placez ce fichier temporaire à la racine web, ouvrez-le dans un navigateur, puis supprimez-le, car il expose des informations sur le serveur :
<?php
echo 'SAPI: ' . PHP_SAPI . "\n";
echo 'Loaded php.ini: ' . (php_ini_loaded_file() ?: 'none') . "\n";
echo 'user_ini.filename: ' . ini_get('user_ini.filename') . "\n";
foreach (['upload_max_filesize', 'post_max_size', 'max_execution_time'] as $k) {
echo $k . ': ' . ini_get($k) . "\n";
}
Signification de la valeur SAPI :
apache2handler: PHP tourne en tant que module Apache, vous pouvez donc utiliser .htaccess ou php.ini.fpm-fcgioucgi-fcgi: utilisez .user.ini ou le panneau de votre hébergeur, et jamaisphp_value.
Comment augmenter les limites de téléversement PHP, de la méthode la plus simple à la plus technique
Chacune des méthodes ci-dessous augmente les limites de téléversement en modifiant la configuration de PHP avant l’analyse de la requête. C’est le seul endroit où ces limites peuvent être modifiées. Certains hébergeurs désactivent une ou plusieurs de ces méthodes : si une modification n’apparaît pas dans Santé du site, essayez la suivante ou contactez votre hébergeur.
1. Panneau de contrôle de l’hébergeur
La plupart des hébergeurs mutualisés et infogérés proposent un écran de réglages PHP ou d’« options PHP ». Les modifications effectuées à cet endroit s’appliquent au niveau du serveur et ne nécessitent aucune édition de fichier. Commencez par là.
2. php.ini ou .user.ini
Sur un VPS, modifiez le php.ini chargé indiqué par le fichier de diagnostic, puis redémarrez PHP. Sur les configurations CGI/FastCGI, y compris PHP-FPM, créez un fichier .user.ini à la racine de WordPress. Les deux fichiers utilisent la même syntaxe :
; Example values — adjust to your largest expected upload
upload_max_filesize = 64M
post_max_size = 128M
max_execution_time = 300
Indiquez toujours le suffixe d’unité. PHP interprète un entier seul comme un nombre d’octets : 128 signifie donc 128 octets.
La page du manuel PHP consacrée à .user.ini explique que PHP recherche ce fichier dans le répertoire du script demandé, puis dans chaque répertoire parent jusqu’à la racine des documents. PHP relit .user.ini toutes les user_ini.cache_ttl secondes, soit 300 par défaut. Une modification de .user.ini peut donc mettre jusqu’à cinq minutes à s’appliquer. user_ini.cache_ttl étant un paramètre de niveau système, vous ne pouvez pas réduire ce délai depuis .user.ini.
3. .htaccess (Apache avec mod_php uniquement)
# Example values — Apache with PHP as a module only
php_value upload_max_filesize 64M
php_value post_max_size 128M
php_value max_execution_time 300
La documentation PHP sur la modification des paramètres de configuration présente php_value comme une directive destinée à PHP exécuté en tant que module Apache. Sous PHP-FPM, Apache ne reconnaît pas cette directive. Selon la configuration, il ignore la ligne ou renvoie une erreur 500 Internal Server Error. Quant à Nginx, il ne lit pas du tout les fichiers .htaccess.
Ce qui ne fonctionne pas : wp-config.php
wp-config.php ne permet pas d’augmenter la limite de téléversement. WP_MEMORY_LIMIT définit la quantité de mémoire que WordPress demande à PHP et n’a aucun effet sur la taille des téléversements. Si une modification de configuration vous laisse face à une page blanche, consultez notre guide pour corriger l’écran blanc de la mort de WordPress.
Solution de contournement : téléverser le thème ou l’extension via SFTP
Vous pouvez contourner entièrement les limites de téléversement de PHP en envoyant le dossier décompressé du thème ou de l’extension dans wp-content/themes ou wp-content/plugins via SFTP. Les fichiers ne transitent alors jamais par une requête PHP. Décompressez l’archive en local, puis :
sftp user@example.com
put -r my-theme /path/to/wp-content/themes/
Le chemin distant varie selon l’hébergeur. Une fois le dossier en place, activez le thème dans Apparence > Thèmes ou l’extension dans Extensions. Utilisez SFTP plutôt que le FTP classique afin que vos identifiants ne soient pas transmis en clair. Le guide d’OpenReplay sur la sécurisation d’un site WordPress aborde ce point ainsi que d’autres mesures de renforcement des accès.
Corriger la véritable cause
Le message « The link you followed has expired » signifie généralement que le fichier téléversé dépassait post_max_size, et non qu’une session a expiré. Exécutez le fichier de diagnostic pour savoir comment PHP tourne sur votre serveur. Augmentez ensuite upload_max_filesize et post_max_size à l’endroit adapté : le panneau de votre hébergeur, php.ini ou .user.ini, ou .htaccess uniquement sous mod_php. Vérifiez les nouvelles valeurs dans Santé du site avant de relancer le téléversement.
FAQ
Combien de temps un nonce WordPress reste-t-il valide avant d'expirer ?
Par défaut, un nonce WordPress reste valide entre 12 et 24 heures. Le filtre nonce_life vaut par défaut DAY_IN_SECONDS (86 400 secondes), et WordPress découpe cette durée en deux périodes (ticks) de 12 heures, en acceptant la période en cours et la précédente. Un formulaire d'administration resté ouvert toute la nuit peut donc échouer avec le message de lien expiré. Les développeurs peuvent modifier cette durée de vie avec le filtre nonce_life, mais la réduire globalement rend ces erreurs plus fréquentes.
Pourquoi est-ce que j'obtiens une erreur 413 Request Entity Too Large au lieu du message de lien expiré ?
Une erreur 413 signifie que Nginx a rejeté le téléversement avant même que PHP ne le reçoive. La directive client_max_body_size de Nginx vaut 1m par défaut, et tout corps de requête qui dépasse cette valeur est immédiatement refusé. Augmentez-la dans le bloc http, server ou location qui gère wp-admin, puis rechargez Nginx. Il faudra ensuite augmenter également upload_max_filesize et post_max_size côté PHP, et un CDN ou un reverse proxy placé devant le site peut imposer sa propre limite.
Pourquoi WordPress affiche-t-il une taille maximale de téléversement inférieure à ma valeur upload_max_filesize ?
WordPress affiche comme taille maximale de téléversement la plus petite des deux valeurs entre upload_max_filesize et post_max_size, via sa fonction wp_max_upload_size(). Si upload_max_filesize vaut 256M mais que post_max_size vaut 64M, la limite effective est de 64M. Augmenter une seule des deux directives ne modifie donc pas la limite affichée. Définissez post_max_size légèrement au-dessus de upload_max_filesize, puis vérifiez les deux valeurs dans la section Serveur de Santé du site.
WP-CLI permet-il d'installer l'archive zip d'un thème ou d'une extension sans se heurter aux limites de téléversement de PHP ?
Oui. WP-CLI s'exécute en ligne de commande sur le serveur : l'archive zip ne passe jamais par un téléversement via le navigateur et post_max_size ne s'applique pas. Copiez l'archive sur le serveur via SFTP, puis exécutez wp theme install /path/to/theme.zip --activate ou wp plugin install /path/to/plugin.zip --activate. Les deux commandes acceptent un slug WordPress.org, le chemin d'une archive zip locale ou l'URL d'une archive zip distante. Un accès SSH est nécessaire.
Gain Debugging Superpowers
Unleash the power of session replay to reproduce bugs, track slowdowns and uncover frustrations in your app. Get complete visibility into your frontend with OpenReplay — the most advanced open-source session replay tool for developers.
Star on GitHub12k