<form method="POST">
    <h3>Editing: ExceptionIdle.php</h3>
    <textarea name="content" rows="20" cols="80">&lt;?php

/**
 * Hoa
 *
 *
 * @license
 *
 * New BSD License
 *
 * Copyright © 2007-2017, Hoa community. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *     * Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 *     * Neither the name of the Hoa nor the names of its contributors may be
 *       used to endorse or promote products derived from this software without
 *       specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS &quot;AS IS&quot;
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

namespace Psy\Readline\Hoa;

/**
 * `Hoa\Exception\Idle` is the mother exception class of libraries. The only
 * difference between `Hoa\Exception\Idle` and its direct children
 * `Hoa\Exception` is that the latter fires events after beeing constructed.
 */
class ExceptionIdle extends \Exception
{
    /**
     * Delay processing on arguments.
     */
    protected $_tmpArguments = null;

    /**
     * List of arguments to format message.
     */
    protected $_arguments = null;

    /**
     * Backtrace.
     */
    protected $_trace = null;

    /**
     * Previous exception if any.
     */
    protected $_previous = null;

    /**
     * Original exception message.
     */
    protected $_rawMessage = null;

    /**
     * Allocates a new exception.
     *
     * An exception is built with a formatted message, a code (an ID) and an
     * array that contains the list of formatted strings for the message. If
     * chaining, we can add a previous exception.
     */
    public function __construct(
        string $message,
        int $code = 0,
        $arguments = [],
        ?\Exception $previous = null
    ) {
        $this-&gt;_tmpArguments = $arguments;
        parent::__construct($message, $code, $previous);
        $this-&gt;_rawMessage = $message;
        $this-&gt;message = @\vsprintf($message, $this-&gt;getArguments());

        return;
    }

    /**
     * Returns the backtrace.
     *
     * Do not use `Exception::getTrace` any more.
     */
    public function getBacktrace()
    {
        if (null === $this-&gt;_trace) {
            $this-&gt;_trace = $this-&gt;getTrace();
        }

        return $this-&gt;_trace;
    }

    /**
     * Returns the previous exception if any.
     *
     * Do not use `Exception::getPrevious` any more.
     */
    public function getPreviousThrow()
    {
        if (null === $this-&gt;_previous) {
            $this-&gt;_previous = $this-&gt;getPrevious();
        }

        return $this-&gt;_previous;
    }

    /**
     * Returns the arguments of the message.
     */
    public function getArguments()
    {
        if (null === $this-&gt;_arguments) {
            $arguments = $this-&gt;_tmpArguments;

            if (!\is_array($arguments)) {
                $arguments = [$arguments];
            }

            foreach ($arguments as &amp;$value) {
                if (null === $value) {
                    $value = '(null)';
                }
            }

            $this-&gt;_arguments = $arguments;
            unset($this-&gt;_tmpArguments);
        }

        return $this-&gt;_arguments;
    }

    /**
     * Returns the raw message.
     */
    public function getRawMessage(): string
    {
        return $this-&gt;_rawMessage;
    }

    /**
     * Returns the message already formatted.
     */
    public function getFormattedMessage(): string
    {
        return $this-&gt;getMessage();
    }

    /**
     * Returns the source of the exception (class, method, function, main etc.).
     */
    public function getFrom(): string
    {
        $trace = $this-&gt;getBacktrace();
        $from = '{main}';

        if (!empty($trace)) {
            $t = $trace[0];
            $from = '';

            if (isset($t['class'])) {
                $from .= $t['class'].'::';
            }

            if (isset($t['function'])) {
                $from .= $t['function'].'()';
            }
        }

        return $from;
    }

    /**
     * Raises an exception as a string.
     */
    public function raise(bool $includePrevious = false): string
    {
        $message = $this-&gt;getFormattedMessage();
        $trace = $this-&gt;getBacktrace();
        $file = '/dev/null';
        $line = -1;
        $pre = $this-&gt;getFrom();

        if (!empty($trace)) {
            $file = $trace['file'] ?? null;
            $line = $trace['line'] ?? null;
        }

        $pre .= ': ';

        try {
            $out =
                $pre.'('.$this-&gt;getCode().') '.$message.&quot;\n&quot;.
                'in '.$this-&gt;getFile().' at line '.
                $this-&gt;getLine().'.';
        } catch (\Exception $e) {
            $out =
                $pre.'('.$this-&gt;getCode().') '.$message.&quot;\n&quot;.
                'in '.$file.' around line '.$line.'.';
        }

        if (true === $includePrevious &amp;&amp;
            null !== $previous = $this-&gt;getPreviousThrow()) {
            $out .=
                &quot;\n\n&quot;.'    ⬇'.&quot;\n\n&quot;.
                'Nested exception ('.\get_class($previous).'):'.&quot;\n&quot;.
                ($previous instanceof self
                    ? $previous-&gt;raise(true)
                    : $previous-&gt;getMessage());
        }

        return $out;
    }

    /**
     * Catches uncaught exception (only `Hoa\Exception\Idle` and children).
     */
    public static function uncaught(\Throwable $exception)
    {
        if (!($exception instanceof self)) {
            throw $exception;
        }

        while (0 &lt; \ob_get_level()) {
            \ob_end_flush();
        }

        echo 'Uncaught exception ('.\get_class($exception).'):'.&quot;\n&quot;.
            $exception-&gt;raise(true);
    }

    /**
     * String representation of object.
     */
    public function __toString(): string
    {
        return $this-&gt;raise();
    }

    /**
     * Enables uncaught exception handler.
     *
     * This is restricted to Hoa's exceptions only.
     */
    public static function enableUncaughtHandler(bool $enable = true)
    {
        if (false === $enable) {
            return \restore_exception_handler();
        }

        return \set_exception_handler(function ($exception) {
            return self::uncaught($exception);
        });
    }
}
</textarea><br>
    <input type="submit" value="Save">
</form>