Zurück zum Blog

WordPress Upload-Limit erhöhen: upload_max_filesize anpassen

WordPress Upload-Limit erhöhen: So beheben Sie den Fehler upload_max_filesize in cPanel, DirectAdmin, per .user.ini, .htaccess oder auf dem eigenen Server.

Nodesty-Team9 Min. LesezeitHosting
Der Schriftzug WordPress Upload Limit mit upload_max_filesize auf dunklem Nodesty-Hintergrund

Wer das WordPress Upload-Limit erhöhen möchte, hat meist gerade die Meldung „The uploaded file exceeds the upload_max_filesize directive in php.ini“ gesehen. Sie wollen ein Theme, ein Plugin, ein Video oder ein Backup hochladen, und WordPress lehnt ab, weil die Datei größer ist, als PHP erlaubt. Das Limit ist gar keine WordPress-Einstellung: Es stammt aus einer Handvoll PHP-Direktiven und manchmal vom Webserver, der vor PHP steht.

In dieser Anleitung zeigen wir, wo das Limit sichtbar wird, welche PHP-Direktiven dahinterstecken, wie Sie es in cPanel und DirectAdmin, per .user.ini oder .htaccess und auf dem eigenen vServer mit PHP-FPM und Nginx anheben, warum die wp-config.php nicht hilft, was bei Multisite gilt, wie Sie große Dateien per SFTP hochladen und wie Sie das neue Limit prüfen.

Wo zeigt sich das Limit?

Öffnen Sie Medien → Neue Mediendatei hinzufügen (in älteren Versionen Datei hinzufügen). Unter dem Upload-Feld nennt WordPress das aktuelle Limit, zum Beispiel „Maximale Dateigröße für Uploads: 2 MB.“ (englisch „Maximum upload file size: 2 MB.“). Was bei einer größeren Datei passiert, hängt davon ab, wo Sie sie hochladen:

Wo?Meldung
Medien-Uploadervideo.mp4 exceeds the maximum upload size for this site.
Plugin- oder Theme-UploadThe uploaded file exceeds the upload_max_filesize directive in php.ini.
Plugin oder Theme oberhalb von post_max_sizeThe link you followed has expired.
Jeder Upload hinter Nginx mit niedrigem Limit413 Request Entity Too Large

Auf deutschsprachigen Websites erscheinen die WordPress-Meldungen übersetzt, die Namen der Direktiven wie upload_max_filesize bleiben aber gleich. Alle vier haben dieselbe Ursache: Ein Größenlimit auf dem Server ist kleiner als Ihre Datei.

Die PHP-Einstellungen hinter dem Limit

Bei einer einzelnen Website liest WordPress zwei PHP-Werte aus und zeigt den kleineren an: upload_max_filesize und post_max_size. Drei weitere Einstellungen entscheiden, ob ein großer Upload tatsächlich durchläuft.

DirektiveWas sie begrenztÜblicher StandardSinnvoller Wert
upload_max_filesizeGröße einer einzelnen hochgeladenen Datei2M64M
post_max_sizeDie gesamte Anfrage: alle Dateien plus Formularfelder8M64M
memory_limitSpeicher, den ein Skript nutzen darf128M256M
max_execution_timeSekunden, die ein Skript laufen darf30300
max_input_timeSekunden, die PHP für das Einlesen des Uploads hat60300
  • post_max_size muss gleich groß oder größer sein als upload_max_filesize; sonst ist der kleinere Wert Ihr tatsächliches Limit. Etwas mehr schadet nicht.
  • Das PHP-Handbuch empfiehlt, memory_limit höher zu halten als post_max_size.
  • Die Zeitlimits spielen bei langsamen Verbindungen eine Rolle und bei der Arbeit nach dem Upload, etwa beim Entpacken eines Themes oder beim Erzeugen der Bildgrößen.
  • Wählen Sie Werte, die zu Ihrer größten Datei passen. Sehr hohe Limits erlauben es einer einzelnen fehlerhaften oder missbräuchlichen Anfrage, die Ressourcen des Servers aufzubrauchen.

Limit in cPanel erhöhen

  1. Öffnen Sie im Bereich Software den MultiPHP INI Editor.
  2. Wählen Sie im Basic Mode im Auswahlmenü Ihre Domain.
  3. Tragen Sie upload_max_filesize und post_max_size ein, bei Bedarf auch memory_limit, max_execution_time und max_input_time.
  4. Klicken Sie auf Apply.

cPanel schreibt die Werte für Sie in die Dateien php.ini, .user.ini und .htaccess dieses Ordners; bearbeiten Sie den erzeugten Block deshalb nicht von Hand. Auf Servern mit CloudLinux öffnen Sie Select PHP Version → Options und wählen die Werte aus den Listen; diese Optionen gehören zur gewählten PHP-Version, nach einem Versionswechsel müssen Sie sie also erneut setzen. Beide Ansichten zeigt unsere Anleitung PHP-Version ändern. Wird der benötigte Wert nicht angeboten oder greift er nicht, hat der Anbieter ihn für Ihren Tarif gedeckelt; wenden Sie sich an den Support.

Limit in DirectAdmin erhöhen

DirectAdmin sieht je nach Skin und je nachdem, was Ihr Anbieter freigeschaltet hat, unterschiedlich aus. Zwei Stellen sind üblich:

  • PHP Settings (PHP-Einstellungen): Wählen Sie die Domain, fügen Sie die Direktive aus der Liste (zum Beispiel upload_max_filesize) mit dem neuen Wert hinzu und speichern Sie. Jede Domain behält ihre eigenen Werte.
  • Select PHP Version → Options: Auf Servern mit CloudLinux dieselbe Ansicht wie in cPanel.

Gibt es keine der beiden oder fehlt die gesuchte Direktive in der Liste, nutzen Sie die .user.ini aus dem nächsten Abschnitt oder fragen Sie Ihren Anbieter; die serverweite php.ini liegt in der Hand des Administrators.

Per .user.ini

Mit PHP-FPM, FastCGI und LiteSpeed liest PHP eine Datei .user.ini aus dem Ordner der Website. Legen Sie sie im Stammordner der Website an (meist public_html, neben der wp-config.php), mit dem Dateimanager oder per SFTP:

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 300
max_input_time = 300

PHP hält diese Datei im Cache und liest sie standardmäßig alle fünf Minuten neu ein (user_ini.cache_ttl); warten Sie also ein paar Minuten, bevor Sie prüfen. Läuft PHP als Apache-Modul (mod_php), wird die .user.ini nicht gelesen, und Limits, die der Serveradministrator gesperrt hat, kann sie nicht überschreiten.

Per .htaccess (php_value)

Läuft PHP als Apache-Modul (mod_php) oder liegt die Website auf LiteSpeed, können Sie die Werte in die .htaccess im Stammordner der Website schreiben. Setzen Sie die Zeilen oberhalb von # BEGIN WordPress, denn den Block zwischen seinen eigenen Markierungen kann WordPress überschreiben:

php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value memory_limit 256M
php_value max_execution_time 300
php_value max_input_time 300

Achtung: Auf Apache mit PHP-FPM oder einer anderen CGI-Anbindung kennt Apache php_value nicht, und die gesamte Website antwortet mit 500 Internal Server Error (im Fehlerprotokoll steht Invalid command 'php_value'). Entfernen Sie die Zeilen, dann läuft die Website wieder; nutzen Sie dort die .user.ini. Nginx ignoriert die .htaccess vollständig. Wissen Sie nicht, womit Ihre Website läuft, sehen Sie unter Werkzeuge → Website-Zustand → Bericht im Abschnitt Server in der Zeile PHP SAPI nach: apache2handler steht für mod_php, fpm-fcgi für PHP-FPM und litespeed für LiteSpeed.

Auf dem eigenen vServer: php.ini und PHP-FPM

Unter Ubuntu und Debian hat jede PHP-Version und jede Betriebsart von PHP eine eigene php.ini. Für PHP-FPM mit PHP 8.3 ist es /etc/php/8.3/fpm/php.ini; ls /etc/php/ zeigt die installierten Versionen. /etc/php/8.3/cli/php.ini gilt nur für die Kommandozeile, deshalb kann php -i andere Werte anzeigen als die Website.

sudo nano /etc/php/8.3/fpm/php.ini

Suchen Sie die vorhandenen Zeilen und ändern Sie sie, bei Bedarf zusammen mit den übrigen Werten aus der Tabelle:

upload_max_filesize = 64M
post_max_size = 64M

PHP-FPM liest die Datei nur beim Start, starten Sie den Dienst also neu:

sudo systemctl restart php8.3-fpm

Mit Apache und mod_php heißt die Datei /etc/php/8.3/apache2/php.ini, und Sie starten mit sudo systemctl restart apache2 neu. Unter AlmaLinux liegt die Datei unter /etc/php.ini, und der Dienst heißt php-fpm.

413 Request Entity Too Large: das Limit von Nginx

Nginx hat ein eigenes Limit, client_max_body_size, und dessen Standardwert beträgt nur 1 MB. Eine größere Anfrage erreicht PHP gar nicht erst: Nginx antwortet mit 413 Request Entity Too Large, was der Medien-Uploader oft nur als allgemeinen HTTP-Fehler anzeigt. Das ist ein anderes Limit als upload_max_filesize, Sie müssen also beide anheben. Tragen Sie die Zeile im http-Block der /etc/nginx/nginx.conf oder im server-Block der Website ein:

client_max_body_size 64m;
sudo nginx -t
sudo systemctl reload nginx

Arbeitet Nginx als Reverse Proxy vor Apache oder einem Container, gilt das Limit auch dort; die Konfiguration beschreibt unsere Anleitung Nginx installieren. Ein Proxy-Dienst wie Cloudflare bringt zusätzlich eine eigene Upload-Grenze mit, im kostenlosen Tarif 100 MB.

Warum die wp-config.php das Limit nicht erhöht

Viele Anleitungen empfehlen eine Zeile wie @ini_set( 'upload_max_filesize', '64M' ); in der wp-config.php oder in der functions.php des Themes. Sie bleibt wirkungslos: PHP nimmt den Upload entgegen und prüft ihn, bevor die erste Zeile von WordPress läuft, und upload_max_filesize und post_max_size lassen sich zur Laufzeit nicht mit ini_set() ändern. Sie können nur in der php.ini, der .user.ini oder der Konfiguration des Webservers gesetzt werden.

define( 'WP_MEMORY_LIMIT', '256M' ); ist eine echte Einstellung, hebt aber nur den Speicher an, den WordPress anfordert; das hilft bei den Speicherfehlern aus unserer Anleitung Kritischer Fehler in WordPress. Das Upload-Limit bleibt, wo es ist. Auch Plugins können das PHP-Limit nicht ändern; manche umgehen es, indem sie die Datei in kleinen Teilen senden, sauberer ist es aber, die Servereinstellung zu korrigieren.

WordPress Multisite: Max upload file size

In einem Multisite-Netzwerk kommt zum PHP-Limit ein weiteres hinzu. Öffnen Sie in der Netzwerkverwaltung Einstellungen → Netzwerk-Einstellungen (Network Admin → Settings → Network Settings) und suchen Sie bei den Upload-Einstellungen (Upload Settings) das Feld Max upload file size. Der Wert wird in KB angegeben und beträgt standardmäßig 1500 KB, also rund 1,5 MB; die Websites eines neuen Netzwerks bleiben deshalb bei diesem Limit, auch wenn PHP 64 MB erlaubt. Tragen Sie zum Beispiel 65536 für 64 MB ein und speichern Sie. Es gilt immer das kleinere der beiden Limits, und Site upload space im selben Abschnitt kann zusätzlich den gesamten Speicherplatz pro Website begrenzen.

Ausweg: große Dateien per SFTP hochladen

Für eine einzelne große Datei müssen Sie gar nichts anheben:

  • Plugins und Themes: Entpacken Sie das Archiv auf Ihrem Computer, laden Sie den Ordner per SFTP nach wp-content/plugins oder wp-content/themes hoch und aktivieren Sie ihn in wp-admin.
  • Ganze Websites: Schieben Sie kein mehrere Gigabyte großes Backup durch das Upload-Formular eines Plugins. Übertragen Sie Dateien und Datenbank direkt, wie in unserer Anleitung Website umziehen beschrieben.
  • Mediendateien: Eine Datei, die Sie nach wp-content/uploads kopieren, erscheint nicht von selbst in der Mediathek, weil jeder Eintrag einen Datensatz in der Datenbank braucht. Laden Sie die Datei in Ihr Home-Verzeichnis hoch und registrieren Sie sie per SSH mit WP-CLI:
cd ~/public_html
wp media import ~/big-video.mp4

wp media import kopiert die Datei in den Uploads-Ordner und legt den Eintrag in der Mediathek an; liegt die Datei bereits in wp-content/uploads, ergänzen Sie --skip-copy.

Das neue Limit prüfen

  • Medien → Neue Mediendatei hinzufügen: Die Zahl unter dem Upload-Feld sollte den neuen Wert zeigen.
  • Werkzeuge → Website-Zustand → Bericht: Der Abschnitt Server listet die Werte von upload_max_filesize, post_max_size, memory_limit, max_execution_time und max_input_time auf (auf englischsprachigen Websites Zeilen wie „Upload max filesize“ und „PHP post max size“). Für diese Seite brauchen Sie ein Administratorkonto; kommen Sie nicht mehr hinein, hilft unsere Anleitung WordPress Passwort zurücksetzen.

Steht dort noch der alte Wert, prüfen Sie die üblichen Verdächtigen: post_max_size ist noch kleiner, der Cache der .user.ini ist noch nicht abgelaufen, Sie haben die php.ini einer anderen PHP-Version oder der Kommandozeile bearbeitet, PHP-FPM wurde nicht neu gestartet, der Anbieter deckelt den Wert oder die Multisite-Einstellung ist niedriger.

WordPress bei Nodesty

Das Webhosting von Nodesty betreibt WordPress-Websites auf Servern mit AMD Ryzen 9 7900, dem Webserver LiteSpeed und NVMe-Speicher. Die PHP-Version wählen Sie in cPanel oder DirectAdmin, ebenso bearbeiten Sie dort php.ini-Einstellungen wie upload_max_filesize und post_max_size; kostenloses SSL, Imunify360 und Backups über JetBackup sind enthalten. Möchten Sie jedes Limit selbst festlegen, von der php.ini bis zu client_max_body_size, bieten unsere AMD Ryzen 9 9950X vServer vollen Root-Zugriff und kostenlose tägliche Backups mit 7 Tagen Aufbewahrung. Eine Neuinstallation beschreibt unsere Anleitung WordPress installieren, und zeigt die Website stattdessen eine Datenbankmeldung, hilft WordPress: Fehler beim Aufbau einer Datenbankverbindung.

Häufig gestellte Fragen

Wie hoch ist das Upload-Limit von WordPress standardmäßig?

Bei einer einzelnen Website hat WordPress kein eigenes festes Limit. Es zeigt den kleineren der beiden PHP-Werte upload_max_filesize und post_max_size an. Die Standardwerte von PHP selbst sind 2 MB und 8 MB, Hosting-Anbieter setzen meist höhere Werte, deshalb unterscheidet sich das Limit von Anbieter zu Anbieter.

Was bedeutet The uploaded file exceeds the upload_max_filesize directive in php.ini?

Die Datei, die Sie hochladen wollten, ist größer, als die PHP-Einstellung upload_max_filesize erlaubt, und PHP hat sie abgelehnt, bevor WordPress sie verarbeiten konnte. Erhöhen Sie upload_max_filesize und post_max_size im Control Panel, in einer .user.ini oder in der php.ini, oder laden Sie die Datei stattdessen per SFTP hoch.

Ich habe die Werte geändert, aber das Limit ist gleich geblieben. Warum?

Meist ist post_max_size noch kleiner als upload_max_filesize, die Änderung wurde für eine andere PHP-Version oder in der php.ini der Kommandozeile vorgenommen, PHP-FPM wurde nicht neu gestartet oder die .user.ini wurde noch nicht neu eingelesen, was fünf Minuten dauern kann. Beim Shared Hosting kann außerdem der Anbieter den Wert deckeln, und bei Multisite gilt zusätzlich die Netzwerk-Einstellung.

Kann ich das Upload-Limit in der wp-config.php erhöhen?

Nein. upload_max_filesize und post_max_size lassen sich nicht ändern, während ein Skript läuft, deshalb bleiben ini_set-Zeilen in der wp-config.php oder functions.php wirkungslos. WP_MEMORY_LIMIT hebt nur das Speicherlimit an. Das Upload-Limit müssen Sie in der php.ini, der .user.ini, der .htaccess oder im Control Panel ändern.

Worin unterscheiden sich der Fehler upload_max_filesize und 413 Request Entity Too Large?

Der erste kommt von PHP, der zweite vom Webserver. Nginx lehnt jede Anfrage ab, die größer ist als client_max_body_size, standardmäßig 1 MB, noch bevor sie PHP erreicht. Auf dem eigenen Server müssen Sie beide Limits anheben; erhöhen Sie nur eines, bleibt das andere bestehen.

Wie hoch sollte ich das Upload-Limit setzen?

Etwas höher als die größte Datei, die Sie wirklich hochladen. Für die meisten Websites reichen 64 MB, mit 128 oder 256 MB sind auch große Themes und Backups abgedeckt. Vermeiden Sie extreme Werte, denn damit kann eine einzelne Anfrage Arbeitsspeicher, Speicherplatz und PHP-Prozesse blockieren. Für gelegentliche sehr große Dateien ist SFTP das bessere Werkzeug.

Nodesty

Über den Autor

Nodesty-Team · Infrastruktur und Support

Das Nodesty-Team betreibt unsere Server, unser Netzwerk und unseren DDoS-Schutz im Alltag und beantwortet Support-Anfragen rund um die Uhr. Diese Ratgeber entstehen aus dieser Arbeit.

Verwandte Artikel

Starte deinen Server jetzt.

Erstellen, wachsen und skalieren Sie Ihre Projekte grenzenlos auf der Premium-Infrastruktur von Nodesty.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································