Выполнение внешних процессов из PHP: функции, примеры и рекомендации

Расширенные примеры выполнения внешних команд

Экранирование аргументов с escapeshellarg

При подстановке пользовательских данных в команду обязательно экранировать каждый аргумент, чтобы предотвратить внедрение кода.

<?php
$filename = $_GET['file'] ?? 'test.txt';
$safeFilename = escapeshellarg($filename);
$command = "wc -l $safeFilename";
$output = shell_exec($command);
echo "Количество строк: $output";
?>

Результат (если передан file=test.txt):

Количество строк: 10 test.txt

Если бы экранирование отсутствовало, злоумышленник мог бы передать test.txt; rm -rf /.

Выполнение команды с таймаутом через proc_open

Некоторые команды могут зависнуть. Реализация таймаута с помощью proc_get_status и usleep:

<?php
$descriptorspec = [0 => ['pipe', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']];
$process = proc_open('sleep 10', $descriptorspec, $pipes);
$timeout = 5; // секунд
$start = time();
while (true) {
    $status = proc_get_status($process);
    if (!$status['running']) break;
    if (time() - $start > $timeout) {
        // принудительно завершить
        proc_terminate($process, 9);
        echo "Команда прервана по таймауту";
        break;
    }
    usleep(100000); // 100 ms
}
fclose($pipes[0]); fclose($pipes[1]); fclose($pipes[2]);
proc_close($process);
?>

Результат: через 5 секунд появится сообщение о прерывании, процесс будет убит.

Запуск фоновой команды (без ожидания завершения)

Чтобы выполнить команду в фоне, можно перенаправить вывод и использовать exec с амперсандом в конце команды:

<?php
// Запуск в фоне: вывод в /dev/null, команда завершается
$command = '/usr/bin/php /path/to/background.php > /dev/null 2>&1 &';
exec($command, $output, $returnCode);
echo "Команда запущена в фоне, код возврата: $returnCode";
?>

Важно: PHP продолжит выполнение, не дожидаясь завершения команды.

Получение stderr вместе с stdout с помощью proc_open

<?php
$descriptorspec = [
    0 => ['pipe', 'r'],
    1 => ['pipe', 'w'],
    2 => ['pipe', 'w']
];
$process = proc_open('ls /nonexistent', $descriptorspec, $pipes);
if (is_resource($process)) {
    fclose($pipes[0]);
    $stdout = stream_get_contents($pipes[1]);
    fclose($pipes[1]);
    $stderr = stream_get_contents($pipes[2]);
    fclose($pipes[2]);
    proc_close($process);
    echo "Stdout: '$stdout'\n";
    echo "Stderr: '$stderr'\n";
}
?>

Результат:

Stdout: ''
Stderr: 'ls: cannot access '/nonexistent': No such file or directory
'

Использование passthru для выдачи изображения

<?php
$imagePath = '/var/www/image.png';
if (file_exists($imagePath)) {
    header('Content-Type: image/png');
    passthru('cat ' . escapeshellarg($imagePath), $returnCode);
    if ($returnCode !== 0) {
        // обработка ошибки
    }
} else {
    echo 'Файл не найден';
}
?>

Комбинирование exec и escapeshellcmd

escapeshellcmd экранирует всю команду целиком (в отличие от escapeshellarg, который экранирует только один аргумент). Рекомендуется использовать для простых команд без аргументов.

<?php
$cmd = escapeshellcmd('ls -la /tmp'); // не экранирует аргументы, только метасимволы
$output = shell_exec($cmd);
echo $output;
?>

Внимание: escapeshellcmd не защищает от инъекций, если в команде есть непроверенные параметры. Лучше использовать escapeshellarg для каждого аргумента.

Неблокирующее выполнение с proc_open и stream_select

Позволяет взаимодействовать с процессом, не блокируя выполнение скрипта.

<?php
$descriptorspec = [0 => ['pipe', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']];
$process = proc_open('cat', $descriptorspec, $pipes);
stream_set_blocking($pipes[1], 0); // неблокирующий режим
fwrite($pipes[0], "Hello\n");
sleep(1); // имитация работы
fwrite($pipes[0], "World\n");
fclose($pipes[0]);
$output = '';
while ($line = fgets($pipes[1])) {
    $output .= $line;
}
echo $output;
fclose($pipes[1]); fclose($pipes[2]);
proc_close($process);
?>

Результат:

Hello
World

При таком подходе скрипт может продолжать обработку, пока процесс выполняется.