Установка PHP на Windows, Mac и Linux (проверка php -v)

Чтобы установить PHP, выполните одну команду для своей системы: winget install PHP.PHP.8.3 в Windows, brew install php в macOS или sudo apt install php-cli в Ubuntu и Debian. Затем откройте новый терминал и запустите php -v. Если команда печатает номер версии, PHP установлен.

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

Ваши версия и дата сборки будут другими. Внутри скрипта ту же информацию дают PHP_VERSION и phpversion(). Нажмите Run, чтобы увидеть, что сообщает PHP на этой странице:

<?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 в Windows

Быстрее всего через winget, он входит в Windows 10 и 11. Откройте PowerShell или Windows Terminal:

winget install PHP.PHP.8.3

Закройте терминал, откройте новый и выполните php -v. Новое окно нужно, потому что терминал сохраняет тот PATH, с которым был запущен.

Установка вручную:

1. Скачайте zip-архив "VS16 x64 Non Thread Safe" с windows.php.net/download.
2. Распакуйте его по короткому пути, например C:\php.
3. Скопируйте php.ini-development в php.ini в той же папке.
4. Добавьте C:\php в переменную Path (меню Пуск, "Изменение системных переменных среды", Переменные среды).
5. Откройте новый терминал и выполните php -v.

Если вам нужны ещё Apache и MySQL в одном установщике, XAMPP и Laragon поставляют их вместе с PHP.

Установка PHP в macOS

В macOS больше нет встроенного PHP. Установите его через Homebrew:

brew install php
php -v

brew install php ставит последний релиз. Чтобы закрепить версию, установите её по имени, например brew install php@8.3. Формулы с версией по умолчанию не линкуются, поэтому добавьте PHP в PATH командой, которую Homebrew печатает в конце установки. Позже обновить PHP можно через brew upgrade php.

Установка PHP в Linux

В Ubuntu 24.04 и Debian 13 PHP 8.3 или новее есть в собственных репозиториях:

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

В Fedora, RHEL и похожих системах:

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

Расширения ставятся отдельными пакетами с именами php-<name>: в Debian и Ubuntu php-mysql добавляет драйверы MySQL (php-mysqlnd в Fedora), а php-intl расширение intl. Если в Ubuntu нужен PHP новее, чем в дистрибутиве, в популярном репозитории ppa:ondrej/php есть все поддерживаемые версии:

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

Проверка версии PHP в коде

Библиотекам часто нужна минимальная версия. version_compare сравнивает строки версий так же, как это делает PHP, а PHP_VERSION_ID даёт простое целое число (80300 означает 8.3.0), которое легко сравнивать:

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

Какие расширения установлены

Многие ошибки после свежей установки вызваны отсутствующим расширением. В терминале php -m выводит все загруженные расширения. В коде extension_loaded проверяет одно расширение по имени:

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

Добавьте имена, которые нужны вашему проекту (например, pdo_mysql, intl, gd), и запустите код на своём компьютере, чтобы понять, что доустановить.

Где найти php.ini

Настройки вроде display_errors, memory_limit и upload_max_filesize хранятся в php.ini. Команда терминала php --ini показывает, какой файл загружен. Из кода:

<?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 и веб-сервер могут использовать разные файлы php.ini, поэтому настройка, изменённая для одного, не всегда действует для другого. На странице про вывод ошибок описаны настройки, которые стоит изменить на машине разработчика в первую очередь.

Частая проблема: терминал всё ещё запускает старую версию

После обновления php -v иногда показывает прежнюю версию. Выполните which php (macOS, Linux) или where php (Windows), чтобы увидеть, какой исполняемый файл терминал находит первым. В macOS это часто версия Homebrew, которая установлена, но не слинкована; в Windows обычно старая папка, стоящая раньше в Path, например папка из XAMPP. Исправьте порядок, откройте новый терминал и проверьте снова. Потом переходите к запуску PHP-файлов.