Monolog\SignalHandlerTest Class Reference

Inheritance diagram for Monolog\SignalHandlerTest:

Collaboration diagram for Monolog\SignalHandlerTest:

Public Member Functions
	testHandleSignal ()
	testRegisterSignalHandler ()
	@depends testHandleSignal @requires extension pcntl @requires extension posix @requires function pcntl_signal @requires function pcntl_signal_dispatch @requires function posix_getpid @requires function posix_kill More...
	testRegisterDefaultPreviousSignalHandler ($signo, $callPrevious, $expected)
	@dataProvider defaultPreviousProvider @depends testRegisterSignalHandler @requires function pcntl_fork @requires function pcntl_sigprocmask @requires function pcntl_waitpid More...
	defaultPreviousProvider ()
	testRegisterCallablePreviousSignalHandler ($callPrevious)
	@dataProvider callablePreviousProvider @depends testRegisterSignalHandler @requires function pcntl_signal_get_handler More...
	callablePreviousProvider ()
	testRegisterSyscallRestartingSignalHandler ($restartSyscalls)
	@dataProvider restartSyscallsProvider @depends testRegisterDefaultPreviousSignalHandler @requires function pcntl_fork @requires function pcntl_waitpid More...
	restartSyscallsProvider ()
	testRegisterAsyncSignalHandler ($initialAsync, $desiredAsync, $expectedBefore, $expectedAfter)
	@dataProvider asyncProvider @depends testRegisterDefaultPreviousSignalHandler @requires function pcntl_async_signals More...
	asyncProvider ()

Protected Member Functions
	setUp ()
	tearDown ()
Protected Member Functions inherited from Monolog\TestCase
	getRecord ($level=Logger::WARNING, $message='test', $context=array())
	getMultipleRecords ()
	getIdentityFormatter ()

Private Member Functions
	setSignalHandler ($signo, $handler=SIG_DFL)

Private Attributes
	$asyncSignalHandling
	$blockedSignals
	$signalHandlers

Detailed Description

Author

Robert Gust-Bardon rober.nosp@m.t@gu.nosp@m.st-ba.nosp@m.rdon.nosp@m..org @covers Monolog\SignalHandler

Definition at line 22 of file SignalHandlerTest.php.

Member Function Documentation

asyncProvider()

Monolog\SignalHandlerTest::asyncProvider

(

)

Definition at line 275 of file SignalHandlerTest.php.

    {
        return array(
            array(false, false, 0, 1),
            array(false, null, 0, 1),
            array(false, true, 1, 1),
            array(true, false, 0, 1),
            array(true, null, 1, 1),
            array(true, true, 1, 1),
        );
    }

callablePreviousProvider()

Monolog\SignalHandlerTest::callablePreviousProvider

(

)

Definition at line 194 of file SignalHandlerTest.php.

    {
        return array(
            array(false),
            array(true),
        );
    }

defaultPreviousProvider()

Monolog\SignalHandlerTest::defaultPreviousProvider

(

)

Definition at line 157 of file SignalHandlerTest.php.

    {
        if (!defined('SIGCONT') || !defined('SIGINT') || !defined('SIGURG')) {
            return array();
        }
 
        return array(
            array(SIGINT, false, 'Program received signal SIGINT'.SIGCONT.'Program received signal SIGINT'),
            array(SIGINT, true, 'Program received signal SIGINT'),
            array(SIGURG, false, 'Program received signal SIGURG'.SIGCONT.'Program received signal SIGURG'),
            array(SIGURG, true, 'Program received signal SIGURG'.SIGCONT.'Program received signal SIGURG'),
        );
    }

restartSyscallsProvider()

Monolog\SignalHandlerTest::restartSyscallsProvider

(

)

Definition at line 246 of file SignalHandlerTest.php.

    {
        return array(
            array(false),
            array(true),
            array(false),
            array(true),
        );
    }

setSignalHandler()

Monolog\SignalHandlerTest::setSignalHandler (   $signo,   $handler = SIG_DFL  )

private

Definition at line 58 of file SignalHandlerTest.php.

                                                                  {
        if (function_exists('pcntl_signal_get_handler')) {
            $this->signalHandlers[$signo] = pcntl_signal_get_handler($signo);
        } else {
            $this->signalHandlers[$signo] = SIG_DFL;
        }
        $this->assertTrue(pcntl_signal($signo, $handler));
    }

References $handler.

setUp()

Monolog\SignalHandlerTest::setUp ( )

protected

Definition at line 29 of file SignalHandlerTest.php.

    {
        $this->signalHandlers = array();
        if (extension_loaded('pcntl')) {
            if (function_exists('pcntl_async_signals')) {
                $this->asyncSignalHandling = pcntl_async_signals();
            }
            if (function_exists('pcntl_sigprocmask')) {
                pcntl_sigprocmask(SIG_BLOCK, array(), $this->blockedSignals);
            }
        }
    }

tearDown()

Monolog\SignalHandlerTest::tearDown ( )

protected

Definition at line 42 of file SignalHandlerTest.php.

    {
        if ($this->asyncSignalHandling !== null) {
            pcntl_async_signals($this->asyncSignalHandling);
        }
        if ($this->blockedSignals !== null) {
            pcntl_sigprocmask(SIG_SETMASK, $this->blockedSignals);
        }
        if ($this->signalHandlers) {
            pcntl_signal_dispatch();
            foreach ($this->signalHandlers as $signo => $handler) {
                pcntl_signal($signo, $handler);
            }
        }
    }

References $handler.

testHandleSignal()

Monolog\SignalHandlerTest::testHandleSignal

(

)

Definition at line 67 of file SignalHandlerTest.php.

    {
        $logger = new Logger('test', array($handler = new TestHandler));
        $errHandler = new SignalHandler($logger);
        $signo = 2;  // SIGINT.
        $siginfo = array('signo' => $signo, 'errno' => 0, 'code' => 0);
        $errHandler->handleSignal($signo, $siginfo);
        $this->assertCount(1, $handler->getRecords());
        $this->assertTrue($handler->hasCriticalRecords());
        $records = $handler->getRecords();
        $this->assertSame($siginfo, $records[0]['context']);
    }

References $handler, and $records.

testRegisterAsyncSignalHandler()

Monolog\SignalHandlerTest::testRegisterAsyncSignalHandler	(		$initialAsync,
			$desiredAsync,
			$expectedBefore,
			$expectedAfter
	)

@dataProvider asyncProvider @depends testRegisterDefaultPreviousSignalHandler @requires function pcntl_async_signals

Definition at line 261 of file SignalHandlerTest.php.

    {
        $this->setSignalHandler(SIGURG, SIG_IGN);
        pcntl_async_signals($initialAsync);
 
        $logger = new Logger('test', array($handler = new TestHandler));
        $errHandler = new SignalHandler($logger);
        $errHandler->registerSignalHandler(SIGURG, LogLevel::INFO, false, false, $desiredAsync);
        $this->assertTrue(posix_kill(posix_getpid(), SIGURG));
        $this->assertCount($expectedBefore, $handler->getRecords());
        $this->assertTrue(pcntl_signal_dispatch());
        $this->assertCount($expectedAfter, $handler->getRecords());
    }

References $handler.

testRegisterCallablePreviousSignalHandler()

Monolog\SignalHandlerTest::testRegisterCallablePreviousSignalHandler

(

$callPrevious

)

@dataProvider callablePreviousProvider @depends testRegisterSignalHandler @requires function pcntl_signal_get_handler

Definition at line 176 of file SignalHandlerTest.php.

    {
        $this->setSignalHandler(SIGURG, SIG_IGN);
 
        $logger = new Logger('test', array($handler = new TestHandler));
        $errHandler = new SignalHandler($logger);
        $previousCalled = 0;
        pcntl_signal(SIGURG, function ($signo, array $siginfo = null) use (&$previousCalled) {
            ++$previousCalled;
        });
        $errHandler->registerSignalHandler(SIGURG, LogLevel::INFO, $callPrevious, false, false);
        $this->assertTrue(posix_kill(posix_getpid(), SIGURG));
        $this->assertTrue(pcntl_signal_dispatch());
        $this->assertCount(1, $handler->getRecords());
        $this->assertTrue($handler->hasInfoThatContains('SIGURG'));
        $this->assertSame($callPrevious ? 1 : 0, $previousCalled);
    }

References $handler.

testRegisterDefaultPreviousSignalHandler()

Monolog\SignalHandlerTest::testRegisterDefaultPreviousSignalHandler	(		$signo,
			$callPrevious,
			$expected
	)

@dataProvider defaultPreviousProvider @depends testRegisterSignalHandler @requires function pcntl_fork @requires function pcntl_sigprocmask @requires function pcntl_waitpid

Definition at line 126 of file SignalHandlerTest.php.

    {
        $this->setSignalHandler($signo, SIG_DFL);
 
        $path = tempnam(sys_get_temp_dir(), 'monolog-');
        $this->assertNotFalse($path);
 
        $pid = pcntl_fork();
        if ($pid === 0) {  // Child.
            $streamHandler = new StreamHandler($path);
            $streamHandler->setFormatter($this->getIdentityFormatter());
            $logger = new Logger('test', array($streamHandler));
            $errHandler = new SignalHandler($logger);
            $errHandler->registerSignalHandler($signo, LogLevel::INFO, $callPrevious, false, false);
            pcntl_sigprocmask(SIG_SETMASK, array(SIGCONT));
            posix_kill(posix_getpid(), $signo);
            pcntl_signal_dispatch();
            // If $callPrevious is true, SIGINT should terminate by this line.
            pcntl_sigprocmask(SIG_BLOCK, array(), $oldset);
            file_put_contents($path, implode(' ', $oldset), FILE_APPEND);
            posix_kill(posix_getpid(), $signo);
            pcntl_signal_dispatch();
            exit();
        }
 
        $this->assertNotSame(-1, $pid);
        $this->assertNotSame(-1, pcntl_waitpid($pid, $status));
        $this->assertNotSame(-1, $status);
        $this->assertSame($expected, file_get_contents($path));
    }

References $path, and exit.

testRegisterSignalHandler()

Monolog\SignalHandlerTest::testRegisterSignalHandler

(

)

@depends testHandleSignal @requires extension pcntl @requires extension posix @requires function pcntl_signal @requires function pcntl_signal_dispatch @requires function posix_getpid @requires function posix_kill

Definition at line 89 of file SignalHandlerTest.php.

    {
        // SIGCONT and SIGURG should be ignored by default.
        if (!defined('SIGCONT') || !defined('SIGURG')) {
            $this->markTestSkipped('This test requires the SIGCONT and SIGURG pcntl constants.');
        }
 
        $this->setSignalHandler(SIGCONT, SIG_IGN);
        $this->setSignalHandler(SIGURG, SIG_IGN);
 
        $logger = new Logger('test', array($handler = new TestHandler));
        $errHandler = new SignalHandler($logger);
        $pid = posix_getpid();
 
        $this->assertTrue(posix_kill($pid, SIGURG));
        $this->assertTrue(pcntl_signal_dispatch());
        $this->assertCount(0, $handler->getRecords());
 
        $errHandler->registerSignalHandler(SIGURG, LogLevel::INFO, false, false, false);
 
        $this->assertTrue(posix_kill($pid, SIGCONT));
        $this->assertTrue(pcntl_signal_dispatch());
        $this->assertCount(0, $handler->getRecords());
 
        $this->assertTrue(posix_kill($pid, SIGURG));
        $this->assertTrue(pcntl_signal_dispatch());
        $this->assertCount(1, $handler->getRecords());
        $this->assertTrue($handler->hasInfoThatContains('SIGURG'));
    }

References $handler.

testRegisterSyscallRestartingSignalHandler()

Monolog\SignalHandlerTest::testRegisterSyscallRestartingSignalHandler

(

$restartSyscalls

)

@dataProvider restartSyscallsProvider @depends testRegisterDefaultPreviousSignalHandler @requires function pcntl_fork @requires function pcntl_waitpid

Definition at line 208 of file SignalHandlerTest.php.

    {
        $this->setSignalHandler(SIGURG, SIG_IGN);
 
        $parentPid = posix_getpid();
        $microtime = microtime(true);
 
        $pid = pcntl_fork();
        if ($pid === 0) {  // Child.
            usleep(100000);
            posix_kill($parentPid, SIGURG);
            usleep(100000);
            exit();
        }
 
        $this->assertNotSame(-1, $pid);
        $logger = new Logger('test', array($handler = new TestHandler));
        $errHandler = new SignalHandler($logger);
        $errHandler->registerSignalHandler(SIGURG, LogLevel::INFO, false, $restartSyscalls, false);
        if ($restartSyscalls) {
            // pcntl_wait is expected to be restarted after the signal handler.
            $this->assertNotSame(-1, pcntl_waitpid($pid, $status));
        } else {
            // pcntl_wait is expected to be interrupted when the signal handler is invoked.
            $this->assertSame(-1, pcntl_waitpid($pid, $status));
        }
        $this->assertSame($restartSyscalls, microtime(true) - $microtime > 0.15);
        $this->assertTrue(pcntl_signal_dispatch());
        $this->assertCount(1, $handler->getRecords());
        if ($restartSyscalls) {
            // The child has already exited.
            $this->assertSame(-1, pcntl_waitpid($pid, $status));
        } else {
            // The child has not exited yet.
            $this->assertNotSame(-1, pcntl_waitpid($pid, $status));
        }
    }

References $handler, and exit.

Field Documentation

$asyncSignalHandling

Monolog\SignalHandlerTest::$asyncSignalHandling

private

Definition at line 25 of file SignalHandlerTest.php.

$blockedSignals

Monolog\SignalHandlerTest::$blockedSignals

private

Definition at line 26 of file SignalHandlerTest.php.

$signalHandlers

Monolog\SignalHandlerTest::$signalHandlers

private

Definition at line 27 of file SignalHandlerTest.php.

---

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

• libs/composer/vendor/monolog/monolog/tests/Monolog/SignalHandlerTest.php