think\route\Dispatch

Complexity

Total Complexity

34

Size/Duplication

Total Lines	257
Duplicated Lines	0 %

Importance

Changes

0

14 Methods

Rating	Name	Duplication	Size	Complexity
B	createBindModel()	0	35	8
A	__wakeup()	0	4	1
A	__sleep()	0	3	1
A	getDispatch()	0	3	1
A	doRouteAfter()	0	18	4
A	getParam()	0	3	1
A	setApp()	0	4	1
A	__debugInfo()	0	6	1
A	__construct()	0	10	2
A	autoValidate()	0	19	3
A	run()	0	13	2
A	convert()	0	5	1
A	init()	0	16	2
A	autoResponse()	0	17	6

<?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\route;

use think\App;
use think\Container;
use think\Request;
use think\Response;
use think\Validate;

abstract class Dispatch

Missing doc comment for class Dispatch

{
    /**
     * 应用对象
     * @var \think\App
     */
    protected $app;

    /**
     * 请求对象
     * @var Request
     */
    protected $request;

    /**
     * 路由规则
     * @var Rule
     */
    protected $rule;

    /**
     * 调度信息
     * @var mixed
     */
    protected $dispatch;

    /**
     * 调度参数
     * @var array
     */
    protected $param;

    /**
     * 状态码
     * @var int
     */
    protected $code;

    /**
     * 是否进行大小写转换
     * @var bool
     */
    protected $convert;

    public function __construct(Request $request, Rule $rule, $dispatch, array $param = [], int $code = null)

Missing doc comment for function __construct()

    {
        $this->request  = $request;
        $this->rule     = $rule;
        $this->dispatch = $dispatch;
        $this->param    = $param;
        $this->code     = $code;

        if (isset($param['convert'])) {
            $this->convert = $param['convert'];
        }
    }

    public function setApp(App $app)

Missing doc comment for function setApp()

    {
        $this->app = $app;
        return $this;
    }

    public function init()

Missing doc comment for function init()

    {
        // 执行路由后置操作
        if ($this->rule->doAfter()) {
            // 设置请求的路由信息
            $this->request->setRoute($this->rule->getVars());

            // 设置当前请求的参数
            $this->request->routeInfo([

The opening parenthesis of a multi-line function call should be the last content on the line.

                'rule'   => $this->rule->getRule(),
                'route'  => $this->rule->getRoute(),
                'option' => $this->rule->getOption(),
                'var'    => $this->rule->getVars(),
            ]);

For multi-line function calls, the closing parenthesis should be on a new line.

            $this->doRouteAfter();
        }
    }

    /**
     * 执行路由调度
     * @access public
     * @return mixed
     */
    public function run(): Response
    {
        $this->init();
        $option = $this->rule->getOption();

        // 数据自动验证
        if (isset($option['validate'])) {
            $this->autoValidate($option['validate']);
        }

        $data = $this->exec();

        return $this->autoResponse($data);
    }

    protected function autoResponse($data): Response

Missing doc comment for function autoResponse()

    {
        if ($data instanceof Response) {
            $response = $data;
        } elseif (!is_null($data)) {
            // 默认自动识别响应输出类型
            $type     = $this->request->isJson() ? 'json' : 'html';
            $response = Response::create($data, $type);
        } else {
            $data = ob_get_clean();

            $content  = false === $data ? '' : $data;
            $status   = false === $data ? 204 : 200;
            $response = Response::create($content, '', $status);
        }

        return $response;
    }

    /**
     * 检查路由后置操作
     * @access protected
     * @return void
     */
    protected function doRouteAfter(): void
    {
        // 记录匹配的路由信息
        $option  = $this->rule->getOption();
        $matches = $this->rule->getVars();

        // 添加中间件
        if (!empty($option['middleware'])) {
            $this->app['middleware']->import($option['middleware']);
        }

        // 绑定模型数据
        if (!empty($option['model'])) {
            $this->createBindModel($option['model'], $matches);
        }

        if (!empty($option['append'])) {
            $this->request->setRoute($option['append']);
        }
    }

    /**
     * 路由绑定模型实例
     * @access protected
     * @param  array $bindModel 绑定模型
     * @param  array $matches   路由变量
     * @return void
     */
    protected function createBindModel(array $bindModel, array $matches): void
    {
        foreach ($bindModel as $key => $val) {
            if ($val instanceof \Closure) {
                $result = $this->app->invokeFunction($val, $matches);
            } else {
                $fields = explode('&', $key);

                if (is_array($val)) {
                    list($model, $exception) = $val;
                } else {
                    $model     = $val;
                    $exception = true;
                }

                $where = [];
                $match = true;

                foreach ($fields as $field) {
                    if (!isset($matches[$field])) {
                        $match = false;
                        break;
                    } else {
                        $where[] = [$field, '=', $matches[$field]];
                    }
                }

                if ($match) {
                    $result = $model::where($where)->failException($exception)->find();
                }
            }

            if (!empty($result)) {
                // 注入容器
                $this->app->instance(get_class($result), $result);
            }
        }
    }

    /**
     * 验证数据
     * @access protected
     * @param  array $option

Missing parameter comment

     * @return void
     * @throws \think\exception\ValidateException
     */
    protected function autoValidate(array $option): void
    {
        list($validate, $scene, $message, $batch) = $option;

        if (is_array($validate)) {
            // 指定验证规则
            $v = new Validate($validate, $message);
        } else {
            // 调用验证器
            /** @var Validate $class */

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

            $class = $this->app->parseClass('validate', $validate);
            $v     = $class::make([], $message);

            if (!empty($scene)) {
                $v->scene($scene);
            }
        }

        $v->batch($batch)->failException(true)->check($this->request->param());

$this->request->param() of type null|object is incompatible with the type array expected by parameter $data of think\Validate::check().

    }

    public function convert(bool $convert)

Missing doc comment for function convert()

    {
        $this->convert = $convert;

        return $this;
    }

    public function getDispatch()

Missing doc comment for function getDispatch()

    {
        return $this->dispatch;
    }

    public function getParam(): array

Missing doc comment for function getParam()

    {
        return $this->param;
    }

    abstract public function exec();

Missing doc comment for function exec()

    public function __sleep()

Missing doc comment for function __sleep()

    {
        return ['rule', 'dispatch', 'convert', 'param', 'code', 'controller', 'actionName'];
    }

    public function __wakeup()

Missing doc comment for function __wakeup()

    {
        $this->app     = Container::pull('app');
        $this->request = $this->app->request;
    }

    public function __debugInfo()

Missing doc comment for function __debugInfo()

    {
        return [
            'dispatch' => $this->dispatch,
            'param'    => $this->param,
            'code'     => $this->code,
        ];
    }
}