Wiki-Quellcode von Update auf PHP 8.4

Zuletzt geändert von MACH formsolutions am 10.11.2025

Zeige letzte Bearbeiter
1 ## Update auf PHP 8.4
2
3 Mit der Version 4.111.0 ist die PHP-Version 8.4 zwingende Voraussetzung für die Verwendung von MACH formsolutions. Die Anleitung geht davon aus, dass der egov-installer.sh in der Version 4.111.0 heruntergeladen worden ist und an entsprechender Stelle zur Ausführung hinterlegt wurde. Mit einer höheren PHP-Version wurde MACH formsolutions nicht getestet und ist deshalb auch nicht offiziell freigegeben.
4
5 ### Update ohne Docker auf ubuntu
6
7 #### Vorbereitende Maßnahmen
8
9 Sofern auf Ihrem System der apache und wildfly derzeit noch laufen bitte diese beenden.
10
11 #### Löschen der bestehenden Installation von PHP 8.1
12
13 Zu Beginn der Installation wird die bestehende Installation mittels
14
15 sudo apt-get purge 'php8.*'
16
17 Nach dem Löschen sollten zur Sicherheit auch noch alles weitere entfernt werden mittels
18
19 sudo apt-get autoclean
20 sudo apt-get autoremove
21
22 #### Einbindung einer externen Paketquelle
23
24 In den Ubuntu-Versionen ist es notwendig für die Nutzung von PHP 8.4 eine externe Paketquelle einzubinden. Dieses erfolgt mittels
25
26 sudo add-apt-repository ppa:ondrej/php
27
28 #### Installation PHP 8.4
29
30 sudo apt-get update
31
32 und
33
34 sudo apt-get install php8.4
35
36 und starten anschließend den apache neu z.B. via
37
38 sudo systemctl restart apache2
39
40 Des Weiteren müssen noch einige PHP-Extensions installiert werden. Diese können über den folgenden Befehl installiert werden:
41
42 sudo apt install php8.4-mysql php8.4-xml php8.4-curl php8.4-gd php8.4-dev php8.4-mbstring php8.4-soap php8.4-tidy php8.4-bcmath -y
43
44 u.a. für CentOS zusätzliche PHP Module
45
46 php-pear und php-opcache
47
48 Bitte vergleichen Sie abschließend ob die Einträge Ihrer `php.ini` mit der aus dem [Artikel](https://wiki.form-solutions.de/wiki/admindoku/view/Main/01_Systemadministration/02_Vorbereitung/06_PHP/01_Konfiguration/)zu vergleichen und gegebenenfalls anzupassen.
49 Anschließend kann das Update wie gewohnt ausgeführt werden.
50
51 ## Update mit Docker
52
53 **Hinweis**: Dieser Schritt ersetzt für dieses Update die [[Standard-Updateroutine|doc:Main.01_Systemadministration.05_Anleitungen.03_Update.WebHome]].
54
55 ### Vorbereitungen
56
57 * Laden Sie wie gewohnt den [[egov-installer.sh|doc:Main.01_Systemadministration.03_Installation.02_Installer.WebHome]] herunter und legen ihn unter /opt/docker/fs/update/ ab.
58 * In der Datei _/opt/docker/fs/web/image/Dockerfile_ von _FROM php:8.1-apache_ auf _FROM php:8.4-apache_ umstellen.
59
60 ### Ausführung
61
62 Für die Ausführung des Updates bitten wir Sie die folgende [Datei](https://cloud.machproforms.de/index.php/s/L8zHy2962a3ak7G)herunterzuladen und diese unter _/opt/docker/fs_ abzulegen und anschließend via auszuführen
63
64 ./defaultUpdate_php8_4.sh