Как запустить PHP-файл: встроенный сервер, CLI и локальное окружение
Чтобы запустить PHP-файл, нужен интерпретатор PHP. Для скриптов и разовых задач достаточно терминала, а для работы со страницами, формами и сессиями понадобится PHP-сервер. Оба способа можно попробовать на одном файле.
Как открыть PHP-файл и чем его редактировать
Файл .php — обычный текстовый файл. Чтобы прочитать или изменить исходный код, откройте его в редакторе, например в VS Code, PhpStorm или системном текстовом редакторе. Подсветка синтаксиса помогает при редактировании, а за выполнение отвечает установленный интерпретатор.
Если открыть PHP-файл двойным щелчком, результат зависит от настроек системы: может запуститься редактор или браузер. Браузер сам PHP не выполняет. При запросе к локальному серверу PHP выполняется на стороне сервера, а браузер получает результат, например HTML, JSON или обычный текст.
Как создать PHP-файл и проверить установку PHP
Создайте папку проекта и сохраните в ней файл hello.php в кодировке UTF-8 без BOM. В Windows проверьте, что редактор сохранил его с расширением .php: при скрытых расширениях легко пропустить окончание .txt.
<?php
declare(strict_types=1);
function greet(string $name): string
{
return "Привет, {$name}!";
}
// Перевод строки будет виден в терминале.
echo greet('PHP') . PHP_EOL;В файле, который целиком состоит из PHP, закрывающий тег ?> обычно опускают. Так случайный пробел или пустая строка в конце файла не попадут в HTTP-ответ. declare(strict_types=1) ставят в начале файла. Для скалярных аргументов режим определяется файлом, из которого вызвана функция. Например, вызов greet(123) из этого файла вызовет TypeError.
Откройте терминал в папке проекта и проверьте версию интерпретатора и синтаксис файла:
php -v
php -l hello.phpКоманда php -l проверяет синтаксис без выполнения файла. Она пропустит, например, вызов отсутствующей функции, который завершится ошибкой при запуске. Если команда php недоступна, установите PHP с поддержкой CLI или добавьте папку с исполняемым файлом в PATH. После изменения PATH откройте новый терминал. В PowerShell путь к выбранному интерпретатору покажет Get-Command php, в Bash — command -v php.
Как запустить PHP из терминала через PHP CLI
CLI — режим командной строки. Он подходит для импорта данных, обработки файлов, плановых заданий и команд фреймворка. Чтобы выполнить пример, запустите:
php hello.phpВ терминале появится Привет, PHP!. Передавайте PHP путь к файлу относительно текущей папки или абсолютный путь. Если в пути есть пробелы, заключите его в кавычки. Для путей к соседним файлам внутри самого скрипта удобно использовать __DIR__: это папка файла, поэтому такой путь не зависит от того, откуда вызвали команду.
Как передать аргумент и вернуть код завершения
В отдельном файле greet.php можно прочитать аргумент из $argv. Элемент $argv[0] содержит имя скрипта, а $argv[1] — первый переданный аргумент.
<?php
declare(strict_types=1);
$name = trim($argv[1] ?? '');
if ($name === '') {
// Ошибки идут в отдельный поток.
fwrite(STDERR, 'Укажите имя.' . PHP_EOL);
exit(1);
}
echo "Привет, {$name}!" . PHP_EOL;php greet.php "Анна Иванова"Если имя передано, скрипт печатает приветствие и завершается с кодом 0. Без имени он пишет сообщение в STDERR и возвращает код 1. Планировщик или вызывающий скрипт может по этому коду определить, выполнена ли задача. HTTP-заголовки, cookies и параметры запроса в таком запуске отсутствуют: входные данные передают через аргументы, стандартный ввод, файлы или переменные окружения.
Как открыть PHP на localhost через встроенный сервер
Перейдите в папку с hello.php и запустите встроенный PHP-сервер:
php -S localhost:8000Оставьте терминал открытым. В браузере откройте localhost:8000/hello.php. Сервер выполнит файл и передаст результат браузеру. localhost указывает на ваш компьютер, а 8000 — порт, на котором PHP принимает запросы. В терминале видны обращения к серверу и сообщения об ошибках. Чтобы остановить сервер, нажмите Ctrl+C.
По умолчанию сервер ищет файлы относительно папки, из которой его запустили. Если в ней есть только hello.php, укажите имя файла в адресной строке. Для входа по одному адресу с портом положите в корень index.php. Если порт занят, выберите другой, например 8001, и укажите его в браузере.
Как задать корень сайта и принять GET-параметр
Если у проекта есть каталог public, сделайте его корнем сайта. Тогда файлы конфигурации, исходники приложения и зависимости за пределами public не будут доступны как статические файлы. Из папки проекта выполните:
php -S localhost:8000 -t publicСоздайте public/index.php. Пример читает параметр name, обрабатывает пустое значение и экранирует текст перед выводом в HTML:
<?php
declare(strict_types=1);
$input = $_GET['name'] ?? '';
// Запрос может передать массив вместо строки.
$name = is_string($input) ? trim($input) : '';
$name = $name !== '' ? $name : 'гость';
header('Content-Type: text/html; charset=UTF-8');
echo '<p>Привет, ', htmlspecialchars($name, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), '!</p>';Добавьте к пути / строку запроса ?name=Анна. В браузере появится приветствие с указанным именем. Проверка типа учитывает запись параметра в виде массива, а htmlspecialchars позволяет вывести символы вроде < как текст. Встроенный сервер рассчитан на локальную разработку. Для рабочего окружения используйте полноценный HTTP-сервер.
Когда нужен локальный PHP-сервер с Apache или Nginx
Встроенного сервера обычно хватает для отдельного файла и небольшого проекта. Если приложение зависит от правил .htaccess, настройки виртуальных хостов или конфигурации PHP-FPM, разверните окружение с тем же способом обработки запросов, что и на рабочем сервере.
| Способ запуска | Что выполняет PHP | Когда подходит |
|---|---|---|
| PHP CLI | Интерпретатор, запущенный из терминала | Скрипты, импорт, плановые задания |
| Встроенный сервер | Процесс, запущенный командой php -S | Локальная работа со страницами, формами и HTTP-запросами |
| Apache или Nginx | Модуль Apache или отдельный обработчик, например PHP-FPM | Маршрутизация, виртуальные хосты и настройки, близкие к рабочему окружению |
В локальной сборке с Apache запустите HTTP-сервер и разместите файл в каталоге, заданном директивой DocumentRoot. Для проекта с каталогом public укажите его в настройках виртуального хоста. В связке Nginx и PHP-FPM задайте корень сайта в Nginx и настройте передачу PHP-запросов через FastCGI на сокет или порт PHP-FPM. Браузер обращается к порту HTTP-сервера, а FastCGI работает внутри этой связки.
Во фреймворке public/index.php часто служит единой точкой входа. Если главная страница работает, а маршрут вроде /contacts возвращает 404, проверьте правило, которое передаёт запросы к виртуальным маршрутам в index.php. Для встроенного сервера используйте команду запуска или файл маршрутизации, предусмотренные проектом: директивы .htaccess он не применяет.
Что меняется при запуске на PHP 8.3, 8.4 и 8.5
На конец 2026 года для локального окружения можно использовать поддерживаемые ветки PHP 8.3, 8.4 и 8.5. Команды php файл.php, php -l и php -S работают во всех трёх. Для существующего проекта ориентируйтесь на ограничения в composer.json, зависимости и версию PHP в рабочем окружении. Если проект поддерживает несколько веток, запускайте тесты как минимум на самой старой заявленной версии.
- PHP 8.3. Поддерживает типизированные константы классов. Например,
public const string NAME = 'demo';можно использовать во всех трёх ветках. - PHP 8.4. Появились хуки свойств. Код с ними требует PHP 8.4 или новее. В этой же ветке объявление параметра в виде
string $name = nullстало устаревшим. Если параметр принимаетnull, укажите это явно:?string $name = null. - PHP 8.5. Добавлен оператор конвейера
|>. Если скрипт должен работать на PHP 8.3 или 8.4, используйте обычные вызовы функций или промежуточные переменные.
При переносе старых скриптов учитывайте, что в прежних версиях PHP встречались mysql_*, ereg и create_function. В PHP 8.x этим вызовам нужны замены: PDO или MySQLi с подготовленными запросами, preg_match с шаблоном PCRE и анонимная функция или стрелочная функция fn соответственно.
Типичные ошибки при запуске PHP-файла
- Терминал не находит
php. Проверьте установку интерпретатора иPATH. Если локальная сборка уже содержит PHP, можно вызвать его по полному пути и сверить версию командойphp -v. Could not open input file. Проверьте текущую папку, имя и расширение файла. Используйте абсолютный путь, чтобы исключить ошибку с рабочим каталогом.- Браузер показывает исходник или скачивает PHP-файл. Проверьте, что вы открыли адрес сервера. Если запрос уже идёт через Apache или Nginx, проверьте настройку обработчика PHP. Если сервер отдаёт исходники посетителям, ограничьте доступ к сайту до исправления конфигурации.
- Страница возвращает 404 или браузер сообщает, что соединение отклонено. При 404 сверьте путь относительно корня сайта и правила маршрутизации. При отказе в соединении проверьте, что сервер ещё запущен и слушает указанный порт.
- Страница пустая или возвращает 500. Начните с журнала сервера и
php -l. Для локальной отладки можно запустить сервер командойphp -d display_errors=1 -d error_reporting=-1 -S localhost:8000 -t public. В рабочем окружении записывайте ошибки в журнал. - В CLI работает, в браузере падает. Сравните версии PHP и загруженные расширения. CLI показывает файл конфигурации по команде
php --ini, а расширения — поphp -m. Веб-обработчик может читать другойphp.ini. Его конфигурацию можно проверить локально черезphp_ini_loaded_file(), а наличие нужного расширения — черезextension_loaded(). Headers already sent. Вызывайтеheader()иsession_start()до вывода. Проверьте, нет ли BOM, пробелов перед открывающим тегом или отладочногоechoв подключаемом файле.
Чек-лист перед первым запуском
- Сохраните файл с расширением
.phpв UTF-8 без BOM и начните его с<?php. - Выполните
php -vи убедитесь, что выбрана версия, совместимая с проектом. Проверьте синтаксис командойphp -l hello.php. - Для консольной задачи выполните
php hello.php. Для страницы запуститеphp -S localhost:8000и откройтеlocalhost:8000/hello.phpв браузере. - Для проекта с каталогом
publicнаправьте корень сайта в этот каталог. Проверьте обращение к главной странице и к одному маршруту приложения. - Если результат отличается от ожидаемого, прочитайте первое сообщение об ошибке в терминале или журнале. По нему проще определить, где искать причину: в пути к файлу, настройке сервера или PHP-коде.
Частые вопросы
Чем открыть PHP-файл, чтобы увидеть код?
Откройте файл в текстовом редакторе или IDE. Чтобы увидеть результат выполнения, запустите его через PHP CLI или откройте страницу через локальный PHP-сервер.
Можно ли запустить PHP-файл без Apache и Nginx?
Да. Для консольного запуска используйте php hello.php. Для работы в браузере запустите встроенный сервер командой php -S localhost:8000 и откройте нужный файл через него.
Почему команда php работает, а PHP-страница на localhost выдаёт ошибку?
CLI и веб-сервер могут использовать разные версии PHP, файлы конфигурации и расширения. Начните с журнала веб-сервера и сравните его окружение с выводом php -v, php --ini и php -m в терминале.