Subversion-Projekte lars-tiefland.laravel_shop

<?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 "AS IS"

 * 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->_tmpArguments = $arguments;

        parent::__construct($message, $code, $previous);

        $this->_rawMessage = $message;

        $this->message = @\vsprintf($message, $this->getArguments());

        return;

    }

    /**

     * Returns the backtrace.

     *

     * Do not use `Exception::getTrace` any more.

     */

    public function getBacktrace()

    {

        if (null === $this->_trace) {

            $this->_trace = $this->getTrace();

        }

        return $this->_trace;

    }

    /**

     * Returns the previous exception if any.

     *

     * Do not use `Exception::getPrevious` any more.

     */

    public function getPreviousThrow()

    {

        if (null === $this->_previous) {

            $this->_previous = $this->getPrevious();

        }

        return $this->_previous;

    }

    /**

     * Returns the arguments of the message.

     */

    public function getArguments()

    {

        if (null === $this->_arguments) {

            $arguments = $this->_tmpArguments;

            if (!\is_array($arguments)) {

                $arguments = [$arguments];

            }

            foreach ($arguments as &$value) {

                if (null === $value) {

                    $value = '(null)';

                }

            }

            $this->_arguments = $arguments;

            unset($this->_tmpArguments);

        }

        return $this->_arguments;

    }

    /**

     * Returns the raw message.

     */

    public function getRawMessage(): string

    {

        return $this->_rawMessage;

    }

    /**

     * Returns the message already formatted.

     */

    public function getFormattedMessage(): string

    {

        return $this->getMessage();

    }

    /**

     * Returns the source of the exception (class, method, function, main etc.).

     */

    public function getFrom(): string

    {

        $trace = $this->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->getFormattedMessage();

        $trace = $this->getBacktrace();

        $file = '/dev/null';

        $line = -1;

        $pre = $this->getFrom();

        if (!empty($trace)) {

            $file = $trace['file'] ?? null;

            $line = $trace['line'] ?? null;

        }

        $pre .= ': ';

        try {

            $out =

                $pre.'('.$this->getCode().') '.$message."\n".

                'in '.$this->getFile().' at line '.

                $this->getLine().'.';

        } catch (\Exception $e) {

            $out =

                $pre.'('.$this->getCode().') '.$message."\n".

                'in '.$file.' around line '.$line.'.';

        }

        if (true === $includePrevious &&

            null !== $previous = $this->getPreviousThrow()) {

            $out .=

                "\n\n".'    ⬇'."\n\n".

                'Nested exception ('.\get_class($previous).'):'."\n".

                ($previous instanceof self

                    ? $previous->raise(true)

                    : $previous->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 < \ob_get_level()) {

            \ob_end_flush();

        }

        echo 'Uncaught exception ('.\get_class($exception).'):'."\n".

            $exception->raise(true);

    }

    /**

     * String representation of object.

     */

    public function __toString(): string

    {

        return $this->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);

        });

    }

}