PHP installieren: Windows, Mac, Linux (php -v prüfen)

Um PHP zu installieren, führst du einen Befehl für dein System aus: winget install PHP.PHP.8.3 unter Windows, brew install php unter macOS oder sudo apt install php-cli unter Ubuntu und Debian. Öffne danach ein neues Terminal und führe php -v aus. Wenn eine Versionsnummer erscheint, ist PHP installiert.

php -v

PHP 8.3.19 (cli) (built: Mar 27 2025 11:08:15) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.19, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.19, Copyright (c), by Zend Technologies

Deine Version und dein Build-Datum werden abweichen. In einem Skript liefern PHP_VERSION und phpversion() dieselbe Information. Klicke auf Run, um zu sehen, was das PHP dieser Seite meldet:

<?php
echo "PHP version: " . phpversion() . "\n";
echo "Version as a number: " . PHP_VERSION_ID . "\n";
echo "Operating system family: " . PHP_OS_FAMILY . "\n";
echo "Integer size: " . PHP_INT_SIZE * 8 . " bit\n";

PHP unter Windows installieren

Am schnellsten geht es mit winget, das bei Windows 10 und 11 dabei ist. Öffne PowerShell oder Windows Terminal:

winget install PHP.PHP.8.3

Schließe das Terminal, öffne ein neues und führe php -v aus. Ein neues Fenster ist nötig, weil Terminals den PATH behalten, mit dem sie gestartet wurden.

So installierst du stattdessen von Hand:

1. Lade das Zip „VS16 x64 Non Thread Safe“ von windows.php.net/download herunter.
2. Entpacke es in einen kurzen Pfad wie C:\php.
3. Kopiere php.ini-development im selben Ordner nach php.ini.
4. Füge C:\php zur Variable Path hinzu (Startmenü, „Systemumgebungsvariablen bearbeiten“, Umgebungsvariablen).
5. Öffne ein neues Terminal und führe php -v aus.

Wenn du Apache und MySQL in einem Installer haben willst: XAMPP und Laragon bündeln beides mit PHP.

PHP unter macOS installieren

macOS bringt PHP nicht mehr mit. Installiere es mit Homebrew:

brew install php
php -v

brew install php liefert das neueste Release. Um eine Version festzulegen, installierst du sie per Namen, zum Beispiel brew install php@8.3. Versionierte Formulae werden standardmäßig nicht verlinkt, also füge sie mit dem Befehl, den Homebrew am Ende der Installation ausgibt, zu deinem PATH hinzu. Mit brew upgrade php aktualisierst du später.

PHP unter Linux installieren

Ubuntu 24.04 und Debian 13 liefern PHP 8.3 oder neuer in ihren eigenen Repositories:

sudo apt update
sudo apt install php-cli php-mbstring php-xml php-curl
php -v

Unter Fedora, RHEL und ähnlichen Systemen:

sudo dnf install php-cli php-mbstring php-xml
php -v

Erweiterungen sind eigene Pakete mit dem Namen php-<name>: Unter Debian und Ubuntu fügt php-mysql die MySQL-Treiber hinzu (php-mysqlnd unter Fedora) und php-intl die intl-Erweiterung. Wenn du unter Ubuntu ein neueres PHP brauchst, als deine Distribution anbietet, hat das weit verbreitete Repository ppa:ondrej/php jede unterstützte Version:

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.3-cli

Die PHP-Version im Code prüfen

Bibliotheken brauchen oft eine Mindestversion. version_compare vergleicht Versionsstrings so, wie PHP es tut, und PHP_VERSION_ID liefert eine einfache Ganzzahl (80300 bedeutet 8.3.0), die sich leicht vergleichen lässt:

<?php
$required = '8.1.0';

if (version_compare(PHP_VERSION, $required, '>=')) {
    echo "PHP " . PHP_VERSION . " is new enough (need $required)\n";
} else {
    echo "Please upgrade: this code needs PHP $required\n";
}

echo PHP_VERSION_ID >= 80300 ? "8.3 features are available\n" : "Older than 8.3\n";
echo "Major: " . PHP_MAJOR_VERSION . ", minor: " . PHP_MINOR_VERSION . "\n";

Prüfen, welche Erweiterungen installiert sind

Viele Fehler nach einer frischen Installation sind eine fehlende Erweiterung. Im Terminal listet php -m jede geladene Erweiterung auf. Im Code prüft extension_loaded eine einzelne per Namen:

<?php
$needed = ['mbstring', 'json', 'ctype', 'dom'];

foreach ($needed as $ext) {
    $status = extension_loaded($ext) ? 'loaded' : 'MISSING';
    printf("%-10s %s\n", $ext, $status);
}

echo "\nTotal extensions loaded: " . count(get_loaded_extensions()) . "\n";

Füge die Namen hinzu, die dein Projekt braucht (zum Beispiel pdo_mysql, intl, gd), und führe es auf deinem eigenen Rechner aus, um zu sehen, was du installieren musst.

php.ini finden

Einstellungen wie display_errors, memory_limit und upload_max_filesize stehen in php.ini. Der Terminalbefehl php --ini zeigt, welche Datei geladen wird. Im Code:

<?php
$ini = php_ini_loaded_file();
echo $ini === false ? "No php.ini loaded, PHP uses its defaults\n" : "Loaded: $ini\n";

echo "memory_limit = " . ini_get('memory_limit') . "\n";
echo "max_execution_time = " . ini_get('max_execution_time') . "\n";

CLI und Webserver können verschiedene php.ini-Dateien verwenden, deshalb gilt eine Einstellung, die du für das eine änderst, nicht immer auch für das andere. Die Seite zur Fehlerausgabe zeigt die Einstellungen, die du auf einem Entwicklungsrechner zuerst ändern solltest.

Häufiges Problem: Das Terminal startet noch die alte Version

Nach einem Upgrade meldet php -v manchmal noch die vorherige Version. Führe which php (macOS, Linux) oder where php (Windows) aus, um zu sehen, welche Binärdatei das Terminal zuerst findet. Unter macOS ist das oft eine Homebrew-Version, die installiert, aber nicht verlinkt ist; unter Windows meist ein älterer Ordner, der früher in Path steht, etwa der aus XAMPP. Korrigiere die Reihenfolge, öffne ein neues Terminal und prüfe erneut. Danach geht es weiter mit PHP-Dateien ausführen.