PHP und PHP-FPM auf Ubuntu 22.04 installieren & konfigurieren

PHP ist eine weit verbreitete serverseitige Skriptsprache, die zur Entwicklung dynamischer Webanwendungen eingesetzt wird. PHP-FPM (FastCGI Process Manager) erhöht die Effizienz und optimiert die Verarbeitung von PHP-Anfragen in Kombination mit Webservern.

Diese Anleitung zeigt Schritt für Schritt, wie Sie PHP und PHP-FPM auf Ubuntu 22.04 installieren, um eine funktionsfähige PHP-Umgebung für Ihre Anwendungen bereitzustellen.

Voraussetzungen

Vor dem Start stellen Sie sicher, dass Sie Folgendes haben:

• Einen Ubuntu 22.04 Server.
• SSH-Zugang als Nicht-Root-Benutzer mit sudo-Rechten.
• Einen vollständig aktualisierten Server.

PHP installieren

Ubuntu 22.04 bringt PHP bereits in den Standard-APT-Repositories mit. Führen Sie folgende Schritte aus, um das System zu aktualisieren und PHP zu installieren.

Paketindex aktualisieren

$ sudo apt update

PHP installieren

$ sudo apt install php -y

Installierte PHP-Version prüfen

$ php -v

Beispielausgabe:

PHP 8.1.2-1ubuntu2.21 (cli) (built: Mar 24 2025 19:04:23) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.2, Copyright (c) Zend Technologies
    with Zend OPcache v8.1.2-1ubuntu2.21, Copyright (c), by Zend Technologies

PHP-Erweiterungen installieren

Erweiterungen erweitern die Funktionalität von PHP, etwa für Datenbankanbindung, Verschlüsselung oder Bildbearbeitung. Installieren Sie gängige Erweiterungen mit folgendem Befehl:

$ sudo apt install -y php-mysql php-mbstring php-bcmath php-zip php-gd php-curl php-xml

Dieser Befehl installiert:

• php-mysql – Verbindet PHP mit MySQL-Datenbanken.
• php-mbstring – Unterstützung für UTF-8 und Multibyte-Strings.
• php-bcmath – Hohe Genauigkeit für mathematische Operationen.
• php-zip – Unterstützung für ZIP-Archive.
• php-gd – Bildbearbeitung und -verarbeitung.
• php-curl – Datentransfer über URLs.
• php-xml – XML-Parsing und -Verarbeitung.

Verfügbare PHP-Erweiterungen anzeigen

$ sudo apt-cache search php | grep "^php8.1"

Installierte PHP-Erweiterungen prüfen

$ php -m

Beispielausgabe:

[PHP Modules]
bcmath
calendar
Core
ctype
curl
date
dom
exif
FFI
.....

[Zend Modules]
Zend OPcache

PHP-FPM installieren und konfigurieren

PHP-FPM ist in den Standard-Repositories von Ubuntu 22.04 enthalten und entspricht der installierten PHP-Version. Gehen Sie wie folgt vor:

PHP-FPM installieren

$ sudo apt install php-fpm -y

PHP-FPM-Version prüfen

$ php-fpm8.1 -v

Ausgabe:

PHP 8.1.2-1ubuntu2.21 (fpm-fcgi) (built: Mar 24 2025 19:04:23)
Copyright (c) The PHP Group
Zend Engine v4.1.2, Copyright (c) Zend Technologies
    with Zend OPcache v8.1.2-1ubuntu2.21, Copyright (c), by Zend Technologies

PHP-FPM-Verzeichnisse prüfen

$ ls /etc/php/8.1/

Beispielausgabe:

apache2  cli  fpm  mods-available

PHP-FPM Pool-Konfiguration anpassen

Wechseln Sie ins Pool-Verzeichnis:

$ cd /etc/php/8.1/fpm/pool.d/

Öffnen Sie die Standardkonfigurationsdatei:

$ sudo nano www.conf

PHP-FPM Pool-Einstellungen prüfen

Pool-Name:

[www]

Benutzer- und Gruppeneinstellungen:

user = www-data
group = www-data

Socket-Pfad:

listen = /run/php/php8.1-fpm.sock

Prozessverwaltungseinstellungen:

pm = dynamic
pm.max_children = 5
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3

Erklärung:

• pm: Modus des Prozessmanagers (static, dynamic, ondemand).
• pm.max_children: Maximale Anzahl von Kindprozessen.
• pm.start_servers: Anzahl der Prozesse beim Start (nur für dynamic).
• pm.min_spare_servers: Mindestanzahl an Leerlaufprozessen.
• pm.max_spare_servers: Maximal erlaubte Leerlaufprozesse.
• pm.process_idle_timeout: Zeit, bevor Leerlaufprozesse beendet werden.
• access.log: Protokolliert Anfragen an den PHP-FPM Pool.
• slowlog: Pfad zur Protokollierung langsamer Anfragen.
• request_slowlog_timeout: Zeitlimit zur Erkennung langsamer Anfragen.

PHP-FPM neu starten

Starten Sie den Dienst neu, um Ihre Änderungen zu übernehmen:

$ sudo systemctl restart php8.1-fpm

PHP und PHP-FPM testen

PHP verarbeitet dynamische Inhalte, während PHP-FPM die Verbindung zwischen PHP und dem Webserver herstellt und Ressourcen optimal verwaltet. Folgen Sie diesen Schritten, um PHP und PHP-FPM mit Nginx zu prüfen.

Beispiel-PHP-Datei erstellen und testen

Wechseln Sie in Ihr Home-Verzeichnis:

$ cd

Erstellen Sie eine Datei mit dem Namen sample.php:

$ nano sample.php

Fügen Sie folgenden Inhalt ein:

<!--?php echo "Greetings from centron! PHP is working correctly on this server"; ?-->

Führen Sie das Skript über die PHP-CLI aus:

$ php sample.php

Erwartete Ausgabe:

Greetings from centron! PHP is working correctly on this server

Nginx installieren und konfigurieren

Installieren Sie Nginx, um PHP-Dateien über PHP-FPM auszuliefern:

$ sudo apt install nginx -y

Sichern Sie die Standardkonfiguration:

$ sudo mv /etc/nginx/sites-available/default /etc/nginx/sites-available/default.BAK

Erstellen Sie eine neue Standardkonfiguration:

$ sudo nano /etc/nginx/sites-available/default

Fügen Sie folgende Einstellungen hinzu:

server {
    listen 80 default_server;
    listen [::]:80 default_server;

    root  /var/www/html/;
    index index.html index.php index.nginx-debian.html;

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        include fastcgi.conf;
    }
}

Überprüfen Sie die Nginx-Konfiguration:

$ sudo nginx -t

Erwartete Ausgabe:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

PHP mit Nginx testen

Erstellen Sie im Verzeichnis /var/www/html eine Datei test.php:

$ sudo nano /var/www/html/test.php

Fügen Sie folgenden Code ein:

<!--?php phpinfo(); ?-->

Beenden Sie Apache, um Port 80 freizugeben:

$ sudo systemctl stop apache2

Erlauben Sie HTTP-Traffic über die Firewall (UFW):

$ sudo ufw allow 80

Starten Sie Nginx neu:

$ sudo systemctl restart nginx

Öffnen Sie Ihren Browser und rufen Sie auf:

http://SERVER-IP/test.php

Mehrere PHP-Versionen installieren

Einige Projekte benötigen unterschiedliche PHP-Versionen. Standardmäßig bietet Ubuntu 22.04 nur eine begrenzte Auswahl. Um ältere oder alternative Versionen wie PHP 7.4 zu installieren, verwenden Sie das Repository ppa:ondrej/php.

PHP-Repository hinzufügen

$ sudo add-apt-repository -y ppa:ondrej/php

PHP 7.4 und PHP-FPM installieren

$ sudo apt install -y php7.4 php7.4-fpm

PHP-Version prüfen

$ php7.4 -v

Beispielausgabe:

PHP 7.4.33 (cli) (built: Jun  6 2024 16:49:34) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.33, Copyright (c), by Zend Technologies

PHP-FPM Status prüfen

$ sudo systemctl status php7.4-fpm

Beispielausgabe:

● php7.4-fpm.service - The PHP 7.4 FastCGI Process Manager
     Loaded: loaded (/lib/systemd/system/php7.4-fpm.service; enabled; vendor preset: enabled)
     Active: active (running) since Sun 2025-04-06 16:24:27 UTC; 33s ago
       Docs: man:php-fpm7.4(8)
   Main PID: 31049 (php-fpm7.4)
     Status: "Processes active: 0, idle: 2, Requests: 0, slow: 0, Traffic: 0req/sec"

Neue Site für PHP 7.4 erstellen

Neues Verzeichnis anlegen:

$ sudo mkdir -p /var/www/php74-site

Die Testdatei als index.php kopieren:

$ sudo cp /var/www/html/test.php /var/www/php74-site/index.php

Neue Nginx-Serverkonfiguration erstellen:

$ sudo nano /etc/nginx/sites-available/php74-site.conf

Folgende Konfiguration einfügen:

server {
    listen 9000;
    listen [::]:9000;

    root  /var/www/php74-site;

    index index.php index.html;

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
        fastcgi_index index.php;
        include fastcgi.conf;
    }
}

Neue Site aktivieren:

$ sudo ln -s /etc/nginx/sites-available/php74-site.conf /etc/nginx/sites-enabled/

Nginx-Konfiguration testen:

$ sudo nginx -t

Erwartete Ausgabe:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Port 9000 in der Firewall freigeben:

$ sudo ufw allow 9000/tcp

Firewall-Regeln neu laden:

$ sudo ufw reload

Nginx neu starten:

$ sudo systemctl restart nginx

Greifen Sie im Browser auf Ihre PHP 7.4-Site zu:

http://SERVER-IP:9000

Sie sollten die PHP-7.4-Details sehen. Öffnen Sie zusätzlich Ihre Standardseite, um sicherzustellen, dass PHP 8.1 getrennt verarbeitet wird:

http://SERVER-IP/test.php

Fazit

In dieser Anleitung haben Sie PHP, PHP-FPM und mehrere PHP-Versionen auf Ubuntu 22.04 installiert. Mit PHP-FPM in Kombination mit Nginx lassen sich dynamische Anfragen effizient verarbeiten und mehrere Projekte mit unterschiedlichen PHP-Anforderungen parallel betreiben. Weitere Informationen finden Sie in der offiziellen PHP-Dokumentation.