PHPTime

Как запустить 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
<?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.

Откройте терминал в папке проекта и проверьте версию интерпретатора и синтаксис файла:

Shell
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 — режим командной строки. Он подходит для импорта данных, обработки файлов, плановых заданий и команд фреймворка. Чтобы выполнить пример, запустите:

Shell
php hello.php

В терминале появится Привет, PHP!. Передавайте PHP путь к файлу относительно текущей папки или абсолютный путь. Если в пути есть пробелы, заключите его в кавычки. Для путей к соседним файлам внутри самого скрипта удобно использовать __DIR__: это папка файла, поэтому такой путь не зависит от того, откуда вызвали команду.

Как передать аргумент и вернуть код завершения

В отдельном файле greet.php можно прочитать аргумент из $argv. Элемент $argv[0] содержит имя скрипта, а $argv[1] — первый переданный аргумент.

PHP
<?php
declare(strict_types=1);

$name = trim($argv[1] ?? '');

if ($name === '') {
    // Ошибки идут в отдельный поток.
    fwrite(STDERR, 'Укажите имя.' . PHP_EOL);
    exit(1);
}

echo "Привет, {$name}!" . PHP_EOL;
Shell
php greet.php "Анна Иванова"

Если имя передано, скрипт печатает приветствие и завершается с кодом 0. Без имени он пишет сообщение в STDERR и возвращает код 1. Планировщик или вызывающий скрипт может по этому коду определить, выполнена ли задача. HTTP-заголовки, cookies и параметры запроса в таком запуске отсутствуют: входные данные передают через аргументы, стандартный ввод, файлы или переменные окружения.

Как открыть PHP на localhost через встроенный сервер

Перейдите в папку с hello.php и запустите встроенный PHP-сервер:

Shell
php -S localhost:8000

Оставьте терминал открытым. В браузере откройте localhost:8000/hello.php. Сервер выполнит файл и передаст результат браузеру. localhost указывает на ваш компьютер, а 8000 — порт, на котором PHP принимает запросы. В терминале видны обращения к серверу и сообщения об ошибках. Чтобы остановить сервер, нажмите Ctrl+C.

По умолчанию сервер ищет файлы относительно папки, из которой его запустили. Если в ней есть только hello.php, укажите имя файла в адресной строке. Для входа по одному адресу с портом положите в корень index.php. Если порт занят, выберите другой, например 8001, и укажите его в браузере.

Как задать корень сайта и принять GET-параметр

Если у проекта есть каталог public, сделайте его корнем сайта. Тогда файлы конфигурации, исходники приложения и зависимости за пределами public не будут доступны как статические файлы. Из папки проекта выполните:

Shell
php -S localhost:8000 -t public

Создайте public/index.php. Пример читает параметр name, обрабатывает пустое значение и экранирует текст перед выводом в HTML:

PHP
<?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 в подключаемом файле.

Чек-лист перед первым запуском

  1. Сохраните файл с расширением .php в UTF-8 без BOM и начните его с <?php.
  2. Выполните php -v и убедитесь, что выбрана версия, совместимая с проектом. Проверьте синтаксис командой php -l hello.php.
  3. Для консольной задачи выполните php hello.php. Для страницы запустите php -S localhost:8000 и откройте localhost:8000/hello.php в браузере.
  4. Для проекта с каталогом public направьте корень сайта в этот каталог. Проверьте обращение к главной странице и к одному маршруту приложения.
  5. Если результат отличается от ожидаемого, прочитайте первое сообщение об ошибке в терминале или журнале. По нему проще определить, где искать причину: в пути к файлу, настройке сервера или 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 в терминале.

Справка по теме

Ещё в разделе «Справочник PHP»

Как узнать и обновить версию PHP: phpinfo, CLI и хостинг

Как узнать версию PHP через phpinfo(), CLI и панель хостинга, выбрать ветку PHP 8.3–8.5 и обновить сайт с проверкой расширений и совместимости.

8 мин

Как установить PHP на Windows, Linux и macOS

Как скачать и установить PHP 8.3–8.5 на Windows, Linux и macOS, настроить PATH и php.ini, подключить расширения и проверить работу PHP в терминале и браузере.

8 мин

Классы и ООП в PHP 8: свойства, конструктор, наследование

Как объявлять классы в PHP 8.3–8.5, типизировать свойства, писать конструкторы и наследовать классы. Примеры с self, static, parent и readonly.

9 мин

Константы в PHP: define, const и константы классов

Как объявлять константы в PHP через define и const, работать с константами классов, проверять их наличие и учитывать отличия PHP 8.3, 8.4 и 8.5.

7 мин