PHP-Erweiterungen in cPanel aktivieren und verwalten

PHP-Erweiterungen ergänzen PHP um zusätzliche Funktionen. Anwendungen wie WordPress, WooCommerce oder andere PHP-Systeme können bestimmte Erweiterungen voraussetzen, damit einzelne Funktionen korrekt arbeiten.

Typische PHP-Erweiterungen sind beispielsweise curl, intl, mbstring, mysqli, zip oder gd.

Im CURIAWEB-cPanel findest du verschiedene Werkzeuge rund um PHP. Dabei ist wichtig, zwischen der von CURIAWEB empfohlenen MultiPHP-/EasyApache-PHP-Umgebung und dem zusätzlich vorhandenen CloudLinux PHP Selector zu unterscheiden.

CURIAWEB-Empfehlung: Für die PHP-Version einer Website verwendest du grundsätzlich den MultiPHP-Manager. Wechsle nicht auf eine andere PHP-Verwaltung, nur weil eine Anwendung eine bestimmte PHP-Erweiterung verlangt.

Was ist eine PHP-Erweiterung? #

PHP stellt bereits zahlreiche grundlegende Funktionen bereit. Zusätzliche Erweiterungen ergänzen die Sprache um weitere Fähigkeiten.

Eine Anwendung kann beispielsweise Funktionen benötigen für:

• Datenbankverbindungen
• Bildverarbeitung
• ZIP-Archive
• verschlüsselte Verbindungen
• internationale Zeichen- und Sprachverarbeitung
• XML-Verarbeitung
• HTTP- beziehungsweise API-Verbindungen

Dafür kommen unterschiedliche PHP-Erweiterungen zum Einsatz.

Typische PHP-Erweiterungen #

Erweiterung	Typische Aufgabe
curl	Kommunikation mit anderen Servern und Webdiensten
gd	Bildverarbeitung
intl	Internationalisierung, Sprache, Zahlen- und Datumsformate
mbstring	Verarbeitung mehrbytefähiger Zeichenkodierungen
mysqli	Verbindung zu MySQL-/MariaDB-Datenbanken
openssl	Kryptografische Funktionen und verschlüsselte Kommunikation
zip	Verarbeitung von ZIP-Archiven
xml	Verarbeitung von XML-Daten

Diese Tabelle ist keine vollständige Liste. Welche Erweiterungen verfügbar und aktiviert sind, hängt von der jeweiligen PHP-Version und Serverkonfiguration ab.

PHP-Erweiterung und PHP-Version sind zwei unterschiedliche Dinge #

Eine PHP-Version und eine PHP-Erweiterung dürfen nicht miteinander verwechselt werden.

Vereinfacht:

PHP-Version
→ PHP-Laufzeitumgebung

PHP-Erweiterung
→ zusätzliche Funktion innerhalb dieser PHP-Umgebung

Wenn eine Anwendung beispielsweise PHP in einer bestimmten Mindestversion verlangt und zusätzlich intl benötigt, müssen beide Anforderungen erfüllt sein.

CURIAWEB verwendet für PHP-Versionen MultiPHP #

Für die Auswahl der PHP-Version einer Domain empfiehlt CURIAWEB:

Software → MultiPHP-Manager

Dort legst du fest, welche der verfügbaren PHP-Versionen deine Website verwendet.

Die vollständige Anleitung findest du unter PHP-Version in cPanel ändern.

Warum gibt es zusätzlich „PHP-Version wählen“? #

Im CURIAWEB-cPanel findest du unter Software zusätzlich den Bereich PHP-Version wählen. Dieser gehört zur CloudLinux-PHP-Verwaltung und stellt eine eigene PHP-Umgebung mit zusätzlichen Konfigurationsmöglichkeiten bereit.

Das bedeutet jedoch nicht, dass du für eine Website gleichzeitig den MultiPHP-Manager und den CloudLinux PHP Selector verwenden solltest.

Wichtig: MultiPHP/EasyApache und der CloudLinux PHP Selector sind unterschiedliche PHP-Verwaltungen. Einstellungen aus der einen Umgebung solltest du nicht automatisch als Einstellungen der anderen Umgebung betrachten.

Nicht wegen einer Erweiterung die PHP-Verwaltung wechseln #

Wenn eine Anwendung meldet, dass beispielsweise:

intl

oder:

zip

fehlt, solltest du nicht als ersten Schritt die PHP-Verwaltung wechseln.

Prüfe zunächst:

• welche PHP-Version die Website tatsächlich verwendet
• welche Erweiterung konkret verlangt wird
• ob die Erweiterung in der verwendeten PHP-Umgebung bereits verfügbar ist
• ob die Fehlermeldung tatsächlich aktuell ist

1. Verwendete PHP-Version prüfen #

Öffne im CURIAWEB-cPanel:

Software → MultiPHP-Manager

Suche die betreffende Domain und kontrolliere die zugewiesene PHP-Version.

Notiere dir die verwendete Version.

Praxis-Tipp: Bevor du nach einer vermeintlich fehlenden PHP-Erweiterung suchst, solltest du immer wissen, welche PHP-Version die betroffene Website tatsächlich verwendet.

2. Fehlermeldung der Anwendung genau lesen #

Wenn eine Anwendung eine fehlende PHP-Erweiterung meldet, notiere deren genauen Namen.

Eine Meldung kann beispielsweise sinngemäß darauf hinweisen, dass eine bestimmte Extension nicht verfügbar ist.

Wichtig ist dabei der konkrete Name wie:

intl

mbstring

zip

oder:

curl

Ändere nicht mehrere PHP-Komponenten auf Verdacht.

3. Prüfen, ob die Meldung wirklich eine PHP-Erweiterung betrifft #

Nicht jede PHP-Fehlermeldung weist auf eine fehlende Erweiterung hin.

Eine Anwendung kann beispielsweise auch wegen folgender Ursachen scheitern:

• nicht unterstützte PHP-Version
• zu niedriges PHP Memory Limit
• fehlende Dateiberechtigung
• Programmierfehler
• fehlende PHP-Funktion
• falsche Anwendungskonfiguration

Prüfe deshalb den Wortlaut der Fehlermeldung, bevor du die PHP-Konfiguration veränderst.

4. Error Log bei unklaren PHP-Fehlern prüfen #

Wenn die Website lediglich einen allgemeinen Fehler zeigt, kann das Fehlerprotokoll genauere Informationen enthalten.

Eine PHP-Fehlermeldung kann beispielsweise Hinweise auf eine nicht vorhandene Funktion oder Klasse enthalten.

Wie du das Fehlerprotokoll verwendest, erklären wir unter cPanel Error Log lesen und Website-Fehler finden.

Typischer Hinweis auf eine fehlende Erweiterung #

Je nach Anwendung und Erweiterung können Meldungen beispielsweise darauf hinweisen, dass eine benötigte Klasse oder Funktion nicht vorhanden ist.

Ein solcher Fehler muss im jeweiligen Kontext bewertet werden.

Der Name einer fehlenden Funktion kann häufig einen Hinweis darauf geben, zu welcher PHP-Erweiterung sie gehört.

Wichtig: Installiere oder aktiviere nicht einfach eine Erweiterung anhand eines einzelnen Wortes in einer Fehlermeldung. Prüfe zuerst die Anforderungen der verwendeten Anwendung.

5. Systemanforderungen der Anwendung prüfen #

Wenn du ein CMS, Plugin, Theme oder eine andere PHP-Anwendung installierst, prüfe deren offizielle Systemanforderungen.

Dort können beispielsweise Anforderungen stehen wie:

PHP: bestimmte Mindestversion
Extension: intl
Extension: mbstring
Extension: zip

Damit kannst du unterscheiden, ob die Anwendung eine Erweiterung zwingend benötigt oder lediglich für eine optionale Funktion empfiehlt.

Pflicht und Empfehlung unterscheiden #

Softwarehersteller unterscheiden teilweise zwischen:

• zwingend benötigten PHP-Erweiterungen
• empfohlenen PHP-Erweiterungen
• Erweiterungen für einzelne optionale Funktionen

Wenn eine optionale Erweiterung fehlt, muss deshalb nicht zwangsläufig die gesamte Website ausfallen.

6. PHP-Erweiterung in der MultiPHP-Umgebung #

Bei der von CURIAWEB empfohlenen MultiPHP-/EasyApache-Umgebung werden PHP-Erweiterungen serverseitig für die jeweiligen PHP-Versionen bereitgestellt.

Der MultiPHP-Manager selbst ist dabei in erster Linie für die Zuordnung der PHP-Version zur Domain vorgesehen.

Er ist kein Schalterfeld, in dem du beliebige EasyApache-PHP-Erweiterungen für eine einzelne Domain ein- und ausschaltest.

Kurz erklärt: Im MultiPHP-Manager wählst du die PHP-Version deiner Domain. Die für diese PHP-Umgebung bereitgestellten Module sind davon zu unterscheiden.

Was tun, wenn eine benötigte Erweiterung fehlt? #

Wenn deine Website MultiPHP verwendet und eine benötigte PHP-Erweiterung tatsächlich nicht verfügbar ist, solltest du nicht versuchen, sie über eine andere PHP-Verwaltung parallel zu aktivieren.

Notiere stattdessen:

• betroffene Domain
• verwendete PHP-Version
• Name der benötigten Erweiterung
• verwendete Anwendung
• genaue Fehlermeldung

Kontaktiere anschließend den CURIAWEB-Support, damit geprüft werden kann, ob die Erweiterung in der betreffenden PHP-Umgebung verfügbar beziehungsweise serverseitig vorgesehen ist.

Warum kann ich EasyApache-Erweiterungen nicht selbst installieren? #

EasyApache verwaltet zentrale Bestandteile der Apache- und PHP-Umgebung des Servers. In einem Shared-Hosting-Account besitzt ein einzelner cPanel-Benutzer keine administrativen Rechte, um beliebige serverweite EasyApache-Pakete zu installieren.

Das ist beabsichtigt: Änderungen an der zentralen PHP-Umgebung können mehrere Hosting-Accounts beziehungsweise Websites betreffen.

PHP-Erweiterungen sind versionsabhängig #

Eine PHP-Erweiterung gehört immer zu einer bestimmten PHP-Umgebung beziehungsweise PHP-Version.

Vereinfacht:

PHP-Version A
→ eigene PHP-Module

PHP-Version B
→ eigene PHP-Module

Dass eine Erweiterung für eine PHP-Version verfügbar ist, bedeutet deshalb nicht automatisch, dass jede andere installierte PHP-Version exakt dieselbe Modulkonfiguration besitzt.

PHP-Version nicht unnötig wechseln, um ein Modul zu erhalten #

Wenn eine benötigte Erweiterung bei einer bestimmten PHP-Version fehlt, solltest du nicht auf Verdacht mehrere PHP-Versionen durchprobieren.

Ein Versionswechsel kann Auswirkungen auf die gesamte Anwendung haben.

Prüfe zuerst die Anforderungen der Software und die tatsächlich vorgesehene PHP-Konfiguration.

PHP-Erweiterungen und PHP-Einstellungen unterscheiden #

Eine Erweiterung wie:

intl

ist etwas anderes als eine PHP-Direktive wie:

memory_limit

Vereinfacht:

intl
→ PHP-Erweiterung

memory_limit
→ PHP-Einstellung

PHP-Einstellungen verwaltest du bei CURIAWEB über den MultiPHP INI-Editor.

PHP-Erweiterungen und PHP-Limits unterscheiden #

Auch PHP-Limits wie:

memory_limit
upload_max_filesize
post_max_size
max_execution_time

sind keine PHP-Erweiterungen.

Wenn eine Anwendung beispielsweise einen Speicherfehler meldet, hilft das Aktivieren zusätzlicher Extensions normalerweise nicht.

Die wichtigsten PHP-Limits erklären wir unter PHP Memory Limit, Upload-Größe und Ausführungszeit einstellen.

cURL #

Die PHP-Erweiterung curl ermöglicht PHP-Anwendungen die Kommunikation mit anderen Diensten über unterstützte Netzwerkprotokolle.

Sie wird beispielsweise häufig benötigt, wenn eine Website APIs oder andere externe Webdienste anspricht.

Wenn eine Anwendung keine Verbindung zu einem externen Dienst herstellen kann, bedeutet das allerdings nicht automatisch, dass curl fehlt.

Auch DNS, Zertifikate, Zugangsdaten, der externe Dienst oder die Anwendung selbst können die Ursache sein.

intl #

Die Erweiterung intl stellt Funktionen für Internationalisierung bereit.

Dazu gehören unter anderem Funktionen für sprach- und regionsabhängige Verarbeitung.

Einige Anwendungen oder Bibliotheken setzen intl ausdrücklich voraus.

mbstring #

mbstring stellt Funktionen für die Verarbeitung mehrbytefähiger Zeichenkodierungen bereit.

Das ist insbesondere bei Texten und Zeichensätzen relevant, bei denen ein Zeichen nicht zwangsläufig aus nur einem Byte besteht.

mysqli #

mysqli stellt Funktionen für die Kommunikation von PHP mit MySQL-kompatiblen Datenbanksystemen bereit.

Wenn eine datenbankbasierte PHP-Anwendung eine benötigte Datenbankerweiterung nicht zur Verfügung hat, kann sie möglicherweise keine Verbindung zur Datenbank herstellen.

Ein Datenbank-Verbindungsfehler bedeutet allerdings nicht automatisch, dass mysqli fehlt. Auch falsche Zugangsdaten oder eine falsche Datenbankkonfiguration können die Ursache sein.

zip #

Die Erweiterung zip ermöglicht PHP-Anwendungen die Arbeit mit ZIP-Archiven.

Sie kann beispielsweise bei Installations-, Import-, Export- oder Backup-Funktionen einer Anwendung benötigt werden.

Wenn das Entpacken eines Archivs fehlschlägt, können jedoch auch eine beschädigte ZIP-Datei, fehlender Speicherplatz oder andere Fehler die Ursache sein.

gd #

Die Erweiterung gd stellt Funktionen zur Bildverarbeitung bereit.

Webanwendungen können sie beispielsweise verwenden, um Bilder zu skalieren oder andere Bildoperationen auszuführen.

Welche Bildformate und Funktionen unterstützt werden, hängt von der konkreten PHP-/GD-Konfiguration ab.

Imagick und GD nicht gleichsetzen #

Bei Bildverarbeitung begegnet dir möglicherweise auch:

imagick

Imagick und GD sind unterschiedliche Erweiterungen beziehungsweise Bildverarbeitungssysteme.

Wenn eine Anwendung ausdrücklich Imagick verlangt, bedeutet eine vorhandene GD-Erweiterung deshalb nicht automatisch, dass diese Anforderung erfüllt ist.

openssl #

Die OpenSSL-Unterstützung wird von zahlreichen PHP-Anwendungen für kryptografische Funktionen und verschlüsselte Kommunikation benötigt.

Ein HTTPS-Problem einer Website ist allerdings nicht automatisch ein Problem der PHP-Erweiterung openssl.

SSL-Zertifikate des Webservers und PHP-OpenSSL-Funktionen sind unterschiedliche technische Ebenen.

XML-Erweiterungen #

PHP besitzt verschiedene Funktionen und Erweiterungen zur Verarbeitung von XML.

Eine Anwendung kann beispielsweise bestimmte XML-Komponenten voraussetzen.

Wenn eine Software einen konkreten Modulnamen nennt, solltest du genau diesen prüfen und nicht lediglich davon ausgehen, dass „irgendetwas mit XML“ ausreicht.

PDO und Datenbanktreiber #

Manche PHP-Anwendungen verwenden PDO für Datenbankzugriffe.

Dabei kann neben PDO selbst auch ein passender Datenbanktreiber benötigt werden.

Eine Meldung wie:

could not find driver

kann beispielsweise darauf hinweisen, dass der für die verwendete Datenbank benötigte PDO-Treiber nicht verfügbar ist.

Die genaue Fehlermeldung und Anwendungskonfiguration müssen dabei gemeinsam betrachtet werden.

Was bedeutet „Call to undefined function“? #

Eine PHP-Fehlermeldung kann beispielsweise enthalten:

Call to undefined function ...

Das bedeutet, dass PHP die aufgerufene Funktion in der aktuellen Umgebung nicht kennt.

Eine mögliche Ursache ist eine fehlende Erweiterung. Es können jedoch auch andere Ursachen vorliegen, beispielsweise fehlerhafter Anwendungscode.

Prüfe deshalb, zu welcher Komponente die genannte Funktion gehört.

Was bedeutet „Class not found“? #

Eine Meldung wie:

Class ... not found

beweist ebenfalls nicht automatisch, dass eine PHP-Erweiterung fehlt.

Die Klasse könnte beispielsweise zu:

• einer PHP-Erweiterung
• einer Programmbibliothek
• einem Plugin
• einem Theme
• individuellem Anwendungscode

gehören.

Die genaue Bezeichnung der Klasse ist deshalb entscheidend.

WordPress und PHP-Erweiterungen #

WordPress benötigt beziehungsweise empfiehlt für verschiedene Funktionen bestimmte PHP-Erweiterungen. Zusätzlich können Plugins und Themes eigene Anforderungen besitzen.

Wenn ein WordPress-Plugin eine fehlende Extension meldet, solltest du deshalb prüfen, ob die Anforderung vom WordPress-Core oder ausschließlich vom betreffenden Plugin stammt.

WooCommerce und Erweiterungen #

WooCommerce sowie Zahlungs-, Versand-, Import- und andere Erweiterungen können zusätzliche PHP-Funktionen verwenden.

Gerade bei komplexeren WordPress-Installationen können deshalb Anforderungen einzelner Plugins über die grundlegenden Anforderungen von WordPress hinausgehen.

Prüfe bei einer Fehlermeldung immer die Dokumentation der konkret betroffenen Erweiterung.

Composer-Anwendungen und PHP-Erweiterungen #

PHP-Anwendungen, die Composer verwenden, können benötigte Extensions als Abhängigkeiten definieren.

Bei der Installation oder Aktualisierung kann Composer dann beispielsweise darauf hinweisen, dass eine bestimmte ext-...-Abhängigkeit fehlt.

Eine Meldung kann beispielsweise auf:

ext-intl

oder:

ext-zip

verweisen.

Das Präfix ext- bezeichnet in diesem Zusammenhang eine benötigte PHP-Erweiterung.

Composer-Prüfung nicht einfach umgehen #

Wenn Composer eine erforderliche PHP-Erweiterung meldet, solltest du die Anforderung nicht ohne Prüfung ignorieren oder umgehen.

Die Anwendung kann die Erweiterung tatsächlich für ihre Funktion benötigen.

Achtung: Eine Abhängigkeitsprüfung zu umgehen macht eine fehlende PHP-Funktion nicht verfügbar. Prüfe stattdessen, weshalb die Anwendung die Erweiterung benötigt.

PHP-Erweiterung nach Versionswechsel scheinbar verschwunden #

Wenn eine Anwendung unmittelbar nach einem Wechsel der PHP-Version plötzlich eine fehlende Erweiterung meldet, solltest du den Zusammenhang berücksichtigen.

Prüfe:

• vorherige PHP-Version
• neue PHP-Version
• genauen Namen der Erweiterung
• ob die Anwendung mit der neuen PHP-Version unterstützt wird

Die PHP-Version kannst du bei Bedarf über den MultiPHP-Manager wieder auf den vorherigen Stand zurückstellen, sofern diese Version weiterhin verfügbar ist.

Nicht sofort mehrere Erweiterungen als Ursache annehmen #

Wenn nach einem PHP-Wechsel eine Website ausfällt, sollte zunächst die konkrete Fehlermeldung untersucht werden.

Ein PHP-Versionswechsel kann auch Inkompatibilitäten im Anwendungscode verursachen, obwohl sämtliche benötigten Extensions vorhanden sind.

CloudLinux PHP Selector nicht parallel konfigurieren #

Der im cPanel sichtbare Bereich PHP-Version wählen kann eigene Auswahlmöglichkeiten für PHP-Versionen, Extensions und Einstellungen anbieten.

Wenn deine Website jedoch entsprechend der CURIAWEB-Empfehlung über MultiPHP/EasyApache betrieben wird, solltest du nicht versuchen, eine dort fehlende MultiPHP-Erweiterung durch parallele Einstellungen im PHP Selector zu „ergänzen“.

Wichtig: Eine Extension, die du innerhalb einer anderen PHP-Umgebung aktivierst, wird dadurch nicht automatisch Bestandteil der von deiner Website verwendeten MultiPHP-/EasyApache-PHP-Version.

PEAR-Pakete sind nicht dasselbe wie PHP-Erweiterungen #

Im CURIAWEB-cPanel findest du zusätzlich den Bereich PHP-PEAR-Pakete.

PEAR-Pakete sind nicht mit serverseitigen PHP-Erweiterungen wie intl, curl oder mysqli gleichzusetzen.

Wenn eine Anwendung eine PHP-Extension verlangt, solltest du deshalb nicht versuchen, diese Anforderung durch die Installation eines beliebigen PEAR-Pakets zu erfüllen.

Perl-Module sind ebenfalls etwas anderes #

Auch der cPanel-Bereich Perl-Module gehört nicht zur Verwaltung von PHP-Erweiterungen.

PHP und Perl sind unterschiedliche Laufzeit- beziehungsweise Programmiersprachenumgebungen.

PHP-Erweiterung selbst hochladen? #

Eine serverseitige PHP-Erweiterung lässt sich nicht dadurch aktivieren, dass du irgendeine Moduldatei in dein Website-Verzeichnis hochlädst.

PHP-Erweiterungen müssen zur verwendeten PHP-Version und Serverumgebung passen und entsprechend in die PHP-Laufzeit eingebunden sein.

Achtung: Lade keine unbekannten kompilierten PHP-Module aus dem Internet in deinen Hosting-Account und versuche nicht, diese manuell in die Server-PHP-Konfiguration einzubinden.

PHP-Erweiterung nicht mit WordPress-Plugin verwechseln #

Ein WordPress-Plugin und eine PHP-Erweiterung sind ebenfalls zwei völlig unterschiedliche Dinge.

Vereinfacht:

WordPress-Plugin
→ Erweiterung von WordPress

PHP-Extension
→ Erweiterung der PHP-Laufzeitumgebung

Ein WordPress-Plugin kann eine PHP-Extension benötigen, diese aber nicht automatisch als serverseitiges PHP-Modul installieren.

Nach einer Änderung Website testen #

Wenn eine benötigte PHP-Erweiterung bereitgestellt beziehungsweise die PHP-Konfiguration geändert wurde, teste genau die Funktion, die zuvor den Fehler ausgelöst hat.

Beispielsweise:

Plugin-Installation fehlgeschlagen
→ Installation erneut testen

API-Funktion fehlerhaft
→ betreffende Verbindung erneut testen

ZIP-Verarbeitung fehlgeschlagen
→ denselben Vorgang erneut ausführen

So kannst du feststellen, ob die Erweiterung tatsächlich die Ursache war.

Fehler bleibt trotz vorhandener Erweiterung bestehen #

Wenn die benötigte Extension vorhanden ist und die Anwendung weiterhin einen Fehler meldet, solltest du nicht davon ausgehen, dass noch weitere PHP-Erweiterungen fehlen.

Prüfe stattdessen:

• genaue Fehlermeldung
• PHP-Version
• Anwendungsversion
• PHP-Einstellungen
• PHP-Limits
• Anwendungskonfiguration
• Error Log

PHP-Erweiterungen nach Website-Umzug #

Bei einem Hostingwechsel kann sich die PHP-Umgebung vom bisherigen Server unterscheiden.

Eine ältere oder individuell konfigurierte Website kann eine Erweiterung verwendet haben, die auf dem bisherigen Server zusätzlich installiert war.

Wenn eine Website nach einem Umzug einen PHP-Fehler zeigt, gehören deshalb auch die verwendete PHP-Version und benötigte Extensions zur Diagnose.

Vor einem Umzug Anforderungen dokumentieren #

Bei individuell entwickelten PHP-Anwendungen ist es sinnvoll, vor einem Serverwechsel die technischen Anforderungen zu kennen.

Dazu gehören beispielsweise:

• PHP-Version
• benötigte PHP-Erweiterungen
• PHP-Einstellungen
• Datenbankanforderungen
• Cronjobs
• weitere serverseitige Abhängigkeiten

Dadurch lässt sich die Zielumgebung vor der eigentlichen Umschaltung prüfen.

Empfohlener Ablauf bei einer Meldung über eine fehlende PHP-Erweiterung #

1. Notiere die vollständige Fehlermeldung.
2. Notiere den Namen der angeblich fehlenden Erweiterung.
3. Prüfe die Systemanforderungen der Anwendung.
4. Öffne Software → MultiPHP-Manager.
5. Kontrolliere die PHP-Version der betroffenen Domain.
6. Prüfe, ob die Anwendung diese PHP-Version unterstützt.
7. Unterscheide zwischen PHP-Erweiterung, PHP-Einstellung und PHP-Limit.
8. Prüfe bei unklaren Fehlern das Error Log.
9. Wechsle nicht auf Verdacht zwischen unterschiedlichen PHP-Verwaltungen.
10. Kontaktiere den Support, wenn eine benötigte Extension in der verwendeten MultiPHP-Umgebung tatsächlich fehlt.
11. Teste nach einer Anpassung genau die zuvor fehlerhafte Funktion erneut.

Empfohlene Fehlersuche nach einem PHP-Versionswechsel #

1. Prüfe, ob der Fehler unmittelbar nach dem Versionswechsel entstanden ist.
2. Notiere vorherige und aktuelle PHP-Version.
3. Prüfe die konkrete Fehlermeldung.
4. Kontrolliere, ob tatsächlich eine Extension genannt wird.
5. Prüfe die Anforderungen der betroffenen Anwendung.
6. Wechsle bei Bedarf testweise auf die vorherige PHP-Version zurück.
7. Funktioniert die Website wieder, untersuche die Kompatibilität der neuen PHP-Umgebung.
8. Aktiviere nicht wahllos zusätzliche Erweiterungen.

Grundregel: Eine fehlende PHP-Erweiterung sollte anhand einer konkreten Anforderung oder Fehlermeldung festgestellt werden. PHP-Version prüfen, Extension identifizieren und die verwendete PHP-Umgebung sauber beibehalten – nicht mehrere PHP-Verwaltungen miteinander vermischen.

Wann solltest du den CURIAWEB-Support kontaktieren? #

Wenn eine Anwendung eine PHP-Erweiterung zwingend voraussetzt und diese in der von deiner Domain verwendeten MultiPHP-/EasyApache-Umgebung nicht verfügbar ist, kann eine serverseitige Prüfung erforderlich sein.

Für die Analyse sind insbesondere folgende Angaben hilfreich:

• betroffene Domain
• verwendete PHP-Version
• Name der benötigten PHP-Erweiterung
• verwendete Anwendung beziehungsweise CMS
• betroffenes Plugin oder Theme, falls relevant
• vollständige Fehlermeldung
• seit wann das Problem besteht
• ob zuvor die PHP-Version geändert oder die Website migriert wurde

Übermittle dabei keine Passwörter oder andere vertrauliche Zugangsdaten.

Zusammenfassung #

PHP-Erweiterungen ergänzen PHP um zusätzliche Funktionen. Anwendungen können beispielsweise curl, intl, mbstring, mysqli, zip oder andere Extensions benötigen.

CURIAWEB empfiehlt für die PHP-Version einer Website grundsätzlich MultiPHP/EasyApache. Die PHP-Version verwaltest du über Software → MultiPHP-Manager.

Der zusätzlich sichtbare CloudLinux-Bereich PHP-Version wählen stellt eine separate PHP-Verwaltung dar. Verwende ihn nicht parallel, um vermeintlich fehlende Erweiterungen einer MultiPHP-Website zu ergänzen.

Wenn eine Anwendung eine fehlende Extension meldet, prüfe zuerst die verwendete PHP-Version, den genauen Namen der Erweiterung und die offiziellen Anforderungen der Anwendung. Unterscheide dabei zwischen PHP-Erweiterungen, PHP-Einstellungen und PHP-Limits.

Fehlt eine zwingend benötigte Extension tatsächlich in der verwendeten MultiPHP-/EasyApache-Umgebung, sollte geprüft werden, ob sie serverseitig für diese PHP-Version bereitgestellt werden kann.

Die wichtigste Regel lautet: Nicht wahllos PHP-Module oder unterschiedliche PHP-Systeme aktivieren – zuerst feststellen, welche Erweiterung von welcher Anwendung unter welcher PHP-Version tatsächlich benötigt wird.