<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2019 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: 麦当苗儿 <zuojiazi@vip.qq.com> <http://zjzit.cn>
// +----------------------------------------------------------------------
declare (strict_types = 1);

namespace think\db\exception;

use Exception;

/**
 * Database相关异常处理类
 */
if (class_exists('think\Exception')) {
    class DbException extends \think\Exception
    {
        /**
         * DbException constructor.
         * @access public
         * @param  string    $message
         * @param  array     $config
         * @param  string    $sql
         * @param  int       $code
         */
        public function __construct(string $message, array $config = [], string $sql = '', int $code = 10500)
        {
            $this->message = $message;
            $this->code    = $code;

            $this->setData('Database Status', [
                'Error Code'    => $code,
                'Error Message' => $message,
                'Error SQL'     => $sql,
            ]);

            unset($config['username'], $config['password']);
            $this->setData('Database Config', $config);
        }
    }
} else {

    class DbException extends Exception
    {
        /**
         * DbException constructor.
         * @access public
         * @param  string    $message
         * @param  array     $config
         * @param  string    $sql
         * @param  int       $code
         */
        public function __construct(string $message, array $config = [], string $sql = '', int $code = 10500)
        {
            $this->message = $message;
            $this->code    = $code;

            $this->setData('Database Status', [
                'Error Code'    => $code,
                'Error Message' => $message,
                'Error SQL'     => $sql,
            ]);

            unset($config['username'], $config['password']);
            $this->setData('Database Config', $config);
        }

        /**
         * 保存异常页面显示的额外Debug数据
         * @var array
         */
        protected $data = [];

        /**
         * 设置异常额外的Debug数据
         * 数据将会显示为下面的格式
         *
         * Exception Data
         * --------------------------------------------------
         * Label 1
         *   key1      value1
         *   key2      value2
         * Label 2
         *   key1      value1
         *   key2      value2
         *
         * @param string $label 数据分类，用于异常页面显示
         * @param array  $data  需要显示的数据，必须为关联数组
         */
        final protected function setData($label, array $data)
        {
            $this->data[$label] = $data;
        }

        /**
         * 获取异常额外Debug数据
         * 主要用于输出到异常页面便于调试
         * @return array 由setData设置的Debug数据
         */
        final public function getData()
        {
            return $this->data;
        }
    }
}
