Warum WordPress „The link you followed has expired“ anzeigt
Beheben Sie den WordPress-Fehler mit dem abgelaufenen Link beim Upload. Prüfen Sie PHP-Limits wie post_max_size und wählen Sie die passende Lösung.
WordPress zeigt die Meldung „The link you followed has expired“ (in deutschen Installationen: „Der Link, dem Sie gefolgt sind, ist abgelaufen.“) meist dann an, wenn der Upload größer war als der in PHP über post_max_size festgelegte Grenzwert. PHP verwirft in diesem Fall den gesamten Request, die Nonce-Sicherheitsprüfung von WordPress schlägt fehl, und WordPress meldet diesen Fehler statt eines Hinweises auf die Dateigröße.
Sie ziehen ein 70 MB großes Premium-Theme-ZIP in den Uploader, sehen zu, wie der Fortschrittsbalken durchläuft, und landen auf einer Seite mit einem abgelaufenen Link. Die Meldung deutet auf eine veraltete Sitzung hin, tatsächlich liegt das Problem jedoch an einem Server-Limit.
Dieser Artikel erklärt, warum PHP diese irreführende Meldung erzeugt, welche drei Einstellungen dafür verantwortlich sind, wie Sie Ihre aktuellen Limits auslesen und welche Lösung zu der Art passt, wie PHP auf Ihrem Server läuft.
Das Wichtigste in Kürze
- Überschreitet ein Request den Wert von
post_max_size, lässt PHP$_POSTund$_FILESleer. Dadurch schlägt die Nonce-Prüfung von WordPress fehl und es erscheint „The link you followed has expired“. upload_max_filesizeundpost_max_sizesindINI_PERDIR-Einstellungen. Einini_set()in der functions.php oder in einem Snippet-Plugin kann sie daher nicht ändern.php_value-Zeilen in der .htaccess funktionieren nur, wenn PHP als Apache-Modul läuft. Unter PHP-FPM verwenden Sie stattdessen die .user.ini oder die PHP-Einstellungen Ihres Hosters.WP_MEMORY_LIMITin der wp-config.php steuert den Arbeitsspeicher, nicht die maximale Upload-Größe.- Wenn Sie einen entpackten Theme- oder Plugin-Ordner per SFTP hochladen, umgehen Sie die Upload-Limits von PHP vollständig.
Warum nach einem Upload „The link you followed has expired“ erscheint
Ist ein Request-Body größer als post_max_size, lässt PHP sowohl $_POST als auch $_FILES leer – so ist es im Eintrag zu post_max_size im PHP-Handbuch dokumentiert. Die Nonce, die WordPress in das Upload-Formular eingebettet hat, wird mit genau diesen verworfenen Daten übertragen. WordPress kann einen zu großen Upload deshalb nicht von einer gefälschten oder veralteten Formularübermittlung unterscheiden. Es greift auf wp_nonce_ays() zurück, dessen Standardausgabe „The link you followed has expired.“ mit dem Statuscode 403 lautet.
„The link you followed has expired“ kann auch ganz ohne Upload auftreten. Bleibt eine Admin-Seite lange genug geöffnet, läuft ihre Nonce ab, und beim Absenden des Formulars erscheint derselbe Text. Ein Neuladen der Seite erzeugt eine neue Nonce und behebt das Problem.
Die drei PHP-Einstellungen hinter dem Fehler
Drei PHP-Direktiven steuern große Uploads in WordPress: upload_max_filesize, post_max_size und max_execution_time. Zwei davon verursachen den Fehler mit dem abgelaufenen Link:
| Direktive | Was sie begrenzt | Mit ini_set() änderbar? |
|---|---|---|
upload_max_filesize | Jede einzelne hochgeladene Datei | Nein (INI_PERDIR) |
post_max_size | Den gesamten Request-Body | Nein (INI_PERDIR) |
max_execution_time | Laufzeit des Skripts in Sekunden | Ja |
post_max_size sollte etwas höher als upload_max_filesize angesetzt werden, da der Request zusätzlich Formularfelder und Multipart-Boundaries enthält. Laut PHP-Dokumentation muss post_max_size für das Hochladen großer Dateien größer als upload_max_filesize sein. Auf derselben Seite sind beide Größen-Direktiven als INI_PERDIR aufgeführt. Gemäß dem PHP-Handbuch zu den Modi lassen sich INI_PERDIR-Einstellungen in php.ini, .htaccess, httpd.conf oder .user.ini festlegen, nicht jedoch aus einem laufenden Skript heraus.
Da beide Größen-Direktiven INI_PERDIR sind, können Snippets, die dafür in der functions.php oder in einem Snippet-Plugin ini_set() aufrufen, nicht funktionieren. Selbst wenn man die Regel zu den Änderungsmodi außer Acht lässt: PHP hat den Request-Body bereits angenommen oder verworfen, bevor überhaupt WordPress-Code ausgeführt wird. Ein @ vor dem Aufruf unterdrückt lediglich die Warnung. Manche Tutorials verwenden außerdem upload_max_size – eine PHP-Direktive, die es gar nicht gibt.
Eine Datei, die upload_max_filesize überschreitet, aber unter post_max_size bleibt, scheitert auf andere Weise. PHP liefert die Formulardaten dann trotzdem aus, sodass WordPress einen spezifischen Upload-Fehler zur Dateigröße melden kann. Auch ein Timeout durch max_execution_time sieht anders aus: In der Regel erhalten Sie einen Fatal Error zur maximalen Ausführungszeit oder einen Gateway-Timeout, nicht aber die Meldung zum abgelaufenen Link.
So prüfen Sie Ihre aktuellen Upload-Limits
WordPress zeigt das tatsächlich wirksame Limit an zwei Stellen im Admin-Bereich an:
- Medien > Mediendatei hinzufügen zeigt unterhalb der Drop-Zone die „Maximale Upload-Dateigröße“ an.
- Werkzeuge > Website-Zustand > Bericht enthält einen Abschnitt Server, der die Upload- und Post-Limits von PHP sowie die Ausführungszeit auflistet. Der Abschnitt Medienverarbeitung zeigt die effektive maximale Upload-Größe.
Um herauszufinden, welche Datei Sie bearbeiten müssen, sollten Sie außerdem wissen, wie PHP ausgeführt wird. Legen Sie die folgende temporäre Datei im Web-Root ab, rufen Sie sie im Browser auf und löschen Sie sie anschließend wieder, da sie Serverdetails preisgibt:
<?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";
}
Bedeutung des SAPI-Werts:
apache2handler: PHP läuft als Apache-Modul, Sie können also .htaccess oder php.ini verwenden.fpm-fcgiodercgi-fcgi: Verwenden Sie die .user.ini oder das Panel Ihres Hosters, keinesfallsphp_value.
So erhöhen Sie die PHP-Upload-Limits – vom einfachsten Weg an
Jede der folgenden Methoden erhöht die Upload-Limits, indem sie die PHP-Konfiguration ändert, bevor der Request geparst wird. Nur dort lassen sich diese Limits ändern. Manche Hoster deaktivieren eine oder mehrere dieser Methoden. Wenn eine Änderung also nicht im Website-Zustand auftaucht, probieren Sie die nächste aus oder wenden Sie sich an Ihren Hoster.
1. Control Panel des Hosters
Die meisten Managed- und Shared-Hoster bieten eine Seite mit PHP-Einstellungen bzw. „PHP-Optionen“ an. Dort vorgenommene Änderungen gelten auf Serverebene und erfordern keine Dateibearbeitung. Versuchen Sie es zuerst auf diesem Weg.
2. php.ini oder .user.ini
Bearbeiten Sie auf einem VPS die geladene php.ini, die Ihnen die Diagnosedatei anzeigt, und starten Sie PHP anschließend neu. Bei CGI-/FastCGI-Setups, einschließlich PHP-FPM, legen Sie im WordPress-Stammverzeichnis eine Datei .user.ini an. Beide Dateien verwenden dieselbe Syntax:
; Example values — adjust to your largest expected upload
upload_max_filesize = 64M
post_max_size = 128M
max_execution_time = 300
Geben Sie stets das Einheitensuffix an. PHP interpretiert eine reine Ganzzahl als Bytes – 128 bedeutet also 128 Byte.
Die Seite zur .user.ini im PHP-Handbuch erläutert, dass PHP die Datei im Verzeichnis des aufgerufenen Skripts sowie in jedem übergeordneten Verzeichnis bis hinauf zum Document Root sucht. PHP liest die .user.ini alle user_ini.cache_ttl Sekunden neu ein, standardmäßig alle 300 Sekunden. Eine Änderung an der .user.ini kann daher bis zu fünf Minuten brauchen, bis sie greift. user_ini.cache_ttl ist eine Einstellung auf Systemebene, die Sie nicht über die .user.ini verkürzen können.
3. .htaccess (nur Apache mit mod_php)
# 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
Die PHP-Dokumentation zum Ändern von Konfigurationseinstellungen beschreibt php_value als Direktive für PHP, das als Apache-Modul läuft. Unter PHP-FPM erkennt Apache die Direktive nicht. Je nach Setup ignoriert er die Zeile oder antwortet mit einem 500 Internal Server Error. Nginx liest .htaccess-Dateien überhaupt nicht.
Was nicht funktioniert: wp-config.php
Über die wp-config.php lässt sich das Upload-Limit nicht erhöhen. WP_MEMORY_LIMIT legt fest, wie viel Arbeitsspeicher WordPress von PHP anfordert, und hat keinen Einfluss auf die Upload-Größe. Falls Sie nach einer Konfigurationsänderung eine leere Seite sehen, lesen Sie den Beitrag zur Behebung des WordPress White Screen of Death.
Workaround: Theme oder Plugin per SFTP hochladen
Sie können die Upload-Limits von PHP vollständig umgehen, indem Sie den entpackten Theme- oder Plugin-Ordner per SFTP nach wp-content/themes bzw. wp-content/plugins hochladen. Die Dateien durchlaufen dabei keinen PHP-Request. Entpacken Sie das Archiv lokal und führen Sie dann Folgendes aus:
sftp user@example.com
put -r my-theme /path/to/wp-content/themes/
Der Remote-Pfad unterscheidet sich je nach Hoster. Sobald der Ordner an Ort und Stelle ist, aktivieren Sie ihn unter Design > Themes bzw. unter Plugins. Verwenden Sie SFTP statt einfachem FTP, damit Ihre Zugangsdaten nicht im Klartext übertragen werden. Der OpenReplay-Leitfaden zur Absicherung einer WordPress-Website behandelt dieses und weitere Themen rund um die Härtung des Zugangs.
Die eigentliche Ursache beheben
„The link you followed has expired“ bedeutet in der Regel, dass der Upload größer als post_max_size war – nicht, dass eine Sitzung abgelaufen ist. Führen Sie die Diagnosedatei aus, um zu sehen, wie PHP auf Ihrem Server läuft. Erhöhen Sie dann upload_max_filesize und post_max_size an der passenden Stelle: im Panel Ihres Hosters, in der php.ini oder .user.ini oder – nur unter mod_php – in der .htaccess. Prüfen Sie die neuen Werte im Website-Zustand, bevor Sie den Upload erneut versuchen.
FAQs
Wie lange bleibt eine WordPress-Nonce gültig, bevor sie abläuft?
Eine WordPress-Nonce ist standardmäßig zwischen 12 und 24 Stunden gültig. Der Filter nonce_life hat den Standardwert DAY_IN_SECONDS (86.400 Sekunden), den WordPress in zwei Ticks zu je 12 Stunden aufteilt, wobei der aktuelle und der vorherige Tick akzeptiert werden. Ein Admin-Formular, das über Nacht geöffnet bleibt, kann daher mit der Meldung zum abgelaufenen Link scheitern. Entwickler können die Lebensdauer über den Filter nonce_life anpassen, eine globale Verkürzung führt jedoch dazu, dass diese Fehler häufiger auftreten.
Warum erhalte ich statt der Meldung zum abgelaufenen Link einen Fehler 413 Request Entity Too Large?
Ein Fehler 413 bedeutet, dass Nginx den Upload abgelehnt hat, bevor PHP ihn überhaupt zu sehen bekam. Die Nginx-Direktive client_max_body_size hat den Standardwert 1m, und jeder Request-Body oberhalb dieses Werts wird sofort abgewiesen. Erhöhen Sie den Wert im http-, server- oder location-Block, der wp-admin verarbeitet, und laden Sie Nginx anschließend neu. Danach müssen upload_max_filesize und post_max_size in PHP weiterhin erhöht werden, und ein vorgeschaltetes CDN oder ein Reverse Proxy kann ein eigenes Limit durchsetzen.
Warum zeigt WordPress eine niedrigere maximale Upload-Größe an als meinen Wert für upload_max_filesize?
WordPress zeigt über seine Funktion wp_max_upload_size() den kleineren der beiden Werte upload_max_filesize und post_max_size als maximale Upload-Größe an. Ist upload_max_filesize auf 256M, post_max_size aber auf 64M gesetzt, beträgt das effektive Limit 64M. Wird nur eine der beiden Direktiven erhöht, bleibt das angezeigte Limit unverändert. Setzen Sie post_max_size etwas höher als upload_max_filesize und prüfen Sie anschließend beide Werte im Abschnitt Server des Website-Zustands.
Kann WP-CLI ein Theme- oder Plugin-ZIP installieren, ohne an die PHP-Upload-Limits zu stoßen?
Ja. WP-CLI läuft auf der Kommandozeile des Servers, sodass das ZIP nie über einen Browser-Upload übertragen wird und post_max_size nicht greift. Kopieren Sie das ZIP per SFTP auf den Server und führen Sie anschließend wp theme install /path/to/theme.zip --activate oder wp plugin install /path/to/plugin.zip --activate aus. Beide Befehle akzeptieren einen WordPress.org-Slug, einen lokalen ZIP-Pfad oder eine Remote-ZIP-URL. Voraussetzung ist SSH-Zugriff.
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