think\App

Complexity

Total Complexity

66

Size/Duplication

Total Lines	578
Duplicated Lines	0 %

Test Coverage

Coverage

94.59%

Importance

Changes

0

34 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	11	2
A	runningInConsole()	0	3	2
A	debug()	0	4	1
A	parseName()	0	10	3
A	initialized()	0	3	1
A	getBeginMem()	0	3	1
A	getConfigExt()	0	3	1
A	setRuntimePath()	0	3	1
A	getAppPath()	0	3	1
A	initialize()	0	35	4
A	bootService()	0	4	2
A	boot()	0	4	1
A	parseClass()	0	8	2
A	load()	0	28	6
A	isDebug()	0	3	1
A	getNamespace()	0	3	1
A	getRuntimePath()	0	3	1
A	getConfigPath()	0	3	1
A	getThinkPath()	0	3	1
A	loadEvent()	0	12	4
A	getBasePath()	0	3	1
A	setAppPath()	0	3	1
A	getDefaultRootPath()	0	5	1
A	getBeginTime()	0	3	1
A	version()	0	3	1
A	getRootPath()	0	3	1
B	debugModeInit()	0	17	7
A	setNamespace()	0	4	1
A	getService()	0	6	2
A	classBaseName()	0	4	2
A	factory()	0	9	3
A	serialize()	0	7	1
A	register()	0	21	6
A	unserialize()	0	7	1

<?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 Opis\Closure\SerializableClosure;
use think\exception\ClassNotFoundException;
use think\initializer\BootService;
use think\initializer\Error;
use think\initializer\RegisterService;

/**
 * App 基础类
 */

Missing @category tag in class comment

Missing @package tag in class comment

Missing @author tag in class comment

Missing @license tag in class comment

Missing @link tag in class comment

class App extends Container
{
    const VERSION = '6.0.0RC1';

    /**
     * 应用调试模式
     * @var bool
     */
    protected $appDebug = true;

    /**
     * 应用开始时间
     * @var float
     */
    protected $beginTime;

    /**
     * 应用内存初始占用
     * @var integer
     */
    protected $beginMem;

    /**
     * 当前应用类库命名空间
     * @var string
     */
    protected $namespace = 'app';

    /**
     * 应用根目录
     * @var string
     */
    protected $rootPath = '';

    /**
     * 框架目录
     * @var string
     */
    protected $thinkPath = '';

    /**
     * 应用目录
     * @var string
     */
    protected $appPath = '';

    /**
     * Runtime目录
     * @var string
     */
    protected $runtimePath = '';

    /**
     * 配置后缀
     * @var string
     */
    protected $configExt = '.php';

    /**
     * 应用初始化器
     * @var array
     */
    protected $initializers = [
        Error::class,
        RegisterService::class,
        BootService::class,
    ];

    /**
     * 注册的系统服务
     * @var array
     */
    protected $services = [];

    /**
     * 初始化
     * @var bool
     */
    protected $initialized = false;

    /**
     * 架构方法
     * @access public
     * @param string $rootPath 应用根目录

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

     */
    public function __construct(string $rootPath = '')
    {
        $this->thinkPath   = dirname(__DIR__) . DIRECTORY_SEPARATOR;
        $this->rootPath    = $rootPath ? rtrim($rootPath, '/') . DIRECTORY_SEPARATOR : $this->getDefaultRootPath();
        $this->appPath     = $this->rootPath . 'app' . DIRECTORY_SEPARATOR;
        $this->runtimePath = $this->rootPath . 'runtime' . DIRECTORY_SEPARATOR;

        static::setInstance($this);

        $this->instance('app', $this);
        $this->instance('think\Container', $this);
    }

    /**
     * 注册服务
     * @access public
     * @param Service|string $service 服务

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

     * @param bool           $force   强制重新注册

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

     * @return Service|null
     */
    public function register($service, bool $force = false)
    {
        $registered = $this->getService($service);

        if ($registered && !$force) {
            return $registered;
        }

        if (is_string($service)) {
            $service = new $service($this);
        }

        if (method_exists($service, 'register')) {
            $service->register();
        }

        if (property_exists($service, 'bind')) {
            $this->bind($service->bind);
        }

        $this->services[] = $service;
    }

    /**
     * 执行服务
     * @access public
     * @param Service $service 服务

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

     * @return mixed
     */
    public function bootService($service)
    {
        if (method_exists($service, 'boot')) {
            return $this->invoke([$service, 'boot']);
        }
    }

    /**
     * 获取服务
     * @param string|Service $service

Missing parameter comment

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

     * @return Service|null
     */
    public function getService($service)
    {
        $name = is_string($service) ? $service : get_class($service);
        return array_values(array_filter($this->services, function ($value) use ($name) {

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

                return $value instanceof $name;
            }, ARRAY_FILTER_USE_BOTH))[0] ?? null;

This line of the multi-line function call does not seem to be indented correctly. Expected 8 spaces, but found 12.

Line indented incorrectly; expected 8 spaces, found 12

Closing brace indented incorrectly; expected 8 spaces, found 12

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

    }

    /**
     * 开启应用调试模式
     * @access public
     * @param bool $debug 开启应用调试模式

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

     * @return $this
     */
    public function debug(bool $debug = true)
    {
        $this->appDebug = $debug;
        return $this;
    }

    /**
     * 是否为调试模式
     * @access public
     * @return bool
     */
    public function isDebug(): bool
    {
        return $this->appDebug;
    }

    /**
     * 设置应用命名空间
     * @access public
     * @param string $namespace 应用命名空间

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

     * @return $this
     */
    public function setNamespace(string $namespace)
    {
        $this->namespace = $namespace;
        return $this;
    }

    /**
     * 获取应用类库命名空间
     * @access public
     * @return string
     */
    public function getNamespace(): string
    {
        return $this->namespace;
    }

    /**
     * 获取框架版本
     * @access public
     * @return string
     */
    public function version(): string
    {
        return static::VERSION;
    }

    /**
     * 获取应用根目录
     * @access public
     * @return string
     */
    public function getRootPath(): string
    {
        return $this->rootPath;
    }

    /**
     * 获取应用基础目录
     * @access public
     * @return string
     */
    public function getBasePath(): string
    {
        return $this->rootPath . 'app' . DIRECTORY_SEPARATOR;
    }

    /**
     * 获取当前应用目录
     * @access public
     * @return string
     */
    public function getAppPath(): string
    {
        return $this->appPath;
    }

    /**

Parameter $path should have a doc-comment as per coding-style.

     * 设置应用目录
     * @param $path

Missing parameter name

     */

Missing @return tag in function comment

    public function setAppPath($path)
    {
        $this->appPath = $path;
    }

    /**
     * 获取应用运行时目录
     * @access public
     * @return string
     */
    public function getRuntimePath(): string
    {
        return $this->runtimePath;
    }

    /**

Parameter $path should have a doc-comment as per coding-style.

     * 设置runtime目录
     * @param $path

Missing parameter name

     */

Missing @return tag in function comment

    public function setRuntimePath($path)
    {
        $this->runtimePath = $path;
    }

    /**
     * 获取核心框架目录
     * @access public
     * @return string
     */
    public function getThinkPath(): string
    {
        return $this->thinkPath;
    }

    /**
     * 获取应用配置目录
     * @access public
     * @return string
     */
    public function getConfigPath(): string
    {
        return $this->rootPath . 'config' . DIRECTORY_SEPARATOR;
    }

    /**
     * 获取配置后缀
     * @access public
     * @return string
     */
    public function getConfigExt(): string
    {
        return $this->configExt;
    }

    /**
     * 获取应用开启时间
     * @access public
     * @return float
     */
    public function getBeginTime(): float
    {
        return $this->beginTime;
    }

    /**
     * 获取应用初始内存占用
     * @access public
     * @return integer
     */
    public function getBeginMem(): int
    {
        return $this->beginMem;
    }

    /**
     * 初始化应用
     * @access public
     * @return $this
     */
    public function initialize()
    {
        $this->initialized = true;

        $this->beginTime = microtime(true);
        $this->beginMem  = memory_get_usage();

        // 加载环境变量
        if (is_file($this->rootPath . '.env')) {
            $this->env->load($this->rootPath . '.env');
        }

        $this->configExt = $this->env->get('config_ext', '.php');

It seems like $this->env->get('config_ext', '.php') can also be of type boolean. However, the property $configExt is declared as type string. Maybe add an additional type check?

        // 加载全局初始化文件
        if (is_file($this->getRuntimePath() . 'init.php')) {
            //直接加载缓存
            include $this->getRuntimePath() . 'init.php';
        } else {
            $this->load();
        }

        $this->debugModeInit();

        // 监听AppInit
        $this->event->trigger('AppInit');

        date_default_timezone_set($this->config->get('app.default_timezone', 'Asia/Shanghai'));

It seems like $this->config->get('app.default_timezone', 'Asia/Shanghai') can also be of type array and array; however, parameter $timezone_identifier of date_default_timezone_set() does only seem to accept string, maybe add an additional type check?

        // 初始化
        foreach ($this->initializers as $initializer) {
            $this->make($initializer)->init($this);
        }

        return $this;
    }

    /**
     * 是否初始化过
     * @return bool
     */
    public function initialized()
    {
        return $this->initialized;
    }

    /**
     * 引导应用
     * @access public
     * @return void
     */
    public function boot(): void
    {
        array_walk($this->services, function ($service) {

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

            $this->bootService($service);
        });

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

    }

    /**
     * 加载应用文件和配置
     * @access protected
     * @return void
     */
    protected function load(): void
    {
        $appPath = $this->getAppPath();

        if (is_file($appPath . 'common.php')) {
            include_once $appPath . 'common.php';
        }

        include $this->thinkPath . 'helper.php';

        $configPath = $this->getConfigPath();

        $files = [];

        if (is_dir($configPath)) {
            $files = glob($configPath . '*' . $this->configExt);
        }

        foreach ($files as $file) {
            $this->config->load($file, pathinfo($file, PATHINFO_FILENAME));
        }

        if (is_file($appPath . 'event.php')) {
            $this->loadEvent(include $appPath . 'event.php');
        }

        if (is_file($appPath . 'provider.php')) {
            $this->bind(include $appPath . 'provider.php');
        }
    }

    /**
     * 调试模式设置
     * @access protected
     * @return void
     */
    protected function debugModeInit(): void
    {
        // 应用调试模式
        if (!$this->appDebug) {
            $this->appDebug = $this->env->get('app_debug') ? true : false;
        }

        if (!$this->appDebug) {
            ini_set('display_errors', 'Off');
        } elseif (!$this->runningInConsole()) {
            //重新申请一块比较大的buffer
            if (ob_get_level() > 0) {
                $output = ob_get_clean();
            }
            ob_start();
            if (!empty($output)) {
                echo $output;
            }
        }
    }

    /**
     * 注册应用事件
     * @access protected
     * @param array $event 事件数据

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

     * @return void
     */
    public function loadEvent(array $event): void
    {
        if (isset($event['bind'])) {
            $this->event->bind($event['bind']);
        }

        if (isset($event['listen'])) {
            $this->event->listenEvents($event['listen']);
        }

        if (isset($event['subscribe'])) {
            $this->event->subscribe($event['subscribe']);
        }
    }

    /**
     * 解析应用类的类名
     * @access public
     * @param string $layer 层名 controller model ...

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

     * @param string $name  类名

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

     * @return string
     */
    public function parseClass(string $layer, string $name): string
    {
        $name  = str_replace(['/', '.'], '\\', $name);
        $array = explode('\\', $name);
        $class = self::parseName(array_pop($array), 1);
        $path  = $array ? implode('\\', $array) . '\\' : '';

        return $this->namespace . '\\' . $layer . '\\' . $path . $class;
    }

    /**
     * 是否运行在命令行下
     * @return bool
     */
    public function runningInConsole()
    {
        return php_sapi_name() === 'cli' || php_sapi_name() === 'phpdbg';
    }

    /**
     * 获取应用根目录
     * @access protected
     * @return string
     */
    protected function getDefaultRootPath(): string
    {
        $path = dirname(dirname(dirname(dirname($this->thinkPath))));

        return $path . DIRECTORY_SEPARATOR;
    }

    /**
     * 字符串命名风格转换
     * type 0 将Java风格转换为C的风格 1 将C风格转换为Java的风格
     * @access public
     * @param string  $name    字符串

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

     * @param integer $type    转换类型

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

     * @param bool    $ucfirst 首字母是否大写（驼峰规则）

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

     * @return string
     */
    public static function parseName(string $name = null, int $type = 0, bool $ucfirst = true): string
    {
        if ($type) {
            $name = preg_replace_callback('/_([a-zA-Z])/', function ($match) {

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

                return strtoupper($match[1]);
            }, $name);

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

            return $ucfirst ? ucfirst($name) : lcfirst($name);
        }

        return strtolower(trim(preg_replace("/[A-Z]/", "_\\0", $name), "_"));
    }

    /**
     * 获取类名(不包含命名空间)
     * @access public
     * @param string|object $class

Missing parameter comment

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

     * @return string
     */
    public static function classBaseName($class): string
    {
        $class = is_object($class) ? get_class($class) : $class;
        return basename(str_replace('\\', '/', $class));
    }

    /**

Parameter ...$args should have a doc-comment as per coding-style.

     * 创建工厂对象实例
     * @access public
     * @param string $name      工厂类名

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

     * @param string $namespace 默认命名空间

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

     * @param array  $args

Missing parameter comment

Doc comment for parameter $args does not match actual variable name ...$args

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

     * @return mixed
     */
    public static function factory(string $name, string $namespace = '', ...$args)
    {
        $class = false !== strpos($name, '\\') ? $name : $namespace . ucwords($name);

        if (class_exists($class)) {
            return Container::getInstance()->invokeClass($class, $args);
        }

        throw new ClassNotFoundException('class not exists:' . $class, $class);
    }

    /**

Missing short description in doc comment

Parameter $data should have a doc-comment as per coding-style.

     * @param $data

Missing parameter name

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

     * @codeCoverageIgnore
     * @return string

Tag value for @return tag indented incorrectly; expected 13 spaces but found 1

     */
    public static function serialize($data): string
    {
        SerializableClosure::enterContext();
        SerializableClosure::wrapClosures($data);
        $data = \serialize($data);
        SerializableClosure::exitContext();
        return $data;
    }

    /**

Missing short description in doc comment

     * @param string $data

Missing parameter comment

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

     * @codeCoverageIgnore
     * @return mixed|string

Tag value for @return tag indented incorrectly; expected 13 spaces but found 1

     */
    public static function unserialize(string $data)
    {
        SerializableClosure::enterContext();
        $data = \unserialize($data);
        SerializableClosure::unwrapClosures($data);
        SerializableClosure::exitContext();
        return $data;
    }
}