PHP-Version und Modul wechseln in Debian mit Apache2

Die PHP-Version und Modul auf Debian zwischen mehreren PHP-Versionen wechseln und für Apache2 aktivieren.

Auf einem Debian 10 und Debian 11 können mehrere PHP-Versionen installiert sein, dabei wird eine PHP-Version für das System und den Apache2-Webserver festgelegt und aktiviert.

Gehen wir davon aus, dass mehrere PHP-Versionen auf dem Debian-System installiert sind. Wie kann ich die PHP-Version für Apache2 beliebig wechseln? In diesem Tutorial zeigen wir, wie man zwischen mehreren verschiedenen PHP-Versionen wechselt. Für den Apache2-Webserver und im CLI.

PHP-Version und das Modul als Standard aktivieren

Es soll PHP 8.2 als aktive PHP-Version für CLI und Apache2 festgelegt werden. Dies geschieht indem man die Apache2-Module für alle anderen installierten PHP-Versionen deaktiviert und aus dem CLI mit dem Befehl update-alternatives festlegt.

$ update-alternatives --set php /usr/bin/php8.2
$ update-alternatives --set phar /usr/bin/phar8.2
$ update-alternatives --set phar.phar /usr/bin/phar.phar8.2

  Phar ist eine PHP-Erweiterung, die es ermöglicht, aus einer komprimierten Archivdatei heraus Programme oder Dateien im PHAR-Format (PHP-Archiv) verpackt zu verarbeiten. Die mit der Phar-PHP-Klasse erzeugten Archive werden in bzip2 und gzip-Komprimierung erstellt.

PHP-Modul für Apache2 wechseln und aktivieren

Die PHP-Module werden Mithilfe des Apache helper aktiviert. Für den Apache2-Webserver wird das entsprechende Modul mit dem Befehl a2enmod aktiviert, und mit a2dismod wird das Modul deaktiviert..

$ a2dismod php7.4
$ a2enmod php8.2
$ systemctl restart apache2

a2enmod ist ein Skript, dass das angegebene Modul innerhalb der Apache2-Konfiguration aktiviert. Dies geschieht durch die Erstellung von Symlinks innerhalb /etc/apache2/mods-enabled.
a2dismod ist ein Skript, um ein Modul zu deaktivieren, indem es diese Symlinks entfernt. Wenn man versucht, ein bereits aktiviertes Modul zu aktivieren oder ein bereits deaktiviertes zu deaktivieren, wird ein Fehler ausgegeben.

Es ist möglich, mehrere PHP-Module in einem Befehl zu deaktivieren.

$ a2dismod php5.6 php7.1 php7.3 php7.4 php8.0 php8.1

Mit dem Apache 2-Syntaxvalidator können alle auf dem System verfügbaren PHP-Module ausgegeben werden.

$ apache2ctl -M

Bei Red Hat oder Rocky Linux und AlmaLinux (CentOS) ist der Befehl.

$ apachectl -M
Loaded Modules:
 core_module (static)
 mime_module (shared)
 php_module (shared)
...

Es werden alle auf dem System installierten Apache2 PHP-Module ausgegeben, wie hier in verkürzter Form.

a2query ist ein Programm zum Abrufen von Konfigurationswerten des Apache 2 HTTP-Webserver, zulässige Werte werden zurückgegeben, selbst wenn der Apache 2-Syntaxvalidator fehlschlägt.

$ a2query -m | grep php
php8.2 (enabled by site administrator)

Ebenso kann man sich die verfügbaren Apache2 PHP-Module auf dem Filesystem mithilfe von find abrufen und anzeigen lassen.

$ find /etc/apache2/mods-available/ -name *php\*

Die systemweiten PHP Einstellungen findet man unter /etc/php, für änderungen mit Apache2 editiert man die Datei php.ini.

$ vi /etc/php/8.2/apache2/php.ini

quote  Im Verzeichnispfad die Versionsnummer entsprechend ersetzen.

Aktive PHP-Version überprüfen

Welche PHP-Version aktiv ist? kann aus CLI abgerufen werden, die auf dem System aktiv festgelegte PHP-Version wie folgt abfragen.

$ php -v
PHP 8.2.3 (cli) (built: Feb 14 2023 16:53:07) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.3, Copyright (c) Zend Technologies
    with Zend OPcache v8.2.3, Copyright (c), by Zend Technologies

Mit anlegen einer php-Datei und folgendem Inhalt, zeigt der Apache-Webserver die aktuell ausgeführte PHP-Version und die Module.

<?php
phpinfo();
?>

Die php-Datei phpinfo.php in der DocumentRoot /var/www/html anlegen, sofern nicht eine andere DocumentRoot vorgesehen ist.

Im Browser wird die für den Apache2-Webserver konfigurierte PHP-Version und die PHP-Module angezeigt: http://ip_oder_fqdn/phpinfo.php

Beispiel: http://192.168.3.2/phpinfo.php

PHP-Version und Modul wechseln auf Debian mit Apache2

  Bei einem produktiven System sollte phpinfo.php nach beendeter Überprüfung wieder aus der DocumentRoot entfernt werden.

phpMyAdmin mit PHP8.2 Installation in Debian

phpMyAdmin Installation mit PHP 8.2 in Debian 12

Tutorial zur Installation von phpMyAdmin auf Debian 11 und Debian 12 mit Apache2. Für die Administration und Verwaltung von MySQL und MariaDB-Datenbanken aus dem Web-Browser.

Unter Debian lässt sich phpMyAdmin am einfachsten über den Paket Managerapt install phpmyadminaus dem Debian Standard Repository installieren, was dann allerdings für PHP 7.4 bereitgestellt wird.

Möchte man unter Debian 12 jedoch eine neuere PHP-Version nutzen, beispielsweise etwa für ein aktuelles CMS wie WordPress, wo PHP 8.2 oder neuer empfohlen wird, lässt sich phpMyAdmin manuell in nur wenigen Schritten installieren.

PHP Installation auf Debian

Die phpMyAdmin Installation auf Debian erfolgt hier als root „su -“ um Apache2, MariaDB und PHP 8.2 von DEB.SURY.ORG bereitzustellen.

Zuerst benötigte Dienstpakete für in weiterem Verlauf installieren

$ apt install lsb-release apt-transport-https ca-certificates wget gnupg -y

Das Sury Repository für PHP 8 auf dem System hinzufügen.

$ wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
$ echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/php.list

Aktualisieren der Paketlisten wie folgt.

$ apt update

Wenn der Apache2-Webserver noch nicht installiert ist.

$ apt install apache2 -y

Nun PHP 8.2 mit den wichtigsten PHP-Module installieren.

$ apt install php8.2 php8.2-common php8.2-cli php8.2-curl php8.2-imap php8.2-apcu php8.2-intl php8.2-cgi php8.2-mbstring php8.2-gd php8.2-mysql php8.2-opcache php8.2-bcmath php8.2-xml php8.2-xsl php8.2-zip php8.2-bz2 libapache2-mod-php8.2 -y

Aktualisieren der bereitgestellten Pakete wie folgt.

$ apt update && apt upgrade -y
$ [ -f /var/run/reboot-required ] && reboot -f

MariaDB Installation

Im nächsten Schritt wird der MariaDB-Server und (MySQL) Client auf dem Server installiert.

$ apt install mariadb-server mariadb-client -y

Dann die Konfiguration des MariaDB-Servers abschliessen.

$ mysql_secure_installation

Da noch kein Root-Passwort für die Datenbank festgelegt ist, Vervollständige die folgenden Abfragen:

  • Switch to unix_socket authentication [Y/n] – Enter n to skip.
  • Set root password? [Y/n] – Type y and press Enter to create a root password for your database. If you already have a root password, enter n to not change the root password.
  • Remove anonymous users? [Y/n] – Type y and press Enter.
  • Disallow root login remotely? [Y/n] – Type y and press Enter.
  • Remove test database and access to it? [Y/n] – Type y and confirm with Enter.
  • Reload privilege tables now? [Y/n] – Type y and confirm with Enter.

MariaDB ist nun betriebsbereit. Weiter mit Verzeichnispfad wechseln.

$ cd /usr/share

phpMyAdmin Installation auf Debian

Für die phpMyAdmin Installation auf Debian wird die aktuelle Version heruntergeladen mit dem folgenden Befehl.

$ wget https://www.phpmyadmin.net/downloads/phpMyAdmin-latest-all-languages.zip -O phpmyadmin.zip

Entpacken des soeben heruntergeladenen Archiv wie folgt.

$ unzip phpmyadmin.zip

Nach dem entpacken das heruntergeladene Archiv entfernen.

$ rm -f phpmyadmin.zip

Anschließend der Name des entpackten Verzeichnisses umbenennen.

$ mv phpMyAdmin-*-all-languages phpmyadmin

Und die Rechte auf das phpMyAdmin-Verzeichnis ändern.

$ chmod -R 0755 phpmyadmin

Apache Konfiguration für phpMyAdmin

Erstelle nun eine Apache2-Konfigurationsdatei für phpMyAdmin in /etc/apache2/conf-available/phpmyadmin.conf.

Dazu den folgenden Inhalt in der Terminal Shell einfügen.

$ cat << EOF > /etc/apache2/conf-available/phpmyadmin.conf
Alias /phpmyadmin /usr/share/phpmyadmin

<Directory /usr/share/phpmyadmin>
    Options SymLinksIfOwnerMatch
    DirectoryIndex index.php
</Directory>

<Directory /usr/share/phpmyadmin/templates>
    Require all denied
</Directory>
<Directory /usr/share/phpmyadmin/libraries>
    Require all denied
</Directory>
<Directory /usr/share/phpmyadmin/setup/lib>
    Require all denied
</Directory>
EOF

Die neue Apache2-Konfiguration überprüfen.

$ apachectl -t
Syntax OK

Die soeben erstellte Apache2-Konfigurationsdatei aktivieren.

$ a2enconf phpmyadmin

Und den Apache2-Webserver Neuladen.

$ systemctl reload apache2

Erstellen das temporären Verzeichnis, welches phpMyAdmin benötigt.

$ mkdir /usr/share/phpmyadmin/tmp/

Dem Webserver-Benutzer nun die benötigten Besitzerrechte erteilen.

$ chown -R www-data:www-data /usr/share/phpmyadmin/tmp/

  Bis und mit Debian 10 sowie unter Ubuntu ist aus Sicherheitsgründen die Passwort-Authentifizierung beim MariaDB-Server standardmäßig für die Root-Anmeldung deaktiviert (z.B. über phpMyAdmin). Unter Debian 11 ist dies jedoch möglich. Bei Debian 10 können die nachfolgenden Schritte durchgeführt werden, um die Root-Anmeldung mittels Passwort ebenfalls zu erlauben.

$ mysql -u root
UPDATE mysql.user SET plugin = 'mysql_native_password' WHERE user = 'root' AND plugin = 'unix_socket';
FLUSH PRIVILEGES;
quit

Der Apache2-Webserver mit PHP, der MariaDB-Server und phpMyAdmin ist nun einsatzbereit.

Jetzt können wir die phpMyAdmin-Webseite öffnen, indem wir zur IP-Adresse oder FQDN in der Browser URL /phpmyadmin hinten anfügen.
Zum Beispiel: http://192.168.1.2/phpmyadmin

phpMyAdmin mit PHP8 Installation auf Debian 12

PHP-Version anzeigen und ändern

Bei einem System wo mehrere PHP-Versionen installiert sind, kann eine PHP-Version für den Apache2-Webserver aktiviert werden.

Dabei wird das entsprechende Modul mit dem Apache helper aktiviert, mit dem Befehl a2enmod, und mit a2dismod wird es deaktiviert.

$ a2dismod php7.4
$ a2enmod php8.2
$ systemctl restart apache2

Mit anlegen einer php-Datei und folgendem Inhalt, wird aktuelle PHP-Version und die PHP-Module angezeigt. Wenn Du keine Standard Apache2-Site angelegt hast, speichere die Datei phpinfo.php in der Docroot unter /usr/share/phpmyadmin.

<?php
phpinfo();
?>

Die PHP-Einstellungen für den Apache2-Webserver werden in Tabellenform im Browser ausgegeben. Beispiel: http://192.168.1.2/phpinfo.php

phpMyAdmin mit PHP8 Installation auf Debian 12, phpinfo

  Für produktive Systeme sollte phpinfo wieder entfernt werden.