Как установить PHP на Windows, Linux и macOS
Для запуска PHP-скриптов достаточно интерпретатора и терминала. Для сайта понадобится веб-сервер или встроенный сервер PHP для локальной разработки. Ниже — установка на трёх ОС, выбор версии и диагностика типичных ошибок.
Какую версию PHP 8.x установить
Для нового проекта на конец 2026 года разумный выбор — PHP 8.5, если его поддерживают фреймворк, зависимости и нужные расширения. Для существующего проекта сначала посмотрите ограничение require.php в composer.json и версию PHP на сервере. Совпадение веток на компьютере, в CI и на сервере помогает ловить ошибки до выкладки.
| Ветка | Поддержка к концу 2026 года | Что есть в этой ветке |
|---|---|---|
| PHP 8.3 | Исправления безопасности | Типизированные константы классов, атрибут #[Override], функция json_validate() |
| PHP 8.4 | Активная поддержка до конца 2026 года, затем исправления безопасности | Хуки свойств, асимметричная видимость свойств, функции array_find() и array_any() |
| PHP 8.5 | Активная поддержка | Оператор конвейера |>, встроенное расширение URI, функции array_first() и array_last() |
Устанавливайте последний доступный патч выбранной ветки. Если библиотека должна работать на 8.3–8.5, запускайте тесты на всех трёх версиях и ориентируйтесь на синтаксис 8.3. Например, файл с оператором |> на PHP 8.4 завершится синтаксической ошибкой ещё до выполнения условий. После установки зависимостей команда composer check-platform-reqs сверит требования пакетов с текущими версиями PHP и расширений.
Как скачать PHP и установить его на Windows
Выберите сборку и распакуйте ZIP
Если вы ищете, где скачать PHP для Windows, откройте официальный раздел загрузок PHP for Windows. В списке PHP Downloads выберите ZIP с готовыми бинарными файлами нужной ветки. Для обычной 64-битной Windows на Intel или AMD берите сборку x64. Если PHP запускается в WSL, устанавливайте его пакетным менеджером внутри Linux.
- Non Thread Safe (NTS) подходит для командной строки, встроенного сервера PHP и IIS через FastCGI.
- Thread Safe (TS) нужна при подключении PHP как модуля Apache. Версия и разрядность сборки должны подходить к вашему Apache.
Распакуйте архив, например в C:\tools\php. Установите Microsoft Visual C++ Redistributable, указанный для выбранной сборки. Разрядность пакета должна совпадать с разрядностью PHP. В PowerShell проверьте запуск по полному пути и создайте конфигурацию для локальной разработки.
# Проверьте интерпретатор до настройки PATH
& 'C:\tools\php\php.exe' -v
# Создайте php.ini при первой установке
Copy-Item 'C:\tools\php\php.ini-development' 'C:\tools\php\php.ini'Добавьте PHP в PATH и включите расширения
В переменных среды пользователя добавьте C:\tools\php в Path. Откройте новое окно PowerShell и выполните команды ниже. Первая покажет, какие исполняемые файлы найдены, вторая — версию, которая запускается командой php, третья — загруженный файл настроек.
where.exe php
php -v
php --iniВ открытом php.ini укажите каталог расширений. Найдите нужные строки extension и снимите начальный знак ;. Расширения из примера пригодятся для работы с многобайтовыми строками, HTTP и MySQL.
; Папка ext из того же архива PHP
extension_dir = "C:\tools\php\ext"
extension=mbstring
extension=curl
extension=pdo_mysqlПроверьте список загруженных модулей через php -m. Если php не распознаётся, а запуск по полному пути работает, проверьте Path и откройте новый терминал. Если запускается PHP из XAMPP или другой установки, измените порядок каталогов в Path либо вызывайте нужный php.exe по полному пути. При ошибке загрузки DLL проверьте путь extension_dir, наличие файла и совпадение версии, разрядности и типа сборки TS/NTS.
Установка PHP на Linux через пакетный менеджер
Версия пакета зависит от выпуска дистрибутива и подключённых репозиториев. Команды с именем php устанавливают версию, которую предлагает пакетный менеджер. Если нужна конкретная ветка, проверьте доступные пакеты до установки. Пакеты интерпретатора, FPM и расширений выбирайте для одной ветки.
Ubuntu и Debian
# Обновите список пакетов и посмотрите доступную версию
sudo apt update
apt-cache policy php-cli
# Установите CLI и расширения для MySQL, XML и обработки строк
sudo apt install php-cli php-mbstring php-xml php-curl php-mysql
php -v
php --iniЕсли в репозитории доступна ветка 8.4 и проект требует именно её, можно установить php8.4-cli и соответствующие пакеты расширений, например php8.4-mbstring. При нескольких версиях проверьте, куда ведёт команда php. Для скриптов и CI можно вызывать нужный бинарный файл напрямую, например php8.4, если он установлен.
Fedora
# Посмотрите доступную версию и установите CLI с расширениями
sudo dnf info php-cli
sudo dnf install php-cli php-mbstring php-xml php-mysqlnd
php -v
php -mЕсли пакетный менеджер не находит нужную ветку, проверьте версию самой ОС и доступность пакетов в репозиториях вашего дистрибутива. Для воспроизводимой разработки с конкретной веткой можно использовать официальный контейнерный образ PHP. Если проекту нужен только терминал, пакета CLI достаточно.
Как установить PHP на macOS через Homebrew
В примере/Homebrew используется формула php@8.5. Если проект работает на 8.4 или 8.3, подставьте соответствующую формулу в обе команды и предварительно проверьте её доступность через brew info.
# Установите PHP 8.5 и выберите его в текущем терминале
brew install php@8.5
export PATH="$(brew --prefix php@8.5)/bin:$PATH"
php -v
php --iniЧтобы выбранная версия находилась и в новых окнах Terminal, добавьте строку export PATH=… из примера целиком в ~/.zshrc, если используете Zsh. В другом шелле измените его файл настроек. Если версия не совпадает с ожидаемой, выполните type -a php. Команда покажет, в каком порядке оболочка находит установки PHP. brew --prefix php@8.5 получает путь из Homebrew, поэтому пример подходит и для Apple Silicon, и для Intel.
Как проверить PHP в терминале и браузере
Создайте в каталоге проекта файл public/index.php. Скрипт выводит версию интерпретатора и интерфейс, через который он запущен. Директива declare(strict_types=1) стоит первой после открывающего тега и задаёт строгий режим передачи скалярных аргументов при вызовах из этого файла.
<?php
declare(strict_types=1);
function statusLine(string $version, string $sapi): string
{
return "PHP {$version} ({$sapi})" . PHP_EOL;
}
// При запуске через HTTP отправляем обычный текст.
if (PHP_SAPI !== 'cli') {
header('Content-Type: text/plain; charset=UTF-8');
}
echo statusLine(PHP_VERSION, PHP_SAPI);Из каталога проекта сначала запустите файл напрямую, затем запустите встроенный сервер. Команды подходят для Bash, Zsh и PowerShell.
# Проверьте выполнение файла через CLI
php public/index.php
# Запустите локальный сервер с корнем в каталоге public
php -S 127.0.0.1:8000 -t publicОткройте в браузере локальный адрес на порту 8000, который показал терминал. При прямом запуске скрипт выведет cli, при запросе через встроенный сервер — cli-server. Если порт занят, замените 8000 на 8001. Остановить сервер можно через Ctrl+C. Используйте его для разработки на локальном компьютере.
Как подключить PHP к веб-серверу
На Linux Nginx передаёт запросы к PHP через FastCGI в PHP-FPM. Установите пакет php-fpm или пакет нужной ветки, например php8.4-fpm в Debian или Ubuntu, если он доступен. Проверьте, что служба запущена, и возьмите адрес сокета из параметра listen в конфигурации пула FPM. В примере ниже показан фрагмент существующего блока server с Nginx и PHP-FPM одной машины.
root /var/www/project/public;
index index.php;
location ~ \.php$ {
# Передаём в FPM только существующие файлы.
try_files $uri =404;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass unix:/run/php/php8.4-fpm.sock;
}Подставьте свой путь к каталогу public и адрес из listen. Проверьте конфигурацию через sudo nginx -t и при успехе перечитайте её командой sudo systemctl reload nginx на системе с systemd. В Apache тоже можно подключить FPM через proxy_fcgi. В IIS обработчик FastCGI должен указывать на php-cgi.exe выбранной установки.
Если Nginx отвечает 502 Bad Gateway, проверьте журнал ошибок Nginx, состояние FPM, адрес сокета и права подключения к нему. Если браузер показывает или скачивает исходный PHP-файл, закройте к нему публичный доступ и настройте обработчик PHP до повторной проверки.
Практический чек-лист после установки
- Выполните
php -vи сверяйте ветку с требованиями проекта. Если версия отличается от ожидаемой, найдите все установки черезwhere.exe phpна Windows илиtype -a phpв Bash и Zsh. - Выполните
php --iniи редактируйте файл из строкиLoaded Configuration File. PHP для терминала, Apache и FPM может читать разные файлы. Если проблема есть только в браузере, временно выведитеphp_ini_loaded_file()в локальном скрипте и удалите этот вывод после проверки. - Выполните
php -mи сверяйте список с требованиями проекта. Приcould not find driverпроверьте драйвер нужной базы, напримерpdo_mysqlдля MySQL. После изменения настроек перезапустите встроенный сервер, службу FPM или Apache с модулем PHP. Для CLI достаточно снова запустить скрипт. - При переносе старого проекта на 8.x обновите вызовы, которые встречались в PHP 5. Вместо
mysql_*используйте PDO или MySQLi с подготовленными запросами, вместоereg()—preg_match()с адаптированным шаблоном, вместоcreate_function()— замыкание. - Запустите один и тот же тестовый файл из терминала и через настроенный веб-сервер. Затем проверьте реальный сценарий проекта, для которого нужны расширения, например подключение к базе данных.
Частые вопросы
Где скачать PHP для Windows и какую сборку выбрать?
Скачайте ZIP с готовыми бинарными файлами в официальном разделе PHP for Windows. Для 64-битной Windows на Intel или AMD подойдёт x64. Для терминала и IIS через FastCGI выбирайте NTS, для PHP в качестве модуля Apache — TS.
Можно ли установить несколько версий PHP одновременно?
Да. На Windows распакуйте версии в разные каталоги. На Linux и macOS можно поставить отдельные пакеты или формулы, если они доступны. Для терминала задайте нужный путь или вызывайте бинарный файл напрямую. Для сайта выберите обработчик или сокет FPM нужной версии.
Почему PHP работает в терминале, но в браузере не видит расширение?
Обработчик веб-сервера может использовать другой интерпретатор или файл настроек. Сравните вывод php --ini с результатом php_ini_loaded_file() в локальном веб-скрипте. Включите расширение в конфигурации веб-обработчика, перезапустите нужную службу и повторите проверку.