PHP & PHP-FPM auf Ubuntu 20.04 installieren [Anleitung]

PHP ist eine weit verbreitete serverseitige Skriptsprache, die zur Entwicklung dynamischer Webanwendungen eingesetzt wird. Mit PHP-FPM lässt sich die Performance steigern, da PHP-Prozesse effizienter verwaltet werden.

Diese Anleitung zeigt, wie man PHP und PHP-FPM auf Ubuntu 20.04 installiert und eine funktionierende PHP-Umgebung einrichtet.

Voraussetzungen

Bevor Sie beginnen, stellen Sie Folgendes sicher:

• Sie haben Zugriff auf einen Ubuntu 20.04 Server.
• Ein neuer A-Record für Ihre Domain verweist auf die IP-Adresse des Servers.
• Sie können sich per SSH als Nicht-Root-Benutzer mit Sudo-Rechten anmelden.
• Der Server ist auf dem neuesten Stand.

PHP installieren

PHP ist in den Standard-APT-Repositories von Ubuntu 20.04 verfügbar. Aktualisieren Sie die Serverpakete und installieren Sie die neueste PHP-Version.

Aktualisieren Sie den Paketindex:

$ sudo apt update

PHP installieren:

$ sudo apt install php -y

Die installierte PHP-Version überprüfen:

$ php -v

Beispielausgabe:

PHP 7.4.3-4ubuntu2.29 (cli) (built: Mar 25 2025 18:57:03) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.3-4ubuntu2.29, Copyright (c), by Zend Technologies

PHP-Erweiterungen installieren

Erweiterungen erweitern die Funktionen von PHP, z. B. für Datenbankanbindungen, Verschlüsselung oder Bildbearbeitung. Viele Anwendungen und Frameworks benötigen sie.

Gängige Erweiterungen installieren:

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

Mit diesem Befehl werden folgende Erweiterungen installiert:

• php-mysql: Stellt die Verbindung zu MySQL-Datenbanken her.
• php-mbstring: Unterstützt UTF-8-Textverarbeitung.
• php-bcmath: Ermöglicht präzise mathematische Berechnungen.
• php-zip: Aktiviert den Umgang mit ZIP-Archiven.
• php-gd: Fügt Bildbearbeitungsfunktionen hinzu.
• php-curl: Unterstützt Datentransfer über URLs.
• php-xml: Bietet Funktionen zur XML-Verarbeitung.

Alle verfügbaren Erweiterungen auflisten:

$ sudo apt-cache search php | grep "^php7.4"

Installierte Erweiterungen anzeigen:

$ 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 Ubuntu-Repositories enthalten und passt zur installierten PHP-Version. Installieren Sie es, um PHP-Anfragen effizient zu verarbeiten, und richten Sie es so ein, dass es beim Booten automatisch startet.

PHP-FPM installieren:

$ sudo apt install php-fpm -y

PHP-FPM-Version prüfen (für PHP 7.4):

$ php-fpm7.4 -v

Beispielausgabe:

PHP 7.4.3-4ubuntu2.29 (fpm-fcgi) (built: Mar 25 2025 18:57:03)
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.3-4ubuntu2.29, Copyright (c), by Zend Technologies

Den Inhalt des PHP-Konfigurationsverzeichnisses auflisten:

$ ls /etc/php/7.4/

Beispielausgabe:

apache2  cli  fpm  mods-available

Das Vorhandensein des fpm-Ordners bestätigt, dass PHP-FPM verfügbar ist und konfiguriert werden kann.

In das Pool-Konfigurationsverzeichnis wechseln:

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

Die Standard-Pool-Konfigurationsdatei bearbeiten:

$ sudo nano www.conf

Den Pool-Namen überprüfen:

[www]

User- und Group-Einstellungen prüfen:

user = www-data
group = www-data

Socket-Pfad kontrollieren:

listen = /run/php/php7.4-fpm.sock

Pool-Konfiguration anpassen:

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

Erklärung der wichtigsten Direktiven:

• pm: Legt den Prozess-Manager-Typ fest (static, dynamic, ondemand).
• pm.max_children: Definiert die maximale Anzahl an Kindprozessen.
• pm.start_servers, pm.min_spare_servers, pm.max_spare_servers: Steuern die Anzahl laufender und inaktiver Prozesse.
• pm.process_idle_timeout: Beendet inaktive Prozesse nach einer festgelegten Zeit.
• access.log: Protokolliert alle eingehenden Anfragen.
• slowlog & request_slowlog_timeout: Erfassen langsamer Anfragen zur Optimierung.

Speichern und schließen Sie die Datei, anschließend PHP-FPM neu starten, um die Änderungen zu übernehmen:

$ sudo systemctl restart php7.4-fpm

PHP und PHP-FPM testen

PHP ist für die Ausführung dynamischer Inhalte zuständig, während PHP-FPM die Verarbeitung optimiert und effizient steuert. Um die Funktionsfähigkeit zu prüfen, erstellen Sie eine Beispiel-PHP-Datei mit dem Nginx-Webserver.

Zum Home-Verzeichnis wechseln:

$ cd

Eine neue Datei sample.php erstellen:

$ nano sample.php

Folgenden Inhalt einfügen:

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

Datei speichern und schließen.

Das Skript mit der PHP-CLI ausführen:

$ php sample.php

Erwartete Ausgabe:

Greetings from centron! PHP is working correctly on this server

Damit ist bestätigt, dass PHP dynamische Dateien korrekt verarbeitet.

Nginx mit PHP-FPM konfigurieren

Installieren Sie Nginx, um die Integration mit PHP-FPM zu testen:

$ sudo apt install nginx -y

Standard-Virtual-Host-Config sichern:

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

Neue Standardkonfiguration anlegen:

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

Konfiguration hinzufügen:

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/php7.4-fpm.sock;
        fastcgi_index index.php;
        include fastcgi.conf;
    }
}

Diese Konfiguration lauscht auf Port 80, liefert Dateien aus /var/www/html aus und leitet PHP-Anfragen an den PHP-FPM-Socket weiter.

Konfiguration testen:

$ sudo nginx -t

Die Ausgabe sollte bestätigen, dass keine Syntaxfehler vorhanden sind.

Neue Datei /var/www/html/test.php erstellen:

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

Folgenden Inhalt einfügen:

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

Diese Datei zeigt die installierte PHP-Version und Konfigurationsdetails im Browser an.

Apache stoppen (falls aktiv), um Port 80 freizugeben:

$ sudo systemctl stop apache2

HTTP-Zugriff über UFW erlauben:

$ sudo ufw allow 80

Nginx neu starten:

$ sudo systemctl restart nginx

Im Browser aufrufen:

http://SERVER-IP/test.php

Mehrere PHP-Versionen installieren

Um weitere Versionen wie PHP 8.1 zu nutzen, fügen Sie das Repository ppa:ondrej/php hinzu.

PPA hinzufügen:

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

PHP 8.1 und den zugehörigen FPM-Dienst installieren:

$ sudo apt install -y php8.1 php8.1-fpm

PHP 8.1-Version prüfen:

$ php8.1 -v

Beispielausgabe:

PHP 8.1.32 (cli) (built: Mar 13 2025 18:26:45) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.32, Copyright (c) Zend Technologies
    with Zend OPcache v8.1.32, Copyright (c), by Zend Technologies

Status des PHP-FPM-Dienstes überprüfen:

$ sudo systemctl status php8.1-fpm

Die Ausgabe sollte bestätigen, dass der Dienst aktiv und in Betrieb ist.

Neues Webverzeichnis für PHP 8.1-Anwendungen anlegen:

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

Testdatei kopieren und als index.php speichern:

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

Neue Nginx-VHost-Datei erstellen:

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

Konfiguration einfügen:

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

    root  /var/www/php81-site;

    index index.php index.html;

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

Diese Konfiguration liefert Inhalte aus /var/www/php81-site über PHP 8.1-FPM und lauscht auf Port 9000.

Virtuellen Host aktivieren:

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

Nginx-Konfiguration erneut testen:

$ sudo nginx -t

Port 9000 in der Firewall freigeben:

$ sudo ufw allow 9000/tcp
$ sudo ufw reload

Nginx neu starten:

$ sudo systemctl restart nginx

Im Browser öffnen:

http://SERVER-IP:9000

Daraufhin wird die PHP-8.1-Info-Seite angezeigt. Mit /test.php können Sie parallel prüfen, dass PHP 7.4 weiterhin unabhängig funktioniert.

Fazit

Sie haben erfolgreich PHP und PHP-FPM auf Ubuntu 20.04 eingerichtet. Mehrere PHP-Versionen stehen für unterschiedliche Projekte bereit und sind über Nginx sicher integriert, um dynamische Webinhalte performant zu verarbeiten.