Запуск PHP файлов: интерпретатор и встроенные функции

Раздел: Управление файлами в PHP -> Парсинг и выполнение

Запуск PHP файлов: обзор методов

Основной способ: выполнение через интерпретатор командной строки

Как запустить PHP скрипт из терминала?

Запуск PHP файла через командную строку является самым прямым и эффективным методом. Для этого используется команда php с указанием пути к файлу. Пример:

php script.php

Parse php file (парсинг php файла)

Перед запуском необходимо убедиться, что PHP установлен и его исполняемый файл находится в переменной окружения PATH. В противном случае указывается полный путь, например /usr/bin/php script.php.

Цель использования:

выполнение автономных PHP сценариев, консольных утилит, заданий cron, тестирование кода.

Типичные проблемы и их решение:

Ошибка 'php: command not found' - PHP не добавлен в PATH. Решение: следует установить PHP или указать полный путь.
Синтаксические ошибки - скрипт содержит ошибки. Можно включить вывод ошибок: php -d display_errors=1 script.php.
Файл не найден - неверный путь. Рекомендуется использовать абсолютные пути или проверить текущую директорию.

Выполнение файла из другого PHP скрипта: include и require

Как подключить и выполнить другой PHP файл внутри текущего сценария?

Конструкции include и require позволяют вставить содержимое указанного файла и выполнить его как часть основного скрипта. Отличие в реакции на отсутствие файла: include генерирует предупреждение, а require - фатальную ошибку. Также существуют include_once и require_once, предотвращающие повторное включение.

Пример:

require_once 'config.php';
include 'functions.php';

Php run file (запуск файла php)

Цель:

модульное программирование, разделение логики, подключение конфигураций или библиотек.

Проблемы и их решение:

Фатальная ошибка при отсутствии файла в require - рекомендуется проверять file_exists() или переходить на include с обработкой ошибок.
Конфликты имен при повторном включении - следует применять include_once/require_once.
Проблемы с относительными путями - лучше использовать абсолютные пути через __DIR__.

Запуск внешнего PHP процесса через системные вызовы

Как выполнить отдельный PHP скрипт как новый процесс и получить его вывод?

Функции exec(), system(), shell_exec() и passthru() позволяют запускать внешние команды, в том числе PHP интерпретатор с нужным файлом. Это полезно для параллельного выполнения, обработки файлов или интеграции с другими утилитами.

Пример получения вывода:

$output = shell_exec('php worker.php --option=value 2>&1');
echo $output;

Цель: выполнение длительных или независимых задач, например, генерация отчётов, рассылка писем.

Проблемы и их решение:

Пустой вывод, если скрипт не выводит данные - проверьте, что скрипт выводит текст, или используйте exec с захватом кода возврата.
Уязвимость к внедрению команд - необходимо экранировать аргументы с помощью escapeshellarg().
Блокировка выполнения основного процесса - для асинхронного запуска можно использовать & в конце команды Linux или proc_open.

Динамическое выполнение кода через eval

Как выполнить PHP код, хранящийся в строке или прочитанный из файла?

Функция eval() принимает строку с PHP кодом и выполняет её. Это может быть использовано для шаблонов, подключаемых модулей или сохранённых сценариев. Однако из-за высокого риска безопасности eval рекомендуется применять только с доверенными данными.

Пример с чтением кода из файла:

$code = file_get_contents('template.php');
eval('?>' . $code . '<?');

Цель: гибкое выполнение динамически сгенерированного или пользовательского кода (например, в CMS или системах плагинов).

Проблемы и их решение:

Ошибки парсинга при eval - код должен быть синтаксически верным. Можно проверить через php -l.
Безопасность - eval выполняет любой код, поэтому его не следует применять с непроверенными входными данными. Альтернатива: временный файл и include.
Проблемы с областью видимости - переменные, объявленные в eval, будут в глобальной области, если не указано иное. Учитывайте это.

Расширенные примеры запуска PHP файлов

Пример 1: Запуск скрипта с аргументами и опциями командной строки

В этом примере скрипт обрабатывает аргументы ($argv) и опции (getopt). Скрипт args.php:

Пример

<?php
echo "Аргументы командной строки:\n";
print_r($argv);
$options = getopt("n:", ["name:"]);
print_r($options);
?>

Команда запуска:

Пример

php args.php --name=World -n Hello arg1 arg2

Результат выполнения:

Аргументы командной строки:
Array
(
    [0] => args.php
    [1] => --name=World
    [2] => -n
    [3] => Hello
    [4] => arg1
    [5] => arg2
)
Array
(
    [n] => Hello
    [name] => World
)

Пояснение:

массив $argv содержит все переданные аргументы, включая имя скрипта. Функция getopt() анализирует длинные и короткие опции. Этот метод удобен для создания консольных утилит.

Пример 2: Запуск внешнего PHP процесса с управлением вводом/выводом через proc_open

Функция proc_open даёт полный контроль над потоками stdin, stdout, stderr запущенного процесса. Это полезно для интерактивного взаимодействия или передачи больших объёмов данных.

Код вызывающего скрипта (runner.php):

Пример

<?php
$descriptorspec = [
    0 => ["pipe", "r"],  // stdin
    1 => ["pipe", "w"],  // stdout
    2 => ["pipe", "w"]   // stderr
];
$process = proc_open('php worker.php', $descriptorspec, $pipes);
if (is_resource($process)) {
    fwrite($pipes[0], "Привет, мир!\n");
    fclose($pipes[0]);
    echo "Вывод дочернего процесса:\n" . stream_get_contents($pipes[1]);
    fclose($pipes[1]);
    $error = stream_get_contents($pipes[2]);
    if ($error) echo "Ошибки:\n$error";
    fclose($pipes[2]);
    proc_close($process);
}
?>

Скрипт worker.php:

Пример

<?php
echo "Введите данные: ";
$input = trim(fgets(STDIN));
echo "Получено: $input\n";
?>

Результат запуска runner.php:

Вывод дочернего процесса:
Введите данные: Получено: Привет, мир!

Пояснение:

обратите внимание, что вывод worker.php содержит приглашение 'Введите данные:' перед получением ввода, но в выводе оно появляется после записи в stdin. Это особенность работы с буферами. Для синхронизации можно использовать сетевые сокеты или обмен сообщениями.

Пример 3: Использование include с буферизацией вывода для выполнения файла как шаблона

Шаблонизаторы часто используют буферизацию для захвата вывода включаемого файла. Это позволяет отделить логику от представления.

Файл template.php:

Пример

<?php
// переменная $name должна быть определена до include
?>
<h1>Привет, <?php echo $name; ?>!</h1>

Вызов из основного скрипта:

Пример

<?php
$name = 'Андрей';
ob_start();
include 'template.php';
$html = ob_get_clean();
echo $html;
?>

Результат:

<h1>Привет, Андрей!</h1>

Пояснение:

ob_start() включает буферизацию вывода, include выполняет файл, а ob_get_clean() возвращает содержимое буфера и отключает буферизацию. Переменные, объявленные до include, доступны внутри подключаемого файла. Это безопасный способ динамического формирования HTML.

Запуск файла PHP - comments

Php run file (php)