PHP-Anforderungen

Einige einzelne Module können spezielle Anforderungen an PHP-Erweiterungen und -Konfigurationen stellen, die über die unten aufgeführten hinausgehen. Bitte lesen Sie daher die Dokumentation des jeweiligen Moduls.

Unterstützte PHP-Versionen

PHP-Version	Von Drupal unterstützt	Für Drupal empfohlen
5.5	Nein (siehe Hinweis 2 unten)	Nein
5.6	Nein (siehe Hinweis 2 unten)	Nein
7.0	Ja, 7.0.8 mit Drupal 8.7.0 (siehe Hinweis 2 unten)	Nein
7.1	Ja	Nein
7.2	Ja, ab Drupal 8.5.0	Ja
7.3	Ja, ab Drupal 8.6.4 (siehe Hinweis 1 unten)	Ja
7.4	Ja, ab Drupal 8.8.3	Ja
8.0	Nein; siehe Task 3109885

1) Lesen Sie die Änderungsnotiz für weitere Informationen zur Unterstützung von PHP 7.3.
2) Lesen Sie die Änderungsnotiz für weitere Informationen zum Ende der Unterstützung von PHP 5.

Was bedeutet „empfohlene“ PHP-Version?

Drupal läuft auf allen unterstützten PHP-Versionen. Empfohlene PHP-Versionen sind die beste Wahl für den Aufbau einer Drupal-Website, da sie länger unterstützt werden. PHP 7 bietet zudem erhebliche Verbesserungen bei Geschwindigkeit und Caching.

PHP 5.5, 5.6 und 7.0 erreichten das offizielle Lebensende Ende 2018, und PHP 7.1 am 1. Dezember 2019. (Siehe PHP: Unterstützte Versionen für weitere Details.) Drupal 8 beendete die Unterstützung von PHP 5.5 und 5.6 im Mai 2019, und neue Versionen erfordern 7.0.8 oder höher. Wir empfehlen ein Upgrade auf mindestens PHP 7.2. (Ubuntu 18.04 wird mit PHP 7.2 geliefert, Debian stable mit 7.3.)

Hinweis: Dies betrifft nicht Drupal 7, das weiterhin mit PHP 5.2.4 und höher kompatibel ist. Eine separate Ankündigung erfolgt, falls sich dies ändert – siehe Drupal 7 PHP-Anforderungen.

Erforderliche PHP-Erweiterungen

Die vom Drupal-Kern verwendeten Erweiterungen sind in der Core-Datei composer.json definiert – siehe z. B. die Datei für Drupal 8.7.x. Schauen Sie in den Abschnitt „require“ und die Schlüssel, die mit „ext-“ beginnen.

Hinweis: Das Hinzufügen einer PHP-Erweiterung zu Ihrem System bedeutet mindestens unter Linux (und Mac), das entsprechende PHP-Paket mit einem Paketmanager zu suchen und zu installieren. Üblicherweise heißen die Pakete für Erweiterungen „php-foo“ oder „php7-foo“, aber nicht immer. Manche Erweiterungen sind Teil des Haupt-PHP-Pakets und daher standardmäßig enthalten.

Datenbankerweiterungen

Die PHP Data Objects (PDO)-Erweiterung muss für die korrekte Installation und den Betrieb von Drupal 8 aktiviert sein. Die PDO-Version von PECL ist mit Drupal 8 nicht kompatibel und darf nicht verwendet werden. Zusätzlich muss die PHP-Erweiterung für die Verbindung mit der von Ihnen gewählten Datenbank installiert und aktiviert sein.

Derzeit werden folgende Drupal-Datenbanktreiber unterstützt: mysql (ursprüngliche MySQL-Erweiterung), mysqli (verbesserter Treiber für neuere MySQL-Installationen) und pgsql (für PostgreSQL). Hinweis: PHP 5.x enthält die mysql-Erweiterung nicht mehr standardmäßig. Bitte lesen Sie die oben genannten Links zur Installation und Aktivierung des gewählten Treibers. In der Regel ist bei Installation von PDO mit MySQL-Unterstützung der richtige Treiber bereits gewählt.

XML-Erweiterung

Die PHP XML-Erweiterung (für Blog-APIs, Drupal-Module und Ping). Diese Erweiterung ist standardmäßig in der PHP-Standardinstallation enthalten; die Windows-PHP-Version hat diese Erweiterung eingebaut. Die Aktivierung der XML-Erweiterung aktiviert auch PHP DOM. DOM ist jetzt eine Systemanforderung.

Bildverarbeitungsbibliothek

Eine Bildbibliothek für PHP, wie die GD-Bibliothek, ist eine erforderliche Erweiterung in Drupal 8 und wird für die Bildmanipulation benötigt (Änderung der Bildgröße von Nutzerbildern, Bildmodule und Bildcache). ImageMagick wird ebenfalls für grundlegende Bildmanipulationen im Drupal-Kern unterstützt, aber es gibt viel weniger Unterstützung durch Zusatzmodule.

OpenSSL

Die PHP OpenSSL-Erweiterung wird empfohlen, damit Drupal ausgehende HTTPS-Anfragen stellen kann. Manche Plattformen bieten ein separates OpenSSL-Paket, z. B. php7-OpenSSL.

Es wird außerdem an der Überprüfung des Update-Manager-Moduls gearbeitet, das Updates über HTTPS abruft, wodurch diese Empfehlung strenger oder sogar verpflichtend werden könnte. Siehe Task #1538118: Update-Status überprüft nicht die Identität oder Authentizität der URL der Release-Historie und https://groups.drupal.org/node/506128.

JSON

Drupal 8 benötigt eine PHP-Version mit JSON-Unterstützung. JSON ist üblicherweise Teil des PHP-Kerns kompiliert, aber wenn Sie Fehler wie

PHP Fatal error: Call to undefined function Drupal\\Component\\Serialization\\json_encode() in ... core/lib/Drupal/Component/Serialization/Json.php

erhalten, versuchen Sie bitte, die JSON-Erweiterung zu installieren.

cURL

Die PHP cURL-Erweiterung wird für das SimpleTest-Modul in Drupal 8 sowie für Aggregator und einige zusätzliche Module benötigt. In vielen Linux-Distributionen und Entwicklungs-Stacks ist sie standardmäßig aktiviert, aber wenn Ihre Installation sie nicht in der php.ini aktiviert (typisch für Windows) oder nicht mit einem Paketmanager installiert (typisch für Linux), müssen Sie sie manuell hinzufügen.

Mbstring

Die PHP mbstring-Erweiterung bietet spezielle Multibyte-String-Funktionen, die für die Installation von Drupal in Sprachen außer Englisch sowie für mehrsprachige Websites in Drupal verwendet werden. Sie unterstützt den Umgang mit Multibyte-Codierungen in PHP sowie Unicode-basierte Codierungen wie UTF-8 oder UCS-2.

PHP-Konfigurationseinstellungen

Speicheranforderungen

Der PHP-Speicherbedarf kann je nach auf Ihrer Website verwendeten Modulen stark variieren. Das Minimum beträgt 64 MB.

Warnmeldungen erscheinen, wenn die PHP-Konfiguration diese Anforderungen nicht erfüllt. Obwohl diese Werte für die Standardinstallation von Drupal ausreichen können, benötigen produktive Seiten mit mehreren aktiven, häufig genutzten Modulen meist mehr Speicher. Üblich sind 128 MB oder 256 MB in Produktionssystemen. Manche Installationen, besonders im Multimedia-Bereich, benötigen noch mehr. Wenn Sie einen Hosting-Service nutzen, stellen Sie sicher, dass Ihr Host genügend Speicher für die von Ihnen eingesetzten Module bereitstellen kann oder dies zukünftig tun kann. (Siehe PHP-Speicherlimit erhöhen in den FAQ zur Fehlerbehebung für weitere Informationen.)

.htaccess-Einstellungen

Einige Speicherparameter sind in der standardmäßigen .htaccess-Datei enthalten, die mit Drupal ausgeliefert wird, sodass Sie diese nicht explizit setzen müssen. Beachten Sie jedoch, dass das Setzen von PHP-Konfigurationsparametern in .htaccess nur funktioniert, wenn:

Mit Apache (oder kompatiblem Webserver)
Die .htaccess-Datei tatsächlich gelesen wird, also AllowOverride All in der Apache-Hauptkonfiguration (normalerweise httpd.conf) aktiviert ist
PHP als Apache-Modul installiert ist
In manchen Shared-Hosting-Umgebungen ist der Zugriff auf diese Einstellungen eingeschränkt. Wenn Sie die Änderungen nicht selbst vornehmen können, bitten Sie Ihren Hosting-Anbieter darum.

Andere Schnittstellen

Siehe das PHP-Handbuch für Hinweise, wie Konfigurationseinstellungen für andere PHP-Schnittstellen geändert werden können.

Xdebug

Wenn Sie Xdebug verwenden:

Einstellung: xdebug.show_exception_trace = 0
Grund: Kann zu einem Absturz des Drupal-Installationsprogramms führen.

Verwendung von Xdebug mit Drupal 8:

Einstellung: xdebug.collect_params = ?
Grund: Ein zu hoher Wert für xdebug.collect_params verhindert die Installation und den Betrieb von Drupal 8.

Einstellung: xdebug.max_nesting_level = 256
Grund: Der Standardwert von 100 (in xdebug-Versionen <2.3) führt zum Absturz einiger Seiten.

PHP aus verschiedenen Quellen

Drupal ist für PHP von PHP.net ausgelegt. Es wird versucht, PHP-Versionen aus anderen Quellen zum Laufen zu bringen, dies geschieht aber nur mit maximalem Aufwand. Bekannt ist, dass Suhosin einige Funktionen beeinträchtigt; und einige Betriebssysteme verlagern Hauptkomponenten in andere Pakete.

Details zu PHP-Anforderungen

Siehe die Seite phpinfo() auf Drupal.org, um zu erfahren, wie Sie Phpinfo nutzen, um detaillierte Informationen über Ihr System zu erhalten. Phpinfo zeigt z. B. an, ob eine Datenbank installiert ist, welche PHP- und MySQL-Versionen laufen und welche PHP-Variablen gesetzt sind sowie viele weitere nützliche Informationen.

Oft ist es möglich, auf eine neuere PHP-Version zu aktualisieren, die mit Ihrer Linux-Distribution geliefert wird. Lesen Sie bitte die Dokumentation Ihrer Linux-Distribution.

Einige wichtige Hinweise

Beachten Sie die Einschränkungen von 32-Bit-PHP.
Drupal-Abhängigkeiten basierend auf Composer sind mit PHP 5.5.9 verpackt. Wenn Sie eine höhere PHP-Version verwenden, können Sie den Composer-Update-Befehl verwenden, um passendere Abhängigkeiten zu erhalten.
Der Drupal 8 Update-Manager kann Module und Themes über SSH installieren/aktualisieren, sofern die erforderlichen Bibliotheken auf dem Server installiert sind. (Unter Debian heißt das Paket „libssh2-php“.)
Wenn der APC Opcode Cache mit Drupal 8 verwendet wird, ist APC 3.1.13 oder höher erforderlich.
Wenn der eingebaute opcache aktiviert ist, muss opcache.save_comments aktiviert sein (Standardwert 1), sonst werden Annotationen nicht gespeichert/geladen.