Instalacja PHP na Windows, Mac i Linux (sprawdź php -v)

Aby zainstalować PHP, uruchom jedno polecenie dla swojego systemu: winget install PHP.PHP.8.3 na Windowsie, brew install php na macOS albo sudo apt install php-cli na Ubuntu i Debianie. Potem otwórz nowy terminal i uruchom php -v. Jeśli wypisze numer wersji, PHP jest zainstalowane.

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

Twoja wersja i data kompilacji będą inne. W skrypcie te same informacje dają PHP_VERSION i phpversion(). Kliknij Run, aby zobaczyć, co zgłasza PHP tej strony:

<?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";

Instalacja PHP na Windowsie

Najszybsza droga to winget, który jest w Windows 10 i 11. Otwórz PowerShell albo Windows Terminal:

winget install PHP.PHP.8.3

Zamknij terminal, otwórz nowy i uruchom php -v. Nowe okno jest potrzebne, bo terminale zachowują PATH z chwili uruchomienia.

Instalacja ręczna:

1. Pobierz archiwum zip „VS16 x64 Non Thread Safe” z windows.php.net/download.
2. Rozpakuj je do krótkiej ścieżki, na przykład C:\php.
3. Skopiuj php.ini-development jako php.ini w tym samym folderze.
4. Dodaj C:\php do zmiennej Path (menu Start, „Edytuj zmienne środowiskowe systemu”, Zmienne środowiskowe).
5. Otwórz nowy terminal i uruchom php -v.

Jeśli chcesz mieć też Apache i MySQL w jednym instalatorze, XAMPP i Laragon zawierają je razem z PHP.

Instalacja PHP na macOS

macOS nie zawiera już PHP. Zainstaluj je przez Homebrew:

brew install php
php -v

brew install php daje najnowsze wydanie. Aby przypiąć wersję, zainstaluj ją po nazwie, na przykład brew install php@8.3. Formuły z wersją nie są domyślnie linkowane, więc dodaj ją do PATH poleceniem, które Homebrew wypisze na końcu instalacji. brew upgrade php zaktualizuje ją później.

Instalacja PHP na Linuksie

Ubuntu 24.04 i Debian 13 mają w swoich repozytoriach PHP 8.3 lub nowsze:

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

Na Fedorze, RHEL i podobnych systemach:

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

Rozszerzenia to osobne pakiety o nazwach php-<name>: na Debianie i Ubuntu php-mysql dodaje sterowniki MySQL (php-mysqlnd na Fedorze), a php-intl rozszerzenie intl. Jeśli na Ubuntu potrzebujesz nowszego PHP, niż oferuje dystrybucja, popularne repozytorium ppa:ondrej/php ma każdą wspieraną wersję:

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

Sprawdzanie wersji PHP w kodzie

Biblioteki często wymagają minimalnej wersji. version_compare porównuje łańcuchy wersji tak jak PHP, a PHP_VERSION_ID daje zwykłą liczbę całkowitą (80300 oznacza 8.3.0), którą łatwo porównać:

<?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";

Sprawdzanie zainstalowanych rozszerzeń

Wiele błędów po świeżej instalacji to brakujące rozszerzenie. W terminalu php -m wypisuje każde załadowane rozszerzenie. W kodzie extension_loaded sprawdza jedno po nazwie:

<?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";

Dopisz nazwy potrzebne Twojemu projektowi (na przykład pdo_mysql, intl, gd) i uruchom kod na swoim komputerze, aby zobaczyć, co doinstalować.

Gdzie jest php.ini

Ustawienia takie jak display_errors, memory_limit i upload_max_filesize są w php.ini. Polecenie terminala php --ini wypisuje, który plik jest ładowany. Z kodu:

<?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 i serwer WWW mogą używać różnych plików php.ini, więc ustawienie zmienione dla jednego nie zawsze działa dla drugiego. Strona o raportowaniu błędów pokazuje ustawienia, które warto zmienić najpierw na komputerze deweloperskim.

Częsty problem: terminal nadal uruchamia starą wersję

Po aktualizacji php -v czasem pokazuje poprzednią wersję. Uruchom which php (macOS, Linux) albo where php (Windows), aby zobaczyć, który plik binarny terminal znajduje najpierw. Na macOS to często wersja z Homebrew, która jest zainstalowana, ale nie zlinkowana; na Windowsie zwykle starszy folder wcześniej w Path, na przykład ten z XAMPP. Popraw kolejność, otwórz nowy terminal i sprawdź ponownie. Potem przejdź do uruchamiania plików PHP.