PHP: полный мануал с примерами, функциями и ООП

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    echo "Ребёнок: считаю импорт
";
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo "Родитель: ребёнок завершён
";

Ребёнок: считаю импорт
Родитель: ребёнок завершён

Ребёнок заканчивает ветку через exit. Родитель получает его состояние через waitpid, поэтому вывод о завершении идёт после ребёнка. -1 и0 сравниваются строго. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$stock = 7;
$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    $stock = 9;
    echo "Ребёнок stock=$stock
";
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo "Родитель stock=$stock
";

Ребёнок stock=9
Родитель stock=7

При fork начальное содержимое памяти одинаковое, но дальше изменения обычной памяти раздельны. Linux использует copy-on-write; это не обещание нулевой стоимости. Для возвращения большого результата используйте IPC, а не exit code. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

pcntl_exec(PHP_BINARY, [__DIR__ . '/show-sku.php', 'A42']);
$error = pcntl_get_last_error();
fwrite(STDERR, 'Замена не выполнена: ' . pcntl_strerror($error) . "\n");
exit(1);

При успехе новый скрипт печатает SKU=A42; MODE=…; старый код после exec не исполняется.

Используем проверенный PHP_BINARY и свой файл. Если нужны stdout/stderr handles и возвращение в родителя, смотрите proc_open. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

pcntl_exec(PHP_BINARY, [__DIR__ . '/show-sku.php', 'A 42'], ['IMPORT_MODE' => 'preview']);
throw new RuntimeException('Не выполнен pcntl_exec: ' . pcntl_strerror(pcntl_get_last_error()));

SKU=A 42; MODE=preview

Артикул с пробелом передаётся одной строкой массива. Явная среда не включает PATH/HOME автоматически: добавляйте только нужные переменные. Новый PHP может использовать собственную ini конфигурацию. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(7);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
if (pcntl_wifexited($status)) echo "Код: ", pcntl_wexitstatus($status), "
";

Код: 7

Нормальное завершение означает exit/return, а не обязательно успех задачи: значение7 здесь описывает прикладную неудачу. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('fork не выполнен');
if ($pid === 0) exit(0);
$status = 0;
$done = pcntl_waitpid($pid, $status, WNOHANG);
if ($done === 0) {
    echo "События пока нет\n";
    do { $done = pcntl_waitpid($pid, $status); }
    while ($done === -1 && pcntl_get_last_error() === PCNTL_EINTR);
}
if ($done !== $pid) throw new RuntimeException('Не получено завершение');
echo pcntl_wifexited($status) ? "Получено нормальное завершение\n" : "Получено другое завершение\n";

Может сначала быть События пока нет; затем Получено нормальное завершение.

Не делаем busy loop из WNOHANG. Ветку0 не декодируем: $status там не новое событие. В production event loop должен иметь ожидание/паузы и общий deadline. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_wait($status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo "Собран ребёнок PID=$waited
";

Строка с PID собственного ребёнка.

В этом отдельном примере создан только один ребёнок, поэтому результат однозначен. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$usage = [];
$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    $sum = array_sum(range(1, 100));
    exit($sum === 5050 ? 0 : 1);
}
$status = 0;
do {
    $waited = pcntl_wait($status, 0, $usage);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo 'Завершение: ', pcntl_wifexited($status) ? pcntl_wexitstatus($status) : 'сигнал', "\n";
echo 'Счётчиков rusage: ', count($usage), "\n";

Завершение: 0 и количество предоставленных ОС счётчиков.

ru_utime.tv_sec/usec и ru_stime.tv_sec/usec дают CPU части; ru_maxrss имеет платформенные единицы, не автоматически байты. Неподдерживаемую статистику не выдаём за нулевой расход. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('fork не выполнен');
if ($pid === 0) exit(7);
do { $ok = pcntl_waitid(P_PID, $pid, $info, WEXITED); }
while (!$ok && pcntl_get_last_error() === PCNTL_EINTR);
if (!$ok || ($info['pid'] ?? 0) !== $pid) throw new RuntimeException('Нет события ребёнка');
if ($info['code'] === CLD_EXITED) echo 'Код: ', $info['status'], "\n";

Код: 7

Здесь status7 уже расшифрован в siginfo. Передача его в wexitstatus была бы ошибкой. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('fork не выполнен');
if ($pid === 0) exit(0);
do { $ok = pcntl_waitid(P_PID, $pid, $peek, WEXITED | WNOWAIT); }
while (!$ok && pcntl_get_last_error() === PCNTL_EINTR);
if (!$ok) throw new RuntimeException('Не прочитано событие');
echo 'Сначала увидели PID: ', $peek['pid'], "\n";
do { $done = pcntl_waitpid($pid, $status); }
while ($done === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($done !== $pid) throw new RuntimeException('Не собран ребёнок');
echo "Теперь завершение собрано\n";

PID при первом чтении, затем Теперь завершение собрано.

WNOWAIT — не остановка ребёнка и не признак его работы: завершённый ребёнок остаётся waitable, пока второе ожидание не освободит запись. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo pcntl_wifexited($status) ? "Обычный exit
" : "Иное событие
";

Обычный exit

Сначала wait получил реальный status, потом предикат определил вид события. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(7);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
if (pcntl_wifexited($status)) {
    echo pcntl_wexitstatus($status) === 0 ? "Задача успешна\n" : "Задача сообщила ошибку\n";
}

Задача сообщила ошибку

Разделены два вопроса: как закончился процесс и что он сообщил кодом. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(7);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
if (!pcntl_wifexited($status)) throw new RuntimeException('Не обычный выход');
echo 'Exit code: ', pcntl_wexitstatus($status), "\n";

Exit code: 7

Код7 имеет значение только в договоре вашего job; ОС не знает, что именно он означает. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(2);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
if (!pcntl_wifexited($status)) throw new RuntimeException('Сигнальное завершение');
$code = pcntl_wexitstatus($status);
echo match ($code) {
    0 => "Импорт выполнен\n",
    2 => "Входные данные не прошли проверку\n",
    default => "Неожиданный исход: проверьте журнал\n",
};

Входные данные не прошли проверку

Не повторяем job автоматически при любой ошибке. Код и журнал вместе позволяют отделить плохие входные данные от временной недоступности. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    pcntl_signal(SIGTERM, SIG_DFL);
    posix_kill(posix_getpid(), SIGTERM);
    exit(3);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo pcntl_wifsignaled($status) ? "Завершён сигналом
" : "Другой исход
";

Завершён сигналом

Изолированный ребёнок заранее ставит default SIGTERM; не посылаем сигнал найденному чужому PID. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(7);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo pcntl_wifsignaled($status) ? "Сигнал
" : "Это не сигнальное завершение
";

Это не сигнальное завершение

Даже ненулевой код7 не является номером сигнала. Для него применяют wexitstatus. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    pcntl_signal(SIGTERM, SIG_DFL);
    posix_kill(posix_getpid(), SIGTERM);
    exit(3);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
if (!pcntl_wifsignaled($status)) throw new RuntimeException('Ожидался сигнал');
echo pcntl_wtermsig($status) === SIGTERM ? "Получено завершение SIGTERM\n" : "Другой сигнал\n";

Получено завершение SIGTERM

Проверка вида события предшествует извлечению номера. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
if (pcntl_wifsignaled($status)) {
    echo 'Worker interrupted by signal ', pcntl_wtermsig($status), "\n";
} elseif (pcntl_wifexited($status)) {
    echo 'Worker exit ', pcntl_wexitstatus($status), "\n";
}

Worker exit 0

Даже в универсальном обработчике wtermsig вызывается только в своей ветке. Нельзя назвать0 «сигналом успешности». Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    if (!posix_kill(posix_getpid(), SIGSTOP)) exit(2);
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status, WUNTRACED);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
try {
    echo pcntl_wifstopped($status) ? "Ребёнок остановлен, но жив
" : "Другое событие
";
} finally {
    if (pcntl_wifstopped($status)) {
        posix_kill($pid, SIGCONT);
        do { $end = pcntl_waitpid($pid, $final); }
        while ($end === -1 && pcntl_get_last_error() === PCNTL_EINTR);
    }
}

Ребёнок остановлен, но жив

finally отправляет SIGCONT только своему ребёнку и собирает его последующий exit. Родитель не оставляет остановленную копию. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo pcntl_wifstopped($status) ? "Остановка
" : "Это не остановка
";

Это не остановка

Для exit значениеtrue даст wifexited, а не wifstopped. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    if (!posix_kill(posix_getpid(), SIGSTOP)) exit(2);
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status, WUNTRACED);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
try {
    if (!pcntl_wifstopped($status)) throw new RuntimeException('Не stop событие');
    echo pcntl_wstopsig($status) === SIGSTOP ? "Остановка SIGSTOP\n" : "Другой stop signal\n";
} finally {
    if (pcntl_wifstopped($status)) {
        posix_kill($pid, SIGCONT);
        do { $end = pcntl_waitpid($pid, $final); }
        while ($end === -1 && pcntl_get_last_error() === PCNTL_EINTR);
    }
}

Остановка SIGSTOP

После диагностики finally возобновляет и собирает ребёнка. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
if (pcntl_wifstopped($status)) echo 'Stop signal ', pcntl_wstopsig($status), "\n";
elseif (pcntl_wifexited($status)) echo "Worker уже завершён\n";

Worker уже завершён

Код, который умеет несколько событий, выбирает decoder по предикату; не читает случайные биты. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

if (!defined('WCONTINUED')) throw new RuntimeException('ОС не поддерживает continue events');
pcntl_sigprocmask(SIG_BLOCK, [SIGUSR1], $oldMask);
$pid = pcntl_fork();
if ($pid === -1) { pcntl_sigprocmask(SIG_SETMASK, $oldMask); throw new RuntimeException('fork failed'); }
if ($pid === 0) {
    posix_kill(posix_getpid(), SIGSTOP);
    pcntl_sigtimedwait([SIGUSR1], $notice, 2);
    exit(0);
}
$reaped = false;
try {
    do { $stopped = pcntl_waitpid($pid, $status, WUNTRACED); }
    while ($stopped === -1 && pcntl_get_last_error() === PCNTL_EINTR);
    $reaped = $stopped === $pid && (pcntl_wifexited($status) || pcntl_wifsignaled($status));
    if ($stopped !== $pid || !pcntl_wifstopped($status)) throw new RuntimeException('Нет stop события');
    if (!posix_kill($pid, SIGCONT)) throw new RuntimeException('Не продолжен ребёнок');
    do { $event = pcntl_waitpid($pid, $status, WCONTINUED); }
    while ($event === -1 && pcntl_get_last_error() === PCNTL_EINTR);
    $reaped = $event === $pid && (pcntl_wifexited($status) || pcntl_wifsignaled($status));
    if ($event === $pid) echo pcntl_wifcontinued($status) ? "Ребёнок продолжен\n" : "Уже другой исход\n";
} finally {
    if (!$reaped) {
        posix_kill($pid, SIGCONT);
        posix_kill($pid, SIGUSR1);
        do { $end = pcntl_waitpid($pid, $final); }
        while ($end === -1 && pcntl_get_last_error() === PCNTL_EINTR);
    }
    pcntl_sigprocmask(SIG_SETMASK, $oldMask);
}

Обычно Ребёнок продолжен; при иной очередности события явно выводится другой исход.

Блокированный SIGUSR1 удерживает ребёнка до команды родителя максимум2секунды после возобновления. Это более глубокий пример жизненного цикла, после уроков mask/sigtimedwait. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo pcntl_wifcontinued($status) ? "Continue
" : "Это не событие продолжения
";

Это не событие продолжения

Не пытаемся определить текущее состояние по заранее придуманному числу; всегда используем реальный status от ОС. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

pcntl_async_signals(true);
$reload = false;
if (!pcntl_signal(SIGUSR1, function (int $signal, mixed $info): void { echo "Получен SIGUSR1\n"; })) {
    throw new RuntimeException('Handler не установлен');
}
if (!posix_kill(posix_getpid(), SIGUSR1)) throw new RuntimeException('Сигнал не отправлен');
pcntl_signal_dispatch();

Получен SIGUSR1

Только свой процесс и известный установленный обработчик. Основная программа не получает из сигнала строку JSON: это уведомление. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

pcntl_async_signals(true);
$stop = false;
if (!pcntl_signal(SIGTERM, function () use (&$stop): void { $stop = true; })) throw new RuntimeException('Нет handler');
$jobs = ['A42', 'B17'];
foreach ($jobs as $sku) {
    if ($stop) break;
    echo "Короткая операция для $sku завершена\n";
    if ($sku === 'A42') posix_kill(posix_getpid(), SIGTERM);
    pcntl_signal_dispatch();
}
echo "Ресурсы можно закрыть в обычном потоке выполнения\n";

Короткая операция для A42 завершена
Ресурсы можно закрыть в обычном потоке выполнения

В демонстрации после первого задания посылаем сигнал себе. В production текущая операция тоже должна иметь timeout; один флаг не прерывает зависший драйвер. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$handler = pcntl_signal_get_handler(SIGUSR1);
echo match (true) {
    $handler === SIG_DFL => "Стандартная реакция ОС\n",
    $handler === SIG_IGN => "Сигнал игнорируется\n",
    default => "Установлен PHP callable\n",
};

Одна из трёх подписанных реакций.

Не сравниваем с магическими0/1: используем константы ОС. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$before = pcntl_signal_get_handler(SIGUSR1);
try {
    if (!pcntl_signal(SIGUSR1, function () {})) throw new RuntimeException('Handler не установлен');
    echo is_callable(pcntl_signal_get_handler(SIGUSR1)) ? "Временный callback установлен\n" : "Не callback\n";
} finally {
    if (!pcntl_signal(SIGUSR1, $before)) throw new RuntimeException('Handler не восстановлен');
}

Временный callback установлен

В этом примере сигналов нет, поэтому нечему остаться pending на границе восстановления. Для реального ожидания также согласуют mask и pending events. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$old = pcntl_async_signals(true);
echo 'Было: ', $old ? 'включено' : 'выключено', "\n";
echo 'Стало: ', pcntl_async_signals() ? 'включено' : 'выключено', "\n";
pcntl_async_signals($old);

Первое состояние зависит от запуска; второе Стало: включено.

Сохранённый bool позволяет вернуть настройку. Не пишем if(!pcntl_async_signals(true)) как проверку ошибки. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$seen = false;
pcntl_signal(SIGUSR1, function () use (&$seen): void { $seen = true; });
pcntl_async_signals(true);
if (!posix_kill(posix_getpid(), SIGUSR1)) throw new RuntimeException('Сигнал не отправлен');
echo $seen ? "Флаг обработан асинхронно\n" : "Обработка ещё ожидается\n";

После доставки Флаг обработан асинхронно; код явно допускает ещё ожидающую обработку.

Включение dispatch не делает процесс здоровым или завершённым; программа всё равно выбирает, что означает этот флаг. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

pcntl_async_signals(false);
$seen = false;
pcntl_signal(SIGUSR1, function () use (&$seen): void { $seen = true; });
if (!posix_kill(posix_getpid(), SIGUSR1)) throw new RuntimeException('Сигнал не отправлен');
echo $seen ? "Уже обработан\n" : "До dispatch флаг ещё false\n";
pcntl_signal_dispatch();
echo $seen ? "После dispatch флаг true\n" : "Событие ещё не получено\n";

До dispatch флаг ещё false
После dispatch флаг true

Callback меняет ту же переменную благодаря use(&$seen). Это не означает общую память двух процессов. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

pcntl_async_signals(false);
$handled = 0;
pcntl_signal(SIGUSR1, function () use (&$handled): void { $handled++; });
$ok = pcntl_signal_dispatch();
echo 'Вызов: ', $ok ? 'успешен' : 'отказ', '; обработано: ', $handled, "\n";

Вызов: успешен; обработано: 0 при отсутствии внешнего сигнала.

Свой счётчик показывает различие между успешным dispatch и фактом события. Цикл из таких вызовов без ожидания станет busy loop. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

if (!pcntl_sigprocmask(SIG_BLOCK, [SIGUSR1], $before)) throw new RuntimeException('Не изменена маска');
try {
    echo 'Ранее блокировалось сигналов: ', count($before), "\n";
} finally {
    if (!pcntl_sigprocmask(SIG_SETMASK, $before)) throw new RuntimeException('Не восстановлена маска');
}

Количество сигналов в прошлой маске.

Мы не предполагаем, что при запуске все сигналы были разблокированы. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$oldHandler = pcntl_signal_get_handler(SIGUSR1);
pcntl_signal(SIGUSR1, function () {});
if (!pcntl_sigprocmask(SIG_BLOCK, [SIGUSR1], $oldMask)) throw new RuntimeException('Маска не установлена');
try {
    if (!posix_kill(posix_getpid(), SIGUSR1)) throw new RuntimeException('Сигнал не отправлен');
    $signal = pcntl_sigtimedwait([SIGUSR1], $info, 1);
    echo $signal === SIGUSR1 ? "Pending уведомление принято\n" : "Уведомление не получено\n";
} finally {
    pcntl_sigprocmask(SIG_SETMASK, $oldMask);
    pcntl_signal_dispatch();
    pcntl_signal(SIGUSR1, $oldHandler);
}

Pending уведомление принято при успешной собственной отправке.

Mask установлен до posix_kill, поэтому стандартная реакция SIGUSR1 не завершает процесс. Синхронный wait потребляет событие; finally возвращает состояние. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$oldHandler = pcntl_signal_get_handler(SIGUSR1);
pcntl_signal(SIGUSR1, function () {});
if (!pcntl_sigprocmask(SIG_BLOCK, [SIGUSR1], $oldMask)) throw new RuntimeException('Маска не установлена');
try {
    if (!posix_kill(posix_getpid(), SIGUSR1)) throw new RuntimeException('Сигнал не отправлен');
    $number = pcntl_sigwaitinfo([SIGUSR1], $info);
    if ($number === false) throw new RuntimeException('Не принято уведомление');
    echo $number === SIGUSR1 ? "Принят SIGUSR1\n" : "Другой сигнал\n";
} finally {
    pcntl_sigprocmask(SIG_SETMASK, $oldMask);
    pcntl_signal_dispatch();
    pcntl_signal(SIGUSR1, $oldHandler);
}

Принят SIGUSR1

Сначала mask, затем проверенная отправка, затем wait: так пример не ждёт неизвестного внешнего отправителя. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$oldHandler = pcntl_signal_get_handler(SIGUSR1);
pcntl_signal(SIGUSR1, function () {});
if (!pcntl_sigprocmask(SIG_BLOCK, [SIGUSR1], $oldMask)) throw new RuntimeException('Маска не установлена');
try {
    if (!posix_kill(posix_getpid(), SIGUSR1)) throw new RuntimeException('Сигнал не отправлен');
    $number = pcntl_sigwaitinfo([SIGUSR1], $info);
    if ($number === false) throw new RuntimeException('Ошибка ожидания');
    echo 'signo=', $info['signo'], '; code=', $info['code'], "\n";
} finally {
    pcntl_sigprocmask(SIG_SETMASK, $oldMask);
    pcntl_signal_dispatch();
    pcntl_signal(SIGUSR1, $oldHandler);
}

Номер SIGUSR1 и системный code.

Не обещаем pid/uid для всякого SIGUSR1: набор полей задаёт PHP wrapper и ОС. Для имени типа сравниваем с константами, а не фиксированным числом. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$oldHandler = pcntl_signal_get_handler(SIGUSR1);
pcntl_signal(SIGUSR1, function () {});
if (!pcntl_sigprocmask(SIG_BLOCK, [SIGUSR1], $oldMask)) throw new RuntimeException('Маска не установлена');
try {
    if (!posix_kill(posix_getpid(), SIGUSR1)) throw new RuntimeException('Сигнал не отправлен');
    $number = pcntl_sigtimedwait([SIGUSR1], $info, 1, 0);
    echo $number === SIGUSR1 ? "Уведомление принято\n" : "Нет подтверждённого уведомления\n";
} finally {
    pcntl_sigprocmask(SIG_SETMASK, $oldMask);
    pcntl_signal_dispatch();
    pcntl_signal(SIGUSR1, $oldHandler);
}

Уведомление принято

Верхняя граница относится к этому ожиданию. Серия вызовов по1секунде без общего deadline может продолжаться бесконечно. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$oldHandler = pcntl_signal_get_handler(SIGUSR1);
pcntl_signal(SIGUSR1, function () {});
if (!pcntl_sigprocmask(SIG_BLOCK, [SIGUSR1], $oldMask)) throw new RuntimeException('Маска не установлена');
try {
    $info = [];
    $number = pcntl_sigtimedwait([SIGUSR1], $info, 0, 10_000_000);
    echo $number === false ? "За интервал сигнал не получен или ожидание не выполнено\n" : "Получен сигнал\n";
} finally {
    pcntl_sigprocmask(SIG_SETMASK, $oldMask);
    pcntl_signal_dispatch();
    pcntl_signal(SIGUSR1, $oldHandler);
}

Без внешнего SIGUSR1 — строка о неполученном сигнале.

Интервал10миллисекунд выражен в наносекундах. Старый массив info заранее очищен; после false его нельзя выдавать за данные нового события. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

pcntl_async_signals(true);
pcntl_signal(SIGALRM, function (): void { echo "Срок уведомления наступил\n"; });
pcntl_alarm(2);
$remaining = pcntl_alarm(0);
echo 'Отменён alarm, оставалось секунд: ', $remaining, "\n";

Обычно оставалось2секунды; точное число зависит от времени исполнения.

0 отменяет уведомление. Этот пример не ждёт2секунды и не назначает таймер другому процессу. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

pcntl_async_signals(true);
$expired = false;
pcntl_signal(SIGALRM, function () use (&$expired): void { $expired = true; });
pcntl_alarm(1);
try {
    foreach (['A42', 'B17', 'C09'] as $sku) {
        if ($expired) break;
        echo "Обработан $sku\n";
    }
    echo $expired ? "Сработал alarm\n" : "Короткая работа закончена до alarm\n";
} finally { pcntl_alarm(0); }

Обычно три строки товаров и Короткая работа закончена до alarm.

Флаг проверяется между короткими действиями. Это иллюстрация кооперативной остановки, не жёсткая гарантия времени выполнения внешнего вызова. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$nice = pcntl_getpriority();
if ($nice === false) throw new RuntimeException(pcntl_strerror(pcntl_get_last_error()));
echo "Текущий nice: $nice\n";

Число nice текущего процесса по настройке ОС.

Сравнение ===false сохраняет корректное значение -1. Не меняем параметры соседних процессов. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$nice = pcntl_getpriority(null, PRIO_PROCESS);
if ($nice === false) throw new RuntimeException('Не прочитан nice');
echo $nice >= 10 ? "Уже уступаем обычной работе\n" : "Можно отдельно согласовать фоновый режим\n";

Одна из двух диагностических строк согласно nice.

Порог10 — выбранная политика примера, не универсальная граница ОС. Реальная scheduling policy/cgroup quota также влияет на работу. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$before = pcntl_getpriority();
if ($before === false) throw new RuntimeException('Не прочитан nice');
$target = max($before, 10);
if (!pcntl_setpriority($target)) throw new RuntimeException(pcntl_strerror(pcntl_get_last_error()));
echo 'Фоновый worker, nice=', pcntl_getpriority(), "\n";
echo "Здесь выполняется ограниченная пакетная работа\n";

Nice не меньше прежнего/10 и строка о пакетной работе.

Подходит для Linux nice диапазона. Процесс завершается после задачи; не пытаемся повышать права для отката. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$nice = pcntl_getpriority(null, PRIO_PROCESS);
if ($nice === false) throw new RuntimeException('Не прочитан nice');
if (!pcntl_setpriority($nice, null, PRIO_PROCESS)) throw new RuntimeException('Установка запрещена политикой ОС');
echo "Параметр своего процесса сохранён\n";

Параметр своего процесса сохранён при разрешённом вызове.

Пример показывает правильное расположение аргументов и обработку отказа без изменения чужих целей. Nice не заменяет rate limit API или ограничение числа worker. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$cpus = pcntl_getcpuaffinity();
if ($cpus === false) throw new RuntimeException(pcntl_strerror(pcntl_get_last_error()));
echo 'Разрешены: ', implode(', ', $cpus), "\n";

Список реально разрешённых логических CPU.

Контейнер может дать непоследовательные ID, поэтому не строим range(0,count-1). Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$cpus = pcntl_getcpuaffinity();
if ($cpus === false || $cpus === []) throw new RuntimeException('Нет доступной CPU mask');
$jobs = 3;
$workers = min($jobs, count($cpus));
echo "Верхняя оценка worker: $workers\n";

Число1…3 по количеству доступных CPU.

Это лишь отправная точка: CPU quota может быть меньше mask, а память/БД ограничивают параллелизм отдельно. Для ожидания сети CPU count не универсальная формула. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$before = pcntl_getcpuaffinity();
if ($before === false || $before === []) throw new RuntimeException('Нет исходной mask');
try {
    if (!pcntl_setcpuaffinity(null, [$before[0]])) throw new RuntimeException('Не установлена mask');
    echo 'На время разрешён CPU ', $before[0], "\n";
} finally {
    if (!pcntl_setcpuaffinity(null, $before)) throw new RuntimeException('Не восстановлена исходная mask');
}

Выбранный разрешённый CPU; затем восстановлена исходная mask.

Это настройка отдельного CLI измерения, не совет закреплять каждый HTTP запрос. Для вычисления результата PHP pinning обычно не требуется. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

try {
    pcntl_setcpuaffinity(null, []);
} catch (ValueError $error) {
    echo "Нужен непустой список CPU\n";
}

Нужен непустой список CPU

Ошибка аргумента возникает до изменения ОС. Полный разрешённый список получают чтением, а не пустым массивом. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$cpu = pcntl_getcpu();
echo $cpu >= 0 ? "Снимок CPU: $cpu\n" : "Снимок CPU недоступен\n";

Снимок CPU с integer ID либо явное отсутствие снимка.

Не подставляем старую pcntl_get_last_error в объяснение -1 этого wrapper. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$samples = [];
for ($i = 0; $i < 3; $i++) $samples[] = pcntl_getcpu();
echo implode(' → ', $samples), "\n";

Три CPU ID, которые могут совпадать или различаться.

Равенство снимков не доказывает отсутствие миграций между вызовами. Для времени используйте hrtime; для CPU budget — инструменты ОС. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$qos = pcntl_getqos_class();
echo $qos->name, "\n";

Имя одного из пяти случаев enum по среде.

У unit enum есть name; поле value здесь отсутствует. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$qos = pcntl_getqos_class();
echo $qos === Pcntl\QosClass::Background ? "Фоновое обслуживание\n" : "Другой класс важности\n";

Подписанная ветка согласно текущему QoS.

Сравниваем enum case, не название произвольной строки из HTTP формы. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$before = pcntl_getqos_class();
try {
    pcntl_setqos_class(Pcntl\QosClass::Utility);
    echo "Здесь короткий фрагмент пакетного импорта\n";
} finally {
    pcntl_setqos_class($before);
}

Строка о пакетном импорте при успешной настройке/восстановлении.

Передаём case явно. Пакетная задача всё равно должна иметь разумные размеры/таймауты. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

pcntl_setqos_class(Pcntl\QosClass::Background);
echo 'Класс worker: ', pcntl_getqos_class()->name, "\n";

Класс worker: Background при поддержке и успешном вызове.

Процесс предназначен только для фоновой задачи. При смене роли нужно пересмотреть класс, а не навсегда распространять его на чужую работу. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

foreach (Pcntl\QosClass::cases() as $case) echo $case->name, "\n";

UserInteractive
UserInitiated
Default
Utility
Background

Только чтение cases; не меняет приоритет процесса. Требует PCNTL, но не запускает scheduling API Apple. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$task = 'catalog-import';
$qos = match ($task) {
    'catalog-import' => Pcntl\QosClass::Utility,
    'cache-cleanup' => Pcntl\QosClass::Background,
    default => Pcntl\QosClass::Default,
};
echo $qos->name, "\n";

Utility

Сначала прикладная политика, затем отдельный вызов setter в совместимой среде. Этот список задач принадлежит нашему приложению. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    if (!pcntl_unshare(CLONE_NEWUTS)) exit(2);
    echo "Ребёнок получил отдельный UTS namespace\n";
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo 'Результат: ', pcntl_wifexited($status) ? pcntl_wexitstatus($status) : 'сигнал', "\n";

При разрешении: строка ребёнка и Результат:0; иначе код2/диагностика отказа.

ОС должна разрешать namespace operation. Имя хоста не меняем, чужие процессы не затрагиваем. Родитель остаётся в исходном namespace. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    if (!pcntl_unshare(CLONE_NEWNET)) exit(2);
    $name = readlink('/proc/self/ns/net');
    echo 'Локальный network namespace: ', $name === false ? 'не прочитан' : $name, "\n";
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo pcntl_wifexited($status) && pcntl_wexitstatus($status) === 0 ? "Изолированный шаг завершён\n" : "Изоляция не подтверждена\n";

Идентификатор своего нового network namespace и завершение либо явный отказ.

Linux /proc должен быть доступен. Мы не поднимаем интерфейсы и не отправляем пакеты. В новом namespace требуется отдельная настройка сети; отсутствие маршрута не исправляют отправкой через контекст хоста. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

if (!pcntl_setns(null, CLONE_NEWNET)) {
    throw new RuntimeException('Вход не разрешён: ' . pcntl_strerror(pcntl_get_last_error()));
}
echo "Выбрано существующее сетевое окружение своего процесса\n";

Подтверждение при достаточных правах либо обработанный отказ.

Даже вход в свой namespace требует правил setns/capabilities. Это показывает API без PID из внешнего запроса и без контакта с сетью. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$owner = posix_getpid();
$pid = pcntl_fork();
if ($pid === -1) throw new RuntimeException('Не создан ребёнок');
if ($pid === 0) {
    if (!pcntl_unshare(CLONE_NEWUTS)) exit(2);
    if (!pcntl_setns($owner, CLONE_NEWUTS)) exit(3);
    echo "Ребёнок вернулся в исходное UTS окружение\n";
    exit(0);
}
$status = 0;
do {
    $waited = pcntl_waitpid($pid, $status);
} while ($waited === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($waited !== $pid) throw new RuntimeException('Не получено состояние своего ребёнка');
echo 'Код ребёнка: ', pcntl_wifexited($status) ? pcntl_wexitstatus($status) : 'сигнал', "\n";

При поддержке/правах: сообщение ребёнка и Код ребёнка:0; иначе соответствующий отказ.

Родитель жив и ждёт именно этого ребёнка. Изменяется только контекст ребёнка, не родителя; имена хостов не записываются. Если цель завершилась, её PID нельзя использовать повторно наугад. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_rfork(RFPROC | RFFDG);
if ($pid === -1) throw new RuntimeException(pcntl_strerror(pcntl_get_last_error()));
if ($pid === 0) { echo "Собственный ребёнок\n"; exit(0); }
do { $done = pcntl_waitpid($pid, $status); }
while ($done === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($done !== $pid) throw new RuntimeException('Ребёнок не собран');
echo "Родитель собрал ребёнка\n";

Собственный ребёнок
Родитель собрал ребёнка

RFFDG отделяет descriptor table, но открытые файлы могут всё ещё ссылаться на общие open file descriptions и offsets. Сокетный протокол БД не становится безопасным для совместного использования. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

try {
    pcntl_rfork(RFPROC | RFFDG | RFCFDG);
} catch (ValueError $error) {
    echo "Нельзя одновременно копировать и очищать descriptor table\n";
}

Нельзя одновременно копировать и очищать descriptor table

Только в BSD сборке с обоими флагами; rejected arguments не создают ребёнка. RFCFDG без конфликта закрыл бы также привычные стандартные handles. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_forkx(FORK_WAITPID);
if ($pid === -1) throw new RuntimeException(pcntl_strerror(pcntl_get_last_error()));
if ($pid === 0) { echo "Собственный ребёнок\n"; exit(0); }
do { $done = pcntl_waitpid($pid, $status); }
while ($done === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($done !== $pid) throw new RuntimeException('Ребёнок не собран');
echo "Родитель собрал ребёнка\n";

Собственный ребёнок
Родитель собрал ребёнка

Общий wait()/waitid(P_ALL) не должен забирать этого ребёнка; нужен конкретный PID. Если его не собрать, он остаётся zombie. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$pid = pcntl_forkx(FORK_NOSIGCHLD);
if ($pid === -1) throw new RuntimeException(pcntl_strerror(pcntl_get_last_error()));
if ($pid === 0) { echo "Собственный ребёнок\n"; exit(0); }
do { $done = pcntl_waitpid($pid, $status); }
while ($done === -1 && pcntl_get_last_error() === PCNTL_EINTR);
if ($done !== $pid) throw new RuntimeException('Ребёнок не собран');
echo "Родитель собрал ребёнка\n";

Собственный ребёнок
Родитель собрал ребёнка

Флаг относится к уведомлению о завершении; job control stop/continue уведомления могут иметь другие правила. Отсутствие сигнала не значит отсутствие wait result. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$result = pcntl_waitpid(-1, $status, WNOHANG);
if ($result === -1) {
    $code = pcntl_get_last_error();
    echo $code === PCNTL_ECHILD ? "В этом отдельном CLI нет детей\n" : "Иной отказ ожидания\n";
} else {
    echo "Есть состояние созданных ранее детей\n";
}

В этом отдельном CLI нет детей

Новый CLI не создавал детей. ECHILD приходит при -1; WNOHANG0 означал бы другой случай — ребёнок есть, нового события пока нет. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$done = pcntl_waitpid(-1, $status, WNOHANG);
if ($done === -1) {
    $code = pcntl_get_last_error();
    $report = ['operation' => 'waitpid', 'errno' => $code, 'message' => pcntl_strerror($code)];
    echo json_encode($report, JSON_THROW_ON_ERROR), "\n";
}

JSON с operationwaitpid, кодом ECHILD и системным текстом в отдельном CLI без детей.

Локализованный текст полезен человеку, но ветвление делается по числовой константе. Нет подавления warning оператором @. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

pcntl_waitpid(-1, $status, WNOHANG);
$short = pcntl_errno();
$long = pcntl_get_last_error();
echo $short === $long ? "Один сохранённый код\n" : "Код изменился между вызовами\n";

Один сохранённый код

В отдельном CLI без созданных детей ожидается ECHILD. Между чтениями нет операции, записывающей другую PCNTL ошибку. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$done = pcntl_waitpid(-1, $status, WNOHANG);
if ($done === -1 && pcntl_errno() === PCNTL_ECHILD) echo "Ожидание закончено: детей нет\n";
elseif ($done === 0) echo "Ребёнок есть, события пока нет\n";
elseif ($done > 0) echo "Получено событие ребёнка\n";
else throw new RuntimeException('Иной отказ wait');

Ожидание закончено: детей нет в свежем CLI.

Ошибку отсутствия подходящего ребёнка нельзя лечить быстрым бесконечным повтором. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

echo 'ECHILD: ', pcntl_strerror(PCNTL_ECHILD), "\n";

Системный текст о том, что подходящих дочерних процессов нет.

Не фиксируем английскую фразу как критерий проверки на любой ОС. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.

<?php
declare(strict_types=1);

$labels = [PCNTL_EINTR => 'Можно решить, повторять ли ожидание', PCNTL_ECHILD => 'Детей для ожидания нет'];
foreach ($labels as $code => $action) echo $code, ': ', pcntl_strerror($code), ' — ', $action, "\n";

Две подписанные причины с платформенными числовыми значениями и текстом.

Это справочный вывод без выполнения fork/сигналов. EINTR retry должен учитывать запрос остановки и deadline конкретной задачи. Контекст: отдельный Unix CLI с PCNTL; примеры с posix_* также требуют POSIX. Здесь проверен PHP синтаксис; Unix процессы/сигналы на Windows не исполнялись. Все цели — свой процесс или собственные короткоживущие дети; не вставляйте пример в PHP-FPM.