Enabling and Managing PHP Extensions in cPanel

PHP extensions add extra functionality to PHP. Applications such as WordPress, WooCommerce, or other PHP systems may require certain extensions in order for individual functions to work correctly.

Typical PHP extensions include curl, int'l, mbstring, mysqli, zip or Good.

In CURIAWEB cPanel you will find various tools related to PHP. It is important to distinguish between the one recommended by CURIAWEB MultiPHP/EasyApache PHP environment and to distinguish it from the additionally available CloudLinux PHP Selector.

CURIAWEB recommendation: For the PHP version of a website, you generally use the MultiPHP Manager. Do not switch to another PHP manager just because an application requires a specific PHP extension.

What is a PHP extension? #

PHP already provides numerous basic functions. Additional extensions complement the language with further capabilities.

An application may, for example, require functions for:

• Database connections
• Image processing
• ZIP archive
• encrypted connections
• international character and speech processing
• XML processing
• HTTP or API connections

Various PHP extensions are used for this.

Typical PHP extensions #

Extension	Typical task
curl	Communication with other servers and web services
Good	Image processing
int'l	Internationalization, language, number and date formats
mbstring	Processing of multi-byte character encodings
mysqli	Connection to MySQL/MariaDB databases
OpenSSL	Cryptographic functions and encrypted communication
zip	Processing of ZIP archives
XML	Processing of XML data

This table is not a complete list. Which extensions are available and enabled depends on the respective PHP version and server configuration.

PHP extension and PHP version are two different things #

A PHP version and a PHP extension must not be confused with each other.

Simplified:

PHP version
→ PHP runtime environment

PHP extension
→ additional function within this PHP environment

For example, if an application requires a specific minimum version of PHP and additionally int'l required, both requirements must be met.

CURIAWEB uses MultiPHP for PHP versions #

For the selection of a domain's PHP version, CURIAWEB recommends:

Software → MultiPHP Manager

There you determine which of the available PHP versions your website uses.

You can find the complete instructions at Change PHP version in cPanel.

Why is there an additional „Select PHP Version“? #

In CURIAWEB-cPanel you will find under Software additionally the area Select PHP version. This belongs to the CloudLinux PHP management and provides a separate PHP environment with additional configuration options.

However, that does not mean that you should use both the MultiPHP Manager and the CloudLinux PHP Selector for a website at the same time.

Important: MultiPHP/EasyApache and the CloudLinux PHP Selector are different PHP management systems. You should not automatically consider settings from one environment as settings for the other.

Do not change the PHP management because of an extension #

If an application reports that, for example:

int'l

or:

zip

missing, shouldn't you change the PHP management as a first step.

Check first:

• which PHP version the website is actually using
• which specific extension is required
• whether the extension is already available in the PHP environment being used
• whether the error message is actually current

1. Check used PHP version #

Open in CURIAWEB-cPanel:

Software → MultiPHP Manager

Find the relevant domain and check the assigned PHP version.

Note the version used.

Practical Tip: Before looking for a supposedly missing PHP extension, you should always know which PHP version the website in question is actually using.

Read the application error message carefully. #

If an application reports a missing PHP extension, note its exact name.

For example, a message may essentially indicate that a certain extension is not available.

What is important here is the specific name such as:

int'l

mbstring

zip

or:

curl

Do not change multiple PHP components on speculation.

3. Check if the message actually concerns a PHP extension #

Not every PHP error message indicates a missing extension.

An application can also fail, for example, due to the following causes:

• unsupported PHP version
• PHP memory limit too low
• missing file permission
• Programming error
• missing PHP function
• incorrect application configuration

Therefore, check the wording of the error message before changing the PHP configuration.

4. Check error log for unclear PHP errors #

If the website only shows a general error, the error log may contain more detailed information.

A PHP error message can, for example, contain clues about a non-existent function or class.

We explain how to use the error log at Read cPanel Error Log and find website errors.

Typical reference to a missing extension #

Depending on the application and extension, messages may indicate, for example, that a required class or function is missing.

Such an error must be evaluated in its respective context.

The name of a missing function can often provide a hint as to which PHP extension it belongs to.

Important: Do not simply install or enable an extension based on a single word in an error message. First, check the requirements of the application being used.

5. Check system requirements of the application #

When you install a CMS, plugin, theme, or other PHP application, check its official system requirements.

For example, requirements such as the following can be listed there:

PHP: minimum version required
Extension: intl
Extension: mbstring
Extension: zip

This allows you to distinguish whether the application strictly requires an extension or merely recommends it for an optional feature.

Distinguish between obligation and recommendation #

Software vendors sometimes distinguish between:

• strictly required PHP extensions
• recommended PHP extensions
• Extensions for individual optional features

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.

Briefly explained: 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:

• affected domain
• verwendete PHP-Version
• Name der benötigten Erweiterung
• verwendete Anwendung
• exact error message

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.

Simplified:

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:

int'l

ist etwas anderes als eine PHP-Direktive wie:

memory_limit

Simplified:

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 Set PHP memory limit, upload size, and execution time.

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.

int'l #

Die Erweiterung int'l stellt Funktionen für Internationalisierung bereit.

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

Einige Anwendungen oder Bibliotheken setzen int'l 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.

Good #

Die Erweiterung Good 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.

A message like:

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“? #

A message like:

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

belong.

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

or:

ext-zip

verweisen.

The prefix 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.

Attention: 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.

Check:

• 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 Select PHP version 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“.

Important: 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 int'l, curl or mysqli to equate.

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.

Attention: 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.

Simplified:

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.

For example:

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.

Check instead:

• exact error message
• PHP version
• Anwendungsversion
• PHP settings
• 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.

This includes, for example:

• PHP version
• required PHP extensions
• PHP settings
• Datenbankanforderungen
• Cron jobs
• 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. Open 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.

Basic rule: 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.

When should you contact CURIAWEB support? #

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:

• affected 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

Do not transmit any passwords or other confidential access credentials.

Summary #

PHP-Erweiterungen ergänzen PHP um zusätzliche Funktionen. Anwendungen können beispielsweise curl, int'l, 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 Select PHP version 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.

The most important rule is: 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.