PHP aktualisieren (Debian/Ubuntu)#

Neue PHP-Versionen bringen Sicherheitsfixes, bessere Performance und neue Funktionen. Gleichzeitig setzt i-doit bestimmte PHP-Versionen voraus — prüfe vor dem Update immer die Systemvoraussetzungen, welche Versionen aktuell unterstützt werden.

Dieser Artikel beschreibt den Wechsel von einer PHP-Version auf eine neuere unter Debian und Ubuntu — mit den offiziellen Paketquellen, ohne Drittanbieter-Repositories.

Kurzanleitung (TL;DR)#

Am Beispiel eines Wechsels von PHP 8.2 auf PHP 8.3 mit PHP-FPM:

Welche PHP-Version liefert meine Distribution?#

Du kannst nur die PHP-Version installieren, die deine Distribution in ihren offiziellen Repositories anbietet. Für eine neuere Version müsstest du die Distribution selbst upgraden.

Prüfe, welche Version verfügbar ist:

1

apt-cache search php8

Vorbereitungen#

1. System aktualisieren#

1

sudo apt update && sudo apt upgrade

2. Aktuelle PHP-Version ermitteln#

1
2
3
4
5
6
7
8

# Kommandozeile:
php -v

# Geladene Module:
php -m

# Aktive Konfigurationsdateien:
php --ini

3. Apache-Integrationsmethode prüfen#

Es gibt zwei Wege, wie Apache PHP-Dateien verarbeitet:

Welche Methode aktuell aktiv ist:

1
2
3
4
5

# mod_php aktiv?
apache2ctl -M | grep php

# PHP-FPM aktiv?
systemctl status php*-fpm

PHP-Pakete installieren#

Installiere die Pakete für die neue Version. Im folgenden Beispiel wird PHP 8.2 durch PHP 8.3 ersetzt — passe die Versionsnummern an deine Situation an.

1

sudo apt install php8.3-{bcmath,cli,common,curl,fpm,gd,imagick,ldap,mbstring,memcached,mysql,pgsql,soap,xml,zip}

Falls du mod_php statt PHP-FPM verwendest, installiere zusätzlich:

1

sudo apt install libapache2-mod-php8.3

PHP-Konfiguration migrieren#

i-doit Konfiguration erstellen#

Der sauberste Weg: Erstelle eine eigene .ini-Datei mit den i-doit-spezifischen Einstellungen:

1

sudo nano /etc/php/8.3/mods-available/i-doit.ini

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

allow_url_fopen = Yes
file_uploads = On
max_execution_time = 300
max_file_uploads = 42
max_input_time = 60
max_input_vars = 10000
memory_limit = 256M
post_max_size = 128M
register_argc_argv = On
short_open_tag = On
upload_max_filesize = 128M
display_errors = Off
display_startup_errors = Off
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
log_errors = On
default_charset = "UTF-8"
default_socket_timeout = 60
date.timezone = Europe/Berlin
session.gc_maxlifetime = 604800
session.cookie_lifetime = 0
mysqli.default_socket = /var/lib/mysql/mysql.sock

Aktiviere die Konfiguration für alle SAPIs (CLI und FPM):

1

sudo phpenmod -v 8.3 i-doit

Die vollständigen Einstellungen findest du unter Systemeinstellungen.

Wo liegen die php.ini-Dateien?#

Apache konfigurieren#

Variante A: PHP-FPM (empfohlen)#

1. Sicherstellen, dass mod_php deaktiviert ist:

1
2

sudo a2dismod php8.2   # alte Version
sudo a2dismod php8.3   # auch die neue — FPM braucht kein mod_php

2. Apache-Module für FPM aktivieren:

1

sudo a2enmod proxy_fcgi setenvif rewrite

3. MPM auf event umstellen (bessere Performance als prefork):

1
2

sudo a2dismod mpm_prefork
sudo a2enmod mpm_event

4. VirtualHost anpassen:

Ändere den Socket-Pfad in /etc/apache2/sites-available/i-doit.conf:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

<VirtualHost *:80>
    ServerName cmdb.firma.de
    DocumentRoot /var/www/html/

    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php8.3-fpm.sock|fcgi://localhost/"
    </FilesMatch>

    <Directory /var/www/html/>
        AllowOverride All
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

5. PHP-FPM und Apache neu starten:

1

sudo systemctl restart php8.3-fpm apache2

Variante B: mod_php#

1. Alte Version deaktivieren, neue aktivieren:

1
2

sudo a2dismod php8.2
sudo a2enmod php8.3

2. MPM auf prefork (mod_php erfordert dies):

1
2

sudo a2dismod mpm_event
sudo a2enmod mpm_prefork

3. Apache neu starten:

1

sudo systemctl restart apache2

Installation prüfen#

PHP-Version verifizieren#

1
2
3
4
5

# Kommandozeile:
php -v

# Webserver — welche Version Apache verwendet:
php -r 'echo php_sapi_name();'

i-doit prüfen#

1. Öffne i-doit im Browser und prüfe ob alles funktioniert
2. Gehe zu Verwaltung → Systemreparatur und Bereinigung und leere den Cache
3. Prüfe die Systemübersicht unter Verwaltung → Systemübersicht — dort siehst du die aktive PHP-Version

Alte PHP-Version entfernen#

Wenn alles funktioniert, entferne die alte Version:

1
2

sudo apt purge php8.2*
sudo apt autoremove

Häufige Probleme#

HTTP 500 Internal Server Error#

• Logs prüfen: tail -50 /var/log/apache2/error.log und journalctl -u php8.3-fpm
• Socket-Mismatch: Der häufigste Fehler — der Pfad im VirtualHost stimmt nicht mit der FPM-Konfiguration überein
• Fehlende Module: php -m zeigt, welche Module geladen sind. Vergleiche mit den Systemvoraussetzungen
• Dateiberechtigungen: www-data braucht Lesezugriff auf die PHP-Dateien
• Konfigurationsfehler: apache2ctl configtest prüft die Apache-Syntax

PHP-Code wird als Text angezeigt#

Apache leitet die .php-Dateien nicht an den PHP-Interpreter weiter:

• Bei PHP-FPM: Fehlt der <FilesMatch> Block im VirtualHost?
• Läuft der FPM-Dienst? systemctl status php8.3-fpm
• Ist mod_php und FPM gleichzeitig aktiv? Das führt zu Konflikten — deaktiviere mod_php.

Fehlermeldungen über fehlende Erweiterungen#

Prüfe die geladenen Module und vergleiche mit den benötigten:

1

php -m | sort

Fehlende Module nachinstallieren:

1

sudo apt install php8.3-<modulname>

Änderungen an php.ini wirken nicht#

• Falsche Datei bearbeitet? CLI, FPM und mod_php haben jeweils eigene php.ini-Dateien
• Dienst nicht neu gestartet? Nach Änderungen an der FPM-Konfiguration: sudo systemctl restart php8.3-fpm
• Eigene .ini überschrieben? Prüfe mit php --ini welche Dateien geladen werden und in welcher Reihenfolge