* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Monolog\Handler; use Monolog\Level; use PHPUnit\Framework\Attributes\DataProvider; class ProcessHandlerTest extends \Monolog\Test\MonologTestCase { /** * Dummy command to be used by tests that should not fail due to the command. * * @var string */ const DUMMY_COMMAND = 'php -r "echo fgets(STDIN);"'; /** * @covers Monolog\Handler\ProcessHandler::__construct * @covers Monolog\Handler\ProcessHandler::guardAgainstInvalidCommand * @covers Monolog\Handler\ProcessHandler::guardAgainstInvalidCwd * @covers Monolog\Handler\ProcessHandler::write * @covers Monolog\Handler\ProcessHandler::ensureProcessIsStarted * @covers Monolog\Handler\ProcessHandler::startProcess * @covers Monolog\Handler\ProcessHandler::handleStartupErrors */ public function testWriteOpensProcessAndWritesToStdInOfProcess() { $fixtures = [ 'chuck norris', 'foobar1337', ]; $mockBuilder = $this->getMockBuilder('Monolog\Handler\ProcessHandler'); $mockBuilder->onlyMethods(['writeProcessInput']); $mockBuilder->setConstructorArgs([self::DUMMY_COMMAND]); $handler = $mockBuilder->getMock(); $matcher = $this->exactly(2); $handler->expects($matcher) ->method('writeProcessInput') ->willReturnCallback(function () use ($matcher, $fixtures) { match ($matcher->numberOfInvocations()) { 1 => $this->stringContains($fixtures[0]), 2 => $this->stringContains($fixtures[1]), }; }) ; /** @var ProcessHandler $handler */ $handler->handle($this->getRecord(Level::Warning, $fixtures[0])); $handler->handle($this->getRecord(Level::Error, $fixtures[1])); } /** * Data provider for invalid commands. */ public static function invalidCommandProvider(): array { return [ [1337, 'TypeError'], ['', 'InvalidArgumentException'], [null, 'TypeError'], [fopen('php://input', 'r'), 'TypeError'], ]; } /** * @covers Monolog\Handler\ProcessHandler::guardAgainstInvalidCommand */ #[DataProvider('invalidCommandProvider')] public function testConstructWithInvalidCommandThrowsInvalidArgumentException(mixed $invalidCommand, string $expectedExcep) { $this->expectException($expectedExcep); new ProcessHandler($invalidCommand, Level::Debug); } /** * Data provider for invalid CWDs. */ public static function invalidCwdProvider(): array { return [ [1337, 'TypeError'], ['', 'InvalidArgumentException'], [fopen('php://input', 'r'), 'TypeError'], ]; } /** * @param mixed $invalidCwd * @covers Monolog\Handler\ProcessHandler::guardAgainstInvalidCwd */ #[DataProvider('invalidCwdProvider')] public function testConstructWithInvalidCwdThrowsInvalidArgumentException($invalidCwd, $expectedExcep) { $this->expectException($expectedExcep); new ProcessHandler(self::DUMMY_COMMAND, Level::Debug, true, $invalidCwd); } /** * @covers Monolog\Handler\ProcessHandler::__construct * @covers Monolog\Handler\ProcessHandler::guardAgainstInvalidCwd */ public function testConstructWithValidCwdWorks() { $handler = new ProcessHandler(self::DUMMY_COMMAND, Level::Debug, true, sys_get_temp_dir()); $this->assertInstanceOf( 'Monolog\Handler\ProcessHandler', $handler, 'Constructed handler is not a ProcessHandler.' ); } /** * @covers Monolog\Handler\ProcessHandler::handleStartupErrors */ public function testStartupWithFailingToSelectErrorStreamThrowsUnexpectedValueException() { $mockBuilder = $this->getMockBuilder('Monolog\Handler\ProcessHandler'); $mockBuilder->onlyMethods(['selectErrorStream']); $mockBuilder->setConstructorArgs([self::DUMMY_COMMAND]); $handler = $mockBuilder->getMock(); $handler->expects($this->once()) ->method('selectErrorStream') ->willReturn(false); $this->expectException(\UnexpectedValueException::class); /** @var ProcessHandler $handler */ $handler->handle($this->getRecord(Level::Warning, 'stream failing, whoops')); } /** * @covers Monolog\Handler\ProcessHandler::handleStartupErrors * @covers Monolog\Handler\ProcessHandler::selectErrorStream */ public function testStartupWithErrorsThrowsUnexpectedValueException() { $handler = new ProcessHandler('>&2 echo "some fake error message"'); $this->expectException(\UnexpectedValueException::class); $handler->handle($this->getRecord(Level::Warning, 'some warning in the house')); } /** * @covers Monolog\Handler\ProcessHandler::write */ public function testWritingWithErrorsOnStdOutOfProcessThrowsInvalidArgumentException() { $mockBuilder = $this->getMockBuilder('Monolog\Handler\ProcessHandler'); $mockBuilder->onlyMethods(['readProcessErrors']); $mockBuilder->setConstructorArgs([self::DUMMY_COMMAND]); $handler = $mockBuilder->getMock(); $handler->expects($this->exactly(2)) ->method('readProcessErrors') ->willReturnOnConsecutiveCalls('', 'some fake error message here'); $this->expectException(\UnexpectedValueException::class); /** @var ProcessHandler $handler */ $handler->handle($this->getRecord(Level::Warning, 'some test stuff')); } /** * @covers Monolog\Handler\ProcessHandler::close */ public function testCloseClosesProcess() { $class = new \ReflectionClass('Monolog\Handler\ProcessHandler'); $property = $class->getProperty('process'); $handler = new ProcessHandler(self::DUMMY_COMMAND); $handler->handle($this->getRecord(Level::Warning, '21 is only the half truth')); $process = $property->getValue($handler); $this->assertTrue(\is_resource($process), 'Process is not running although it should.'); $handler->close(); $process = $property->getValue($handler); $this->assertFalse(\is_resource($process), 'Process is still running although it should not.'); } }