<?php

declare(strict_types=1);

namespace SimpleSAML\Error;

use SimpleSAML\Logger;

use function is_null;

/**
 * SimpleSAMLphp's custom error handler that logs full backtraces on errors and warnings
 *
 * @package SimpleSAMLphp
 */
class ErrorHandler
{
    /**
     * @param int $errno
     * @param string $errstr
     * @param string|null $errfile
     * @param int $errline
     * @param string|null $errcontext
     * @return false
     * @throws \Exception
     */
    public function customErrorHandler(
        int $errno,
        string $errstr,
        ?string $errfile = null,
        int $errline = 0,
    ): false {
        if (Logger::isErrorMasked($errno)) {
            // masked error
            return false;
        }

        static $limit = 5;
        $limit -= 1;
        if ($limit < 0) {
            // we have reached the limit in the number of backtraces we will log
            return false;
        }

        $levels = [
            E_DEPRECATED => 'Deprecated',
            E_USER_DEPRECATED => 'User Deprecated',
            E_NOTICE => 'Notice',
            E_USER_NOTICE => 'User Notice',
            // E_STRICT (2048) has become deprecated in PHP 8.4
            2048 => 'Runtime Notice',
            E_WARNING => 'Warning',
            E_USER_WARNING => 'User Warning',
            E_COMPILE_WARNING => 'Compile Warning',
            E_CORE_WARNING => 'Core Warning',
            E_USER_ERROR => 'User Error',
            E_RECOVERABLE_ERROR => 'Catchable Fatal Error',
            E_COMPILE_ERROR => 'Compile Error',
            E_PARSE => 'Parse Error',
            E_ERROR => 'Error',
            E_CORE_ERROR => 'Core Error',
        ];

        // show an error with a full backtrace
        $context = (is_null($errfile) ? '' : " at $errfile:$errline");
        $e = new Exception($levels[$errno] . ' - ' . $errstr . $context);
        $e->logError();

        // resume normal error processing
        return false;
    }
}