3 Installation und Konfiguration von PHP

Eine korrekte und klar nachvollziehbare Installation von PHP bildet die Grundlage jeder PHP-Entwicklungsumgebung. In diesem Kapitel erfahren Sie, wie Sie PHP auf verschiedenen Betriebssystemen installieren und optimal in VSCode und PHPStorm einrichten. Der Schwerpunkt liegt auf der Einrichtung unter Windows.

3.1 PHP unter Windows installieren

Unter Windows haben Sie zwei bewährte und leicht nachvollziehbare Methoden:

3.1.1 Methode 1: Direkter Download (empfohlen)

Schritte:

1. Laden Sie die PHP ZIP-Datei (Non Thread Safe für CLI, Thread Safe für Webserver) von php.net herunter.

2. Entpacken Sie die ZIP-Datei in einen Ordner Ihrer Wahl, z.B.:

C:\php

3. Benennen Sie die Datei php.ini-development in php.ini um.

4. Ergänzen Sie die Systemvariable PATH:

setx PATH "%PATH%;C:\php" /M

Starten Sie danach die Konsole neu und testen Sie die Installation mit:

php -v

3.1.2 Methode 2: Paketmanager Chocolatey

Alternativ können Sie den Paketmanager Chocolatey nutzen:

choco install php

Chocolatey erledigt die Umgebungsvariablen automatisch.

3.2 PHP unter macOS installieren

Verwenden Sie Homebrew, um PHP unkompliziert zu installieren:

brew install php

Testen der Installation:

php -v

3.3 PHP unter Linux installieren

Linux verwendet je nach Distribution unterschiedliche Paketmanager:

• Debian/Ubuntu:

sudo apt update
sudo apt install php php-cli php-fpm php-mysql php-mbstring php-xml php-curl

• Fedora/RHEL/CentOS:

sudo dnf install php php-cli php-fpm php-mysqlnd php-mbstring php-xml php-curl

Überprüfung:

php -v

3.4 PHP-Erweiterungen aktivieren (alle Systeme)

PHP-Erweiterungen aktivieren Sie über die Datei php.ini:

• Öffnen Sie die Datei php.ini in Ihrem Installationsordner.
• Entfernen Sie das Semikolon (;) vor der gewünschten Erweiterung, z.B.:

extension=mysqli
extension=curl
extension=mbstring

Nach Änderungen starten Sie ggf. den Webserver neu.

3.5 Wichtige PHP-Einstellungen (php.ini)

Folgende Einstellungen sind für Entwicklung sinnvoll:

display_errors = On
error_reporting = E_ALL
memory_limit = 128M
upload_max_filesize = 10M
post_max_size = 20M
date.timezone = "Europe/Berlin"

In Produktivumgebungen deaktivieren Sie Fehlerausgaben:

display_errors = Off
log_errors = On

3.6 PHP in VSCode einrichten

Schritte:

1. Installieren Sie die Erweiterung PHP Intelephense.

2. Prüfen Sie in VSCode unter:

File → Preferences → Settings → PHP

• Setzen Sie den korrekten Pfad zur PHP-Installation, z.B.:

"php.validate.executablePath": "C:\\php\\php.exe"

3. Prüfen Sie die Funktion durch Öffnen eines Terminals (STRG + Ö):

php -v

Ab jetzt bietet VSCode Autovervollständigung und Fehlerprüfung.

3.7 PHP in PHPStorm einrichten

Schritte:

1. Öffnen Sie PHPStorm, gehen Sie zu:

File → Settings → PHP

2. Klicken Sie bei „CLI Interpreter“ auf „…“, wählen Sie dann:

C:\php\php.exe

3. Prüfen Sie die Installation über das integrierte Terminal:

php -v

PHPStorm erkennt nun PHP automatisch und bietet umfassende Unterstützung.

3.8 PHP mit Webserver (Apache und Nginx)

PHP lässt sich via PHP-FPM effizient mit Webservern integrieren.

PHP-FPM installieren (Linux/macOS):

• Debian/Ubuntu:

sudo apt install php-fpm

• Fedora/CentOS:

sudo dnf install php-fpm

• macOS (Homebrew):

brew install php

3.8.1 Beispielkonfiguration für Nginx:

server {
    listen 80;
    root /var/www/html;
    server_name example.com;

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php-fpm.sock;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

3.8.2 Beispielkonfiguration für Apache (Linux):

Aktivieren der notwendigen Module:

sudo a2enmod proxy_fcgi setenvif

Virtueller Host in Apache (/etc/apache2/sites-available/000-default.conf):

<VirtualHost *:80>
    ServerName example.com
    DocumentRoot /var/www/html
    
    <FilesMatch \.php$>
        SetHandler "proxy:unix:/var/run/php/php-fpm.sock|fcgi://localhost"
    </FilesMatch>
</VirtualHost>

3.9 Installation von Composer (alle Systeme)

Composer wird für das PHP Dependency Management benötigt.

• Windows: Installer herunterladen und ausführen.

• macOS/Linux:

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
chmod +x /usr/local/bin/composer

Prüfung der Installation:

composer -v

3.10 Installation testen und häufige Fehler beheben

3.10.1 Testen der PHP-Installation

• Version ausgeben:

php -v

• Konfiguration anzeigen:

php -i

• Entwicklungsserver starten:

php -S localhost:8000

Testen Sie im Browser: http://localhost:8000

3.10.2 Häufige Fehlerquellen beheben:

• Prüfen, ob Erweiterungen geladen sind:

php -m | grep mysqli

• Berechtigungen der Konfigurationsdateien prüfen (Linux):

ls -la /etc/php/

• Webserver-Konfiguration testen:

Apache:

sudo apachectl configtest

Nginx:

sudo nginx -t

3.11 PHP-Versionen parallel betreiben (optional, fortgeschritten)

3.11.1 Windows:

• Unterschiedliche PHP-Versionen in getrennten Ordnern installieren (C:\php81, C:\php82).
• Jeweils den passenden Interpreter in VSCode oder PHPStorm einstellen.

3.11.2 Linux mit update-alternatives:

sudo apt install php7.4 php8.2
sudo update-alternatives --config php

Wählen Sie die gewünschte Version interaktiv aus.