think\Db

Complexity

Total Complexity

27

Size/Duplication

Total Lines	255
Duplicated Lines	0 %

Test Coverage

Coverage

0%

Importance

Changes

0

16 Methods

Rating	Name	Duplication	Size	Complexity
A	isReadMaster()	0	3	2
A	connect()	0	4	1
A	__make()	0	8	1
A	updateQueryTimes()	0	3	1
A	getQueryTimes()	0	3	1
A	__call()	0	5	1
A	instance()	0	20	6
A	getConfig()	0	3	2
A	buildQuery()	0	3	1
A	readMaster()	0	5	1
A	event()	0	3	1
A	raw()	0	3	1
A	trigger()	0	3	1
A	parseConfig()	0	10	3
A	newQuery()	0	8	2
A	__construct()	0	9	2

<?php
// +----------------------------------------------------------------------

You must use "/**" style comments for a file comment

// | 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: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------
declare (strict_types = 1);

namespace think;

use InvalidArgumentException;
use think\db\Connection;
use think\db\Query;
use think\db\Raw;

class Db

Missing doc comment for class Db

{
    /**
     * 当前数据库连接对象
     * @var Connection
     */
    protected $connection;

    /**
     * 数据库连接实例
     * @var array
     */
    protected $instance = [];

    /**
     * 配置对象
     * @var Config
     */
    protected $config;

    /**
     * Event对象
     * @var Event
     */
    protected $event;

    /**
     * 数据库配置
     * @var array
     */
    protected $option = [];

    /**
     * 读取主库
     * @var array
     */
    protected $readMaster = [];

    /**
     * 查询次数
     * @var int
     */
    protected $queryTimes = 0;

    /**
     * 架构函数
     * @param array $config 连接配置

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @access public
     */
    public function __construct(array $config = [])
    {
        if (empty($config['query'])) {
            $config['query'] = Query::class;
        }

        $this->option = $config;

        $this->connect($config);
    }

    public static function __make(Event $event, Config $config)

Missing doc comment for function __make()

Method name "Db::__make" is invalid; only PHP magic methods should be prefixed with a double underscore

Public method name "Db::__make" must not be prefixed with an underscore

    {
        $db = new static($config->get('database'));

It seems like $config->get('database') can also be of type null; however, parameter $config of think\Db::__construct() does only seem to accept array, maybe add an additional type check?

        $db->event  = $event;
        $db->config = $config;

        return $db;
    }

    /**
     * 切换数据库连接
     * @access public
     * @param mixed       $config 连接配置

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @param bool|string $name   连接标识 true 强制重新连接

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return $this
     */
    public function connect($config = [], $name = false)
    {
        $this->connection = $this->instance($this->parseConfig($config), $name);
        return $this;
    }

    /**
     * 取得数据库连接类实例
     * @access public
     * @param array       $config 连接配置

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @param bool|string $name   连接标识 true 强制重新连接

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return Connection
     */
    public function instance(array $config = [], $name = false)
    {
        if (false === $name) {
            $name = md5(serialize($config));
        }

        if (true === $name || !isset($this->instance[$name])) {

            if (empty($config['type'])) {
                throw new InvalidArgumentException('Undefined db type');
            }

            if (true === $name) {
                $name = md5(serialize($config));
            }

            $this->instance[$name] = App::factory($config['type'], '\\think\\db\\connector\\', $config);
        }

        return $this->instance[$name];
    }

    /**
     * 设置从主库读取数据
     * @access public
     * @param string $table 数据表

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return $this
     */
    public function readMaster(string $table = '*')
    {
        $this->readMaster[$table] = true;

        return $this;
    }

    /**
     * 是否从主库读取数据
     * @access public
     * @param string $table 数据表

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return bool
     */
    public function isReadMaster(string $table): bool
    {
        return isset($this->readMaster['*']) || isset($this->readMaster[$table]);
    }

    /**
     * 使用表达式设置数据
     * @access public
     * @param string $value 表达式

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return Raw
     */
    public function raw(string $value): Raw
    {
        return new Raw($value);
    }

    /**
     * 更新查询次数
     * @access public
     * @return void
     */
    public function updateQueryTimes(): void
    {
        $this->queryTimes++;
    }

    /**
     * 获得查询次数
     * @access public
     * @return integer
     */
    public function getQueryTimes(): int
    {
        return $this->queryTimes;
    }

    /**
     * 数据库连接参数解析
     * @access private
     * @param mixed $config

Missing parameter comment

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return array
     */
    private function parseConfig($config): array

Private method name "Db::parseConfig" must be prefixed with an underscore

    {
        if (empty($config)) {
            $config = $this->option;
        } elseif (is_string($config)) {
            // 支持读取配置参数
            $config = $this->option[$config] ?? null;
        }

        return $config;
    }

    /**
     * 获取数据库的配置参数
     * @access public
     * @param string $name 参数名称

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return mixed
     */
    public function getConfig(string $name = '')
    {
        return $name ? ($this->option[$name] ?? null) : $this->option;
    }

    /**
     * 创建一个新的查询对象
     * @access public
     * @param string       $query      查询对象类名

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @param string|array $connection 连接配置信息

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return mixed
     */
    public function buildQuery(string $query, $connection = [])
    {
        return $this->connect($connection)->newQuery($query);
    }

    /**
     * 注册回调方法
     * @access public
     * @param string   $event    事件名

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @param callable $callback 回调方法

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return void
     */
    public function event(string $event, callable $callback): void
    {
        $this->event->listen('db.' . $event, $callback);
    }

    /**
     * 触发事件
     * @access public
     * @param string $event  事件名

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @param mixed  $params 传入参数

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @param bool   $once

Missing parameter comment

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return mixed
     */
    public function trigger(string $event, $params = null, bool $once = false)
    {
        return $this->event->trigger('db.' . $event, $params, $once);
    }

    /**
     * 创建一个新的查询对象
     * @access protected
     * @param string     $class      查询对象类名

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @param Connection $connection 连接对象

Tag value for @param tag indented incorrectly; expected 2 spaces but found 1

     * @return mixed
     */
    protected function newQuery(string $class, $connection = null)
    {
        /** @var Query $query */

The open comment tag must be the only content on the line

Missing short description in doc comment

The close comment tag must be the only content on the line

        $query = new $class($connection ?: $this->connection);

        $query->setDb($this);

        return $query;
    }

    public function __call($method, $args)

Missing doc comment for function __call()

    {
        $query = $this->newQuery($this->option['query'], $this->connection);

        return call_user_func_array([$query, $method], $args);
    }
}