Monolog\SignalHandler Class Reference

Monolog POSIX signal handler. More...

Collaboration diagram for Monolog\SignalHandler:

Public Member Functions
	__construct (LoggerInterface $logger)
	registerSignalHandler ($signo, $level=LogLevel::CRITICAL, $callPrevious=true, $restartSyscalls=true, $async=true)
	handleSignal ($signo, array $siginfo=null)

Private Attributes
	$logger
	$previousSignalHandler = array()
	$signalLevelMap = array()
	$signalRestartSyscalls = array()

Detailed Description

Monolog POSIX signal handler.

Author

Robert Gust-Bardon rober.nosp@m.t@gu.nosp@m.st-ba.nosp@m.rdon.nosp@m..org

Definition at line 23 of file SignalHandler.php.

Constructor & Destructor Documentation

__construct()

Monolog\SignalHandler::__construct

(

LoggerInterface

$logger

)

Definition at line 31 of file SignalHandler.php.

    {
        $this->logger = $logger;
    }

Member Function Documentation

handleSignal()

Monolog\SignalHandler::handleSignal	(		$signo,
		array	$siginfo = null
	)

Definition at line 67 of file SignalHandler.php.

    {
        static $signals = array();
 
        if (!$signals && extension_loaded('pcntl')) {
            $pcntl = new ReflectionExtension('pcntl');
            $constants = $pcntl->getConstants();
            if (!$constants) {
                // HHVM 3.24.2 returns an empty array.
                $constants = get_defined_constants(true);
                $constants = $constants['Core'];
            }
            foreach ($constants as $name => $value) {
                if (substr($name, 0, 3) === 'SIG' && $name[3] !== '_' && is_int($value)) {
                    $signals[$value] = $name;
                }
            }
            unset($constants);
        }
 
        $level = isset($this->signalLevelMap[$signo]) ? $this->signalLevelMap[$signo] : LogLevel::CRITICAL;
        $signal = isset($signals[$signo]) ? $signals[$signo] : $signo;
        $context = isset($siginfo) ? $siginfo : array();
        $this->logger->log($level, sprintf('Program received signal %s', $signal), $context);
 
        if (!isset($this->previousSignalHandler[$signo])) {
            return;
        }
 
        if ($this->previousSignalHandler[$signo] === true || $this->previousSignalHandler[$signo] === SIG_DFL) {
            if (extension_loaded('pcntl') && function_exists('pcntl_signal') && function_exists('pcntl_sigprocmask') && function_exists('pcntl_signal_dispatch')
                && extension_loaded('posix') && function_exists('posix_getpid') && function_exists('posix_kill')) {
                    $restartSyscalls = isset($this->restartSyscalls[$signo]) ? $this->restartSyscalls[$signo] : true;
                    pcntl_signal($signo, SIG_DFL, $restartSyscalls);
                    pcntl_sigprocmask(SIG_UNBLOCK, array($signo), $oldset);
                    posix_kill(posix_getpid(), $signo);
                    pcntl_signal_dispatch();
                    pcntl_sigprocmask(SIG_SETMASK, $oldset);
                    pcntl_signal($signo, array($this, 'handleSignal'), $restartSyscalls);
                }
        } elseif (is_callable($this->previousSignalHandler[$signo])) {
            if (PHP_VERSION_ID >= 70100) {
                $this->previousSignalHandler[$signo]($signo, $siginfo);
            } else {
                $this->previousSignalHandler[$signo]($signo);
            }
        }
    }

References $context, and $name.

registerSignalHandler()

Monolog\SignalHandler::registerSignalHandler	(		$signo,
			$level = LogLevel::CRITICAL,
			$callPrevious = true,
			$restartSyscalls = true,
			$async = true
	)

Definition at line 36 of file SignalHandler.php.

    {
        if (!extension_loaded('pcntl') || !function_exists('pcntl_signal')) {
            return $this;
        }
 
        if ($callPrevious) {
            if (function_exists('pcntl_signal_get_handler')) {
                $handler = pcntl_signal_get_handler($signo);
                if ($handler === false) {
                    return $this;
                }
                $this->previousSignalHandler[$signo] = $handler;
            } else {
                $this->previousSignalHandler[$signo] = true;
            }
        } else {
            unset($this->previousSignalHandler[$signo]);
        }
        $this->signalLevelMap[$signo] = $level;
        $this->signalRestartSyscalls[$signo] = $restartSyscalls;
 
        if (function_exists('pcntl_async_signals') && $async !== null) {
            pcntl_async_signals($async);
        }
 
        pcntl_signal($signo, array($this, 'handleSignal'), $restartSyscalls);
 
        return $this;
    }

References $handler.

Field Documentation

$logger

Monolog\SignalHandler::$logger

private

Definition at line 25 of file SignalHandler.php.

$previousSignalHandler

Monolog\SignalHandler::$previousSignalHandler = array()

private

Definition at line 27 of file SignalHandler.php.

$signalLevelMap

Monolog\SignalHandler::$signalLevelMap = array()

private

Definition at line 28 of file SignalHandler.php.

$signalRestartSyscalls

Monolog\SignalHandler::$signalRestartSyscalls = array()

private

Definition at line 29 of file SignalHandler.php.

---

The documentation for this class was generated from the following file:

• libs/composer/vendor/monolog/monolog/src/Monolog/SignalHandler.php