Команды PHP CLI: полное руководство по настройке окружения

Расширенные примеры использования PHP CLI

Демон с обработкой сигналов

Скрипт может работать как долгоиграющий процесс, реагируя на сигналы от операционной системы. Для этого используются функции pcntl_signal() и pcntl_signal_dispatch().

<?php
declare(ticks = 1); // для старых версий PHP, в PHP 8 не требуется

pcntl_signal(SIGTERM, function ($signo) {
    echo "Получен сигнал $signo, завершаю работу.\n";
    exit(0);
});
pcntl_signal(SIGINT, function () {
    echo "Прерывание (Ctrl+C). Выход.\n";
    exit(0);
});

echo "Демон запущен. PID: " . getmypid() . "\n";
while (true) {
    echo "Работаю...\n";
    sleep(2);
    pcntl_signal_dispatch();
}
?>

Результат (при запуске и отправке SIGTERM):

Демон запущен. PID: 12345
Работаю...
Работаю...
Получен сигнал 15, завершаю работу.

Параллельное выполнение с помощью pcntl_fork

В CLI-режиме возможно создавать дочерние процессы для параллельной обработки. Функция pcntl_fork() возвращает 0 в дочернем процессе и PID потомка в родительском.

<?php
$pids = [];
for ($i = 1; $i <= 3; $i++) {
    $pid = pcntl_fork();
    if ($pid == -1) {
        die("Не удалось создать процесс");
    } elseif ($pid == 0) {
        // Дочерний процесс
        echo "Дочерний процесс $i начал работу (PID: " . getmypid() . ")\n";
        sleep(2);
        echo "Дочерний процесс $i завершён.\n";
        exit(0);
    } else {
        $pids[] = $pid;
    }
}
// Родитель ждёт завершения всех потомков
foreach ($pids as $pid) {
    pcntl_waitpid($pid, $status);
    echo "Родитель: процесс $pid завершён с кодом " . pcntl_wexitstatus($status) . "\n";
}
?>

Пример вывода:

Дочерний процесс 1 начал работу (PID: 12346)
Дочерний процесс 2 начал работу (PID: 12347)
Дочерний процесс 3 начал работу (PID: 12348)
Дочерний процесс 1 завершён.
Родитель: процесс 12346 завершён с кодом 0
Дочерний процесс 2 завершён.
Родитель: процесс 12347 завершён с кодом 0
Дочерний процесс 3 завершён.
Родитель: процесс 12348 завершён с кодом 0

Взаимодействие с внешними программами через proc_open

Функция proc_open() позволяет запустить внешнюю команду и управлять её потоками ввода-вывода. Это мощный инструмент для автоматизации.

<?php
$descriptorspec = [
    0 => ['pipe', 'r'],  // stdin
    1 => ['pipe', 'w'],  // stdout
    2 => ['pipe', 'w'],  // stderr
];

$process = proc_open('cat', $descriptorspec, $pipes);

if (is_resource($process)) {
    fwrite($pipes[0], 'Привет, proc_open!');
    fclose($pipes[0]);

    $stdout = stream_get_contents($pipes[1]);
    fclose($pipes[1]);

    $stderr = stream_get_contents($pipes[2]);
    fclose($pipes[2]);

    $return = proc_close($process);

    echo "STDOUT: $stdout\n";
    echo "STDERR: $stderr\n";
    echo "Код возврата: $return\n";
}
?>

Результат:

STDOUT: Привет, proc_open!
STDERR: 
Код возврата: 0

Интерактивный ввод с историей через readline

Расширение readline предоставляет функции для построчного ввода с автодополнением и историей команд. Это удобно для создания собственных REPL-интерфейсов.

<?php
$history = [];
while (true) {
    $line = readline('php> ');
    if ($line === false || trim($line) === 'exit' || trim($line) === 'quit') {
        break;
    }
    readline_add_history($line);
    try {
        $result = eval($line);
        if ($result !== null) {
            var_dump($result);
        }
    } catch (Throwable $e) {
        echo "Ошибка: " . $e->getMessage() . "\n";
    }
}
?>

Запуск и ввод нескольких выражений:

php> 2 + 2
int(4)
php> strtoupper('hello')
string(5) "HELLO"
php> exit

Цветной вывод в консоли

С помощью ANSI-escape последовательностей можно добавлять цвета и стили к выводу в терминале.

<?php
function colorize($text, $color = 'white', $background = null, $bold = false) {
    $colors = [
        'red' => 31, 'green' => 32, 'yellow' => 33, 'blue' => 34,
        'magenta' => 35, 'cyan' => 36, 'white' => 37,
    ];
    $bg = null;
    if ($background && isset($colors[$background])) {
        $bg = $colors[$background] + 10; // фон = 40-47
    }
    $code = '';
    if ($bold) $code .= "\033[1;";
    else $code .= "\033[0;";
    $code .= $colors[$color];
    if ($bg) $code .= ";" . $bg;
    $code .= "m";
    return $code . $text . "\033[0m";
}

echo colorize('Красный текст', 'red') . "\n";
echo colorize('Зелёный жирный', 'green', null, true) . "\n";
echo colorize('Белый на синем фоне', 'white', 'blue') . "\n";
?>

Результат будет разноцветным в поддерживающем терминале.