pcntl_rfork

(PHP 8 >= 8.1.0)

pcntl_rforkВзаимодействует с ресурсами процесса

Описание

pcntl_rfork(int $flags, int $signal = 0): int

Взаимодействует с ресурсами процесса.

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

flags

Параметр flags определяет, какие ресурсы вызывающего процесса (родительского) разделяются новым процессом (дочерним) или инициализируются в значения по умолчанию.

flags является логическим OR (или) некоторого подмножества из:

  • RFPROC: Если установлено, создаётся новый процесс; в противном случае изменения затрагивают текущий процесс.
  • RFNOWAIT: Если установлено, дочерний процесс будет отделён от родительского. При выходе дочерний процесс не будет оставлять статус для родителя, чтобы забрать его.
  • RFFDG: Если установлено, копируется таблица дескрипторов файлов вызывающей стороны; В противном случае два процесса используют одну таблицу.
  • RFCFDG: Если установлено, новый процесс начинается с чистой таблицей дескрипторов файлов. Взаимоисключающий флаг с RFFDG.
  • RFLINUXTHPN: Если установлено, ядро будет возвращать SIGUSR1 вместо SIGCHILD при выходе из дочернего потока. Предназначен для уведомления родительского процесса о выходе из Linux-клона.

signal

Номер сигнала.

Возвращаемые значения

В случае успешного выполнения в потоке выполнения родительского процесса возвращается PID дочернего процесса, а в потоке выполнения дочернего процесса возвращается 0. В случае возникновения ошибки в контексте родителя будет возвращено -1, дочерний процесс не будет создан и будет выдана ошибка PHP.

Примеры

Пример #1 Пример использования pcntl_rfork()

<?php

$pid 
pcntl_rfork(RFNOWAIT|RFTSIGZMBSIGUSR1);
if (
$pid 0) {
  
// Родительский процесс.
  
var_dump($pid);
} else {
  
// Дочерний процесс.
  
var_dump($pid);
  
sleep(2); // поскольку дочерний процесс не ждёт, мы видим его "pid".
}
?>

Результатом выполнения данного примера будет что-то подобное:

int(77093)
int(0)

Смотрите также

  • pcntl_fork() - Разветвить (fork) текущий запущенный процесс
  • pcntl_waitpid() - Ожидает или возвращает статус порождённого дочернего процесса
  • pcntl_signal() - Установка обработчика сигнала
  • cli_set_process_title() - Устанавливает заголовок процесса

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top