Установка, запуск и встроенный сервер
PHP - это язык, который живёт почти везде: на хостингах, в старых проектах и в сердцах тех, кто однажды писал echo "Привет";.
Сегодня твоя задача - запустить PHP локально и убедиться, что он вообще работает. Спойлер: работает.
Варианты установки
Выбери свою ОС:
brew install php
php -v
# brew ставит самую свежую ветку; нужна именно 8.3 - так:
# brew install php@8.3 && brew link --force --overwrite php@8.3
sudo apt update
sudo apt install -y php-cli
php -v
# версия зависит от дистрибутива (Ubuntu 24.04 - 8.3);
# на более старых используй PPA ondrej/php или Docker (см. ниже)
Самый простой путь для новичка:
- XAMPP или Laragon - готовый сборник PHP + Apache + MySQL.
- Либо WSL2 + Ubuntu (если хочешь «как на сервере»; тогда дальше используй вкладку Linux).
После установки проверь:
php -v
ℹ️ CLI vs Apache/Nginx
Для первых уроков тебе достаточно php-cli и встроенного сервера. Apache/Nginx пригодятся позже - когда будешь деплоить и настраивать домены.
Разница в том, как живёт процесс:
php script.php(CLI) запускает скрипт, тот отрабатывает, и процесс завершается. На сервере же работает PHP-FPM - сервис, который держит пул заранее запущенных процессов PHP и отдаёт их Nginx под каждый HTTP-запрос. Подробно - в уроке 24 про PHP-FPM.
Какую версию выбрать
PHP активно развивается, и ветки уходят с поддержки по расписанию. Устойчивое правило: бери версию, у которой ещё идёт поддержка исправлений безопасности, и не самую свежую - часть расширений и фреймворков подтягивается позже. Актуальный список ветвей с датами - на php.net/supported-versions.
| Версия | Что нового (для нас) |
|---|---|
| 8.1 | enum, readonly свойства, never тип, fibers |
| 8.2 | readonly классы, DNF-типы (A&B|C), новые random-функции |
| 8.3 | Типизированные константы классов, json_validate(), #[Override] |
| 8.4 | Property hooks, асимметричная видимость (public private(set)), array_find() |
| 8.5 | Pipe-оператор |>, clone с изменением свойств, #[\NoDiscard] |
Примеры курса написаны и проверены на PHP 8.3 - её и ставь для учёбы. Для новых боевых проектов бери ветку с активной поддержкой (на конец 2026 года - 8.4 и 8.5). Если работаешь со старым кодом - посмотри в composer.json ("require": { "php": "^8.1" }), какая минимально нужна.
composer.json - файл Composer, менеджера зависимостей PHP: в нём проект
перечисляет нужные библиотеки и подходящую версию PHP. Ставить Composer пока
не нужно, он понадобится в уроке про тесты и подробно разобран в
уроке 18 про namespaces и Composer.
Первый скрипт
Создай файл hello.php:
<?php
echo 'Привет, BackendStart!';
Запусти:
php hello.php
Если выводится строка - установка прошла нормально. Если PHP «не найден» - путь к нему не попал в PATH, переустанови через пакетный менеджер.
Проверить синтаксис файла, не выполняя его, можно флагом -l (lint):
php -l hello.php
# No syntax errors detected in hello.php
При ошибке PHP напишет Parse error с номером строки.
Встроенный сервер
PHP умеет поднимать простой сервер (для обучения - топ):
php -S localhost:8000 -t public
Где:
-S- адрес и порт-t public- папка, из которой раздаём файлы
Сделай public/index.php:
<?php
phpinfo();
Открой в браузере: http://localhost:8000. phpinfo() выводит подробную
страницу о твоём PHP: версию, включённые расширения, пути к php.ini
и переменные окружения. Удобно для проверки настроек, но наружу такую
страницу не выкладывают - она раскрывает устройство сервера.
⚠️ Не запускай встроенный сервер в проде
Он создан для разработки и обучения. На боевом сервере используй Nginx/Apache + PHP-FPM.
Где живёт php.ini
Конфигурация PHP - это файл php.ini. Узнать его расположение:
php --ini
Вывод покажет основной файл и список подгружаемых из conf.d/. Самые полезные настройки для начала:
; локально - показать все ошибки
display_errors = On
error_reporting = E_ALL
; обычно достаточно
memory_limit = 256M
; лимит времени веб-запроса в секундах (0 = без лимита);
; в CLI всегда 0 - эта строка из php.ini там не действует
max_execution_time = 30
В проде display_errors обязательно Off - пользователь не должен видеть стектрейсы (подробно - в уроке про безопасность).
Расширения PHP
Большая часть стандартной библиотеки - это расширения (mbstring, pdo_mysql, curl, gd, ...). Что включено сейчас:
php -m
Если нужного нет - поставь системным пакетом. В Debian/Ubuntu пакет сам включает расширение (кладёт файл в conf.d/) - просто проверь php -m:
sudo apt install php-mbstring php-pdo-mysql
Строка extension=имя в php.ini нужна только при ручной установке (например, в Windows-сборках). Если расширение уже включено через conf.d/, повторная строка даст предупреждение Module "mbstring" is already loaded:
; в php.ini - только если расширение не включилось само
extension=mbstring
extension=pdo_mysql
После правки php.ini перезапусти CLI/FPM, иначе изменения не применятся.
OPcache - короткое intro
OPcache кеширует скомпилированный байт-код в памяти. Без него каждый запрос заново парсит и компилирует PHP-файлы. С ним - приложение работает в 2-3 раза быстрее.
Минимальная активация в php.ini:
[opcache]
opcache.enable = 1
opcache.memory_consumption = 128
opcache.max_accelerated_files = 10000
opcache.validate_timestamps = 1 ; локально 1, на проде 0
Про validate_timestamps на проде - в уроке 24 про PHP-FPM.
Проверить, что включён: php -i | grep opcache.enable.
Запуск через Docker
Если не хочешь ставить PHP в систему - используй официальные образы:
# одноразовый запуск
docker run --rm -v "$PWD":/app -w /app php:8.3-cli php hello.php
# встроенный сервер
docker run --rm -p 8000:8000 -v "$PWD":/app -w /app php:8.3-cli \
php -S 0.0.0.0:8000 -t public
В реальных проектах PHP в Docker всегда идёт связкой php:8.3-fpm + nginx - это разберём в уроке про PHP-FPM.
Типичные ошибки
command not found: php- PHP не вPATH. Перезапусти терминал; если не помогло - переустанови черезbrew/apt.Could not open input file- путь к файлу указан неверно. Проверь, что ты в нужной директории (pwd).- Адрес
localhost:8000уже занят. Что-то другое слушает порт - смени на 8001 или останови предыдущий процесс (lsof -i :8000). - Изменил
php.ini- ничего не поменялось. Файлphp.iniдля CLI и для FPM/Apache - это разные файлы. Проверь черезphp --ini, какой именно используется. - Расширение не включается после
extension=.... Возможно, не установлен системный пакет (php-mbstring) -extension=- это только активация, не установка.
Best practices
- На локальной машине держи ту же minor-ветку (например, 8.3), что и в проде, - иначе ловишь несовместимости при деплое.
- Версию PHP проекта фиксируй в
composer.json("require": { "php": "^8.3" }) - Composer не даст поставить зависимости на несовместимом PHP. - Для CLI-команд используй
php script.php, для веба - встроенный сервер локально, FPM+Nginx на проде. Не путай контексты. - В IDE поставь плагин/настройку для подсветки PHP-версии (PhpStorm - встроено, VS Code - PHP Intelephense).
- Composer - обязательный спутник: про него подробно в уроке 18 про namespaces.
Мини-задание
- Установи PHP 8.3 и убедись, что
php -vпоказывает ветку 8.3. - Запусти
hello.phpиз CLI. - Подними встроенный сервер, открой
phpinfo()в браузере, найди в нём разделopcache- включён ли он. - Через
php --iniнайди путь к своемуphp.ini, открой его и посмотри значениеmemory_limit.