* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Debug\Tests; use PHPUnit\Framework\TestCase; use Psr\Log\LoggerInterface; use Psr\Log\LogLevel; use Psr\Log\NullLogger; use Symfony\Component\Debug\BufferingLogger; use Symfony\Component\Debug\ErrorHandler; use Symfony\Component\Debug\Exception\SilencedErrorContext; use Symfony\Component\Debug\Tests\Fixtures\LoggerThatSetAnErrorHandler; /** * ErrorHandlerTest. * * @author Robert Schönthal * @author Nicolas Grekas */ class ErrorHandlerTest extends TestCase { public function testRegister() { $handler = ErrorHandler::register(); try { $this->assertInstanceOf('Symfony\Component\Debug\ErrorHandler', $handler); $this->assertSame($handler, ErrorHandler::register()); $newHandler = new ErrorHandler(); $this->assertSame($handler, ErrorHandler::register($newHandler, false)); $h = set_error_handler('var_dump'); restore_error_handler(); $this->assertSame([$handler, 'handleError'], $h); try { $this->assertSame($newHandler, ErrorHandler::register($newHandler, true)); $h = set_error_handler('var_dump'); restore_error_handler(); $this->assertSame([$newHandler, 'handleError'], $h); } catch (\Exception $e) { } restore_error_handler(); restore_exception_handler(); if (isset($e)) { throw $e; } } catch (\Exception $e) { } restore_error_handler(); restore_exception_handler(); if (isset($e)) { throw $e; } } public function testErrorGetLast() { $handler = ErrorHandler::register(); $logger = $this->getMockBuilder('Psr\Log\LoggerInterface')->getMock(); $handler->setDefaultLogger($logger); $handler->screamAt(E_ALL); try { @trigger_error('Hello', E_USER_WARNING); $expected = [ 'type' => E_USER_WARNING, 'message' => 'Hello', 'file' => __FILE__, 'line' => __LINE__ - 5, ]; $this->assertSame($expected, error_get_last()); } catch (\Exception $e) { restore_error_handler(); restore_exception_handler(); throw $e; } } public function testNotice() { ErrorHandler::register(); try { self::triggerNotice($this); $this->fail('ErrorException expected'); } catch (\ErrorException $exception) { // if an exception is thrown, the test passed $this->assertEquals(E_NOTICE, $exception->getSeverity()); $this->assertEquals(__FILE__, $exception->getFile()); $this->assertRegExp('/^Notice: Undefined variable: (foo|bar)/', $exception->getMessage()); $trace = $exception->getTrace(); $this->assertEquals(__FILE__, $trace[0]['file']); $this->assertEquals(__CLASS__, $trace[0]['class']); $this->assertEquals('triggerNotice', $trace[0]['function']); $this->assertEquals('::', $trace[0]['type']); $this->assertEquals(__FILE__, $trace[0]['file']); $this->assertEquals(__CLASS__, $trace[1]['class']); $this->assertEquals(__FUNCTION__, $trace[1]['function']); $this->assertEquals('->', $trace[1]['type']); } finally { restore_error_handler(); restore_exception_handler(); } } // dummy function to test trace in error handler. private static function triggerNotice($that) { $that->assertSame('', $foo.$foo.$bar); } public function testConstruct() { try { $handler = ErrorHandler::register(); $handler->throwAt(3, true); $this->assertEquals(3 | E_RECOVERABLE_ERROR | E_USER_ERROR, $handler->throwAt(0)); } finally { restore_error_handler(); restore_exception_handler(); } } public function testDefaultLogger() { try { $handler = ErrorHandler::register(); $logger = $this->getMockBuilder('Psr\Log\LoggerInterface')->getMock(); $handler->setDefaultLogger($logger, E_NOTICE); $handler->setDefaultLogger($logger, [E_USER_NOTICE => LogLevel::CRITICAL]); $loggers = [ E_DEPRECATED => [null, LogLevel::INFO], E_USER_DEPRECATED => [null, LogLevel::INFO], E_NOTICE => [$logger, LogLevel::WARNING], E_USER_NOTICE => [$logger, LogLevel::CRITICAL], E_STRICT => [null, LogLevel::WARNING], E_WARNING => [null, LogLevel::WARNING], E_USER_WARNING => [null, LogLevel::WARNING], E_COMPILE_WARNING => [null, LogLevel::WARNING], E_CORE_WARNING => [null, LogLevel::WARNING], E_USER_ERROR => [null, LogLevel::CRITICAL], E_RECOVERABLE_ERROR => [null, LogLevel::CRITICAL], E_COMPILE_ERROR => [null, LogLevel::CRITICAL], E_PARSE => [null, LogLevel::CRITICAL], E_ERROR => [null, LogLevel::CRITICAL], E_CORE_ERROR => [null, LogLevel::CRITICAL], ]; $this->assertSame($loggers, $handler->setLoggers([])); } finally { restore_error_handler(); restore_exception_handler(); } } public function testHandleError() { try { $handler = ErrorHandler::register(); $handler->throwAt(0, true); $this->assertFalse($handler->handleError(0, 'foo', 'foo.php', 12, [])); restore_error_handler(); restore_exception_handler(); $handler = ErrorHandler::register(); $handler->throwAt(3, true); $this->assertFalse($handler->handleError(4, 'foo', 'foo.php', 12, [])); restore_error_handler(); restore_exception_handler(); $handler = ErrorHandler::register(); $handler->throwAt(3, true); try { $handler->handleError(4, 'foo', 'foo.php', 12, []); } catch (\ErrorException $e) { $this->assertSame('Parse Error: foo', $e->getMessage()); $this->assertSame(4, $e->getSeverity()); $this->assertSame('foo.php', $e->getFile()); $this->assertSame(12, $e->getLine()); } restore_error_handler(); restore_exception_handler(); $handler = ErrorHandler::register(); $handler->throwAt(E_USER_DEPRECATED, true); $this->assertFalse($handler->handleError(E_USER_DEPRECATED, 'foo', 'foo.php', 12, [])); restore_error_handler(); restore_exception_handler(); $handler = ErrorHandler::register(); $handler->throwAt(E_DEPRECATED, true); $this->assertFalse($handler->handleError(E_DEPRECATED, 'foo', 'foo.php', 12, [])); restore_error_handler(); restore_exception_handler(); $logger = $this->getMockBuilder('Psr\Log\LoggerInterface')->getMock(); $warnArgCheck = function ($logLevel, $message, $context) { $this->assertEquals('info', $logLevel); $this->assertEquals('User Deprecated: foo', $message); $this->assertArrayHasKey('exception', $context); $exception = $context['exception']; $this->assertInstanceOf(\ErrorException::class, $exception); $this->assertSame('User Deprecated: foo', $exception->getMessage()); $this->assertSame(E_USER_DEPRECATED, $exception->getSeverity()); }; $logger ->expects($this->once()) ->method('log') ->will($this->returnCallback($warnArgCheck)) ; $handler = ErrorHandler::register(); $handler->setDefaultLogger($logger, E_USER_DEPRECATED); $this->assertTrue($handler->handleError(E_USER_DEPRECATED, 'foo', 'foo.php', 12, [])); restore_error_handler(); restore_exception_handler(); $logger = $this->getMockBuilder('Psr\Log\LoggerInterface')->getMock(); $line = null; $logArgCheck = function ($level, $message, $context) use (&$line) { $this->assertEquals('Notice: Undefined variable: undefVar', $message); $this->assertArrayHasKey('exception', $context); $exception = $context['exception']; $this->assertInstanceOf(SilencedErrorContext::class, $exception); $this->assertSame(E_NOTICE, $exception->getSeverity()); $this->assertSame(__FILE__, $exception->getFile()); $this->assertSame($line, $exception->getLine()); $this->assertNotEmpty($exception->getTrace()); $this->assertSame(1, $exception->count); }; $logger ->expects($this->once()) ->method('log') ->will($this->returnCallback($logArgCheck)) ; $handler = ErrorHandler::register(); $handler->setDefaultLogger($logger, E_NOTICE); $handler->screamAt(E_NOTICE); unset($undefVar); $line = __LINE__ + 1; @$undefVar++; restore_error_handler(); restore_exception_handler(); } catch (\Exception $e) { restore_error_handler(); restore_exception_handler(); throw $e; } } public function testHandleUserError() { try { $handler = ErrorHandler::register(); $handler->throwAt(0, true); $e = null; $x = new \Exception('Foo'); try { $f = new Fixtures\ToStringThrower($x); $f .= ''; // Trigger $f->__toString() } catch (\Exception $e) { } $this->assertSame($x, $e); } finally { restore_error_handler(); restore_exception_handler(); } } public function testHandleDeprecation() { $logArgCheck = function ($level, $message, $context) { $this->assertEquals(LogLevel::INFO, $level); $this->assertArrayHasKey('exception', $context); $exception = $context['exception']; $this->assertInstanceOf(\ErrorException::class, $exception); $this->assertSame('User Deprecated: Foo deprecation', $exception->getMessage()); }; $logger = $this->getMockBuilder('Psr\Log\LoggerInterface')->getMock(); $logger ->expects($this->once()) ->method('log') ->will($this->returnCallback($logArgCheck)) ; $handler = new ErrorHandler(); $handler->setDefaultLogger($logger); @$handler->handleError(E_USER_DEPRECATED, 'Foo deprecation', __FILE__, __LINE__, []); restore_error_handler(); } public function testHandleException() { try { $handler = ErrorHandler::register(); $exception = new \Exception('foo'); $logger = $this->getMockBuilder('Psr\Log\LoggerInterface')->getMock(); $logArgCheck = function ($level, $message, $context) { $this->assertSame('Uncaught Exception: foo', $message); $this->assertArrayHasKey('exception', $context); $this->assertInstanceOf(\Exception::class, $context['exception']); }; $logger ->expects($this->exactly(2)) ->method('log') ->will($this->returnCallback($logArgCheck)) ; $handler->setDefaultLogger($logger, E_ERROR); try { $handler->handleException($exception); $this->fail('Exception expected'); } catch (\Exception $e) { $this->assertSame($exception, $e); } $handler->setExceptionHandler(function ($e) use ($exception) { $this->assertSame($exception, $e); }); $handler->handleException($exception); } finally { restore_error_handler(); restore_exception_handler(); } } public function testBootstrappingLogger() { $bootLogger = new BufferingLogger(); $handler = new ErrorHandler($bootLogger); $loggers = [ E_DEPRECATED => [$bootLogger, LogLevel::INFO], E_USER_DEPRECATED => [$bootLogger, LogLevel::INFO], E_NOTICE => [$bootLogger, LogLevel::WARNING], E_USER_NOTICE => [$bootLogger, LogLevel::WARNING], E_STRICT => [$bootLogger, LogLevel::WARNING], E_WARNING => [$bootLogger, LogLevel::WARNING], E_USER_WARNING => [$bootLogger, LogLevel::WARNING], E_COMPILE_WARNING => [$bootLogger, LogLevel::WARNING], E_CORE_WARNING => [$bootLogger, LogLevel::WARNING], E_USER_ERROR => [$bootLogger, LogLevel::CRITICAL], E_RECOVERABLE_ERROR => [$bootLogger, LogLevel::CRITICAL], E_COMPILE_ERROR => [$bootLogger, LogLevel::CRITICAL], E_PARSE => [$bootLogger, LogLevel::CRITICAL], E_ERROR => [$bootLogger, LogLevel::CRITICAL], E_CORE_ERROR => [$bootLogger, LogLevel::CRITICAL], ]; $this->assertSame($loggers, $handler->setLoggers([])); $handler->handleError(E_DEPRECATED, 'Foo message', __FILE__, 123, []); $logs = $bootLogger->cleanLogs(); $this->assertCount(1, $logs); $log = $logs[0]; $this->assertSame('info', $log[0]); $this->assertSame('Deprecated: Foo message', $log[1]); $this->assertArrayHasKey('exception', $log[2]); $exception = $log[2]['exception']; $this->assertInstanceOf(\ErrorException::class, $exception); $this->assertSame('Deprecated: Foo message', $exception->getMessage()); $this->assertSame(__FILE__, $exception->getFile()); $this->assertSame(123, $exception->getLine()); $this->assertSame(E_DEPRECATED, $exception->getSeverity()); $bootLogger->log(LogLevel::WARNING, 'Foo message', ['exception' => $exception]); $mockLogger = $this->getMockBuilder('Psr\Log\LoggerInterface')->getMock(); $mockLogger->expects($this->once()) ->method('log') ->with(LogLevel::WARNING, 'Foo message', ['exception' => $exception]); $handler->setLoggers([E_DEPRECATED => [$mockLogger, LogLevel::WARNING]]); } public function testSettingLoggerWhenExceptionIsBuffered() { $bootLogger = new BufferingLogger(); $handler = new ErrorHandler($bootLogger); $exception = new \Exception('Foo message'); $mockLogger = $this->getMockBuilder('Psr\Log\LoggerInterface')->getMock(); $mockLogger->expects($this->once()) ->method('log') ->with(LogLevel::CRITICAL, 'Uncaught Exception: Foo message', ['exception' => $exception]); $handler->setExceptionHandler(function () use ($handler, $mockLogger) { $handler->setDefaultLogger($mockLogger); }); $handler->handleException($exception); } public function testHandleFatalError() { try { $handler = ErrorHandler::register(); $error = [ 'type' => E_PARSE, 'message' => 'foo', 'file' => 'bar', 'line' => 123, ]; $logger = $this->getMockBuilder('Psr\Log\LoggerInterface')->getMock(); $logArgCheck = function ($level, $message, $context) { $this->assertEquals('Fatal Parse Error: foo', $message); $this->assertArrayHasKey('exception', $context); $this->assertInstanceOf(\Exception::class, $context['exception']); }; $logger ->expects($this->once()) ->method('log') ->will($this->returnCallback($logArgCheck)) ; $handler->setDefaultLogger($logger, E_PARSE); $handler->handleFatalError($error); restore_error_handler(); restore_exception_handler(); } catch (\Exception $e) { restore_error_handler(); restore_exception_handler(); throw $e; } } public function testHandleErrorException() { $exception = new \Error("Class 'Foo' not found"); $handler = new ErrorHandler(); $handler->setExceptionHandler(function () use (&$args) { $args = \func_get_args(); }); $handler->handleException($exception); $this->assertInstanceOf('Symfony\Component\Debug\Exception\ClassNotFoundException', $args[0]); $this->assertStringStartsWith("Attempted to load class \"Foo\" from the global namespace.\nDid you forget a \"use\" statement", $args[0]->getMessage()); } /** * @expectedException \Exception */ public function testCustomExceptionHandler() { $handler = new ErrorHandler(); $handler->setExceptionHandler(function ($e) use ($handler) { $handler->handleException($e); }); $handler->handleException(new \Exception()); } /** * @dataProvider errorHandlerIsNotLostWhenLoggingProvider */ public function testErrorHandlerIsNotLostWhenLogging($customErrorHandlerHasBeenPreviouslyDefined, LoggerInterface $logger) { try { if ($customErrorHandlerHasBeenPreviouslyDefined) { set_error_handler('count'); } $handler = ErrorHandler::register(); $handler->setDefaultLogger($logger); @trigger_error('foo', E_USER_DEPRECATED); @trigger_error('bar', E_USER_DEPRECATED); $this->assertSame([$handler, 'handleError'], set_error_handler('var_dump')); restore_error_handler(); if ($customErrorHandlerHasBeenPreviouslyDefined) { restore_error_handler(); } } finally { restore_error_handler(); restore_exception_handler(); } } public function errorHandlerIsNotLostWhenLoggingProvider() { return [ [false, new NullLogger()], [true, new NullLogger()], [false, new LoggerThatSetAnErrorHandler()], [true, new LoggerThatSetAnErrorHandler()], ]; } }