GitHub Access Token became invalid

It seems like the GitHub access token used for retrieving details about this repository from GitHub became invalid. This might prevent certain types of inspections from being run (in particular, everything related to pull requests).
Please ask an admin of your repository to re-new the access token on this website.
Passed
Pull Request — master (#23)
by t
03:07
created

I::call()   A

Complexity

Conditions 2
Paths 2

Size

Total Lines 5
Code Lines 3

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 4
CRAP Score 2

Importance

Changes 0
Metric Value
cc 2
eloc 3
nc 2
nop 2
dl 0
loc 5
ccs 4
cts 4
cp 1
crap 2
rs 10
c 0
b 0
f 0
1
<?php
2
/**
3
 * Class I
4
 *
5
 * @link https://www.icy2003.com/
6
 * @author icy2003 <[email protected]>
7
 * @copyright Copyright (c) 2017, icy2003
8
 */
9
namespace icy2003\php;
10
11
use Exception;
12
use icy2003\php\ihelpers\Strings;
13
use ReflectionClass;
14
15
/**
16
 * I 类
17
 */
18
class I
19
{
20
21
    /**
22
     * 获取值
23
     *
24
     * 支持类型:数组对象和 null、数字和字符串、布尔值、回调函数,依据数据类型有不同的含义(但是都很合理)
25
     *
26
     * @param mixed $mixed 混合类型
27
     *      - 当 $mixed 为**数组或对象**时,此方法用于按照层级获取值,用法如下:
28
     *          1. 对于一个多维数组 $array 来说,a.b.cd_ef 会拿 $array['a']['b']['cd_ef'] 的值
29
     *          2. 如果 $array['a'] 是对象,则先检查 getB 方法,然后检查 b 属性
30
     *          3. 如果 $array['a']['b'] 是对象,则检查 getCdEf 方法,然后检查 cd_ef 属性
31
     *      - 当 $mixed 为**布尔值**(即表达式)时,等价于三元操作符,例如 I::get(1 > 2, '真', '假')
32
     *      - 当 $mixed 为**字符串**时,等价于 Strings::sub,截取字符串
33
     *      - 当 $mixed 为 **null** 时,含义可被描述为:在使用 I::get($array, 'a.b', 1),$array 意外的是 null,返回 1 是理所当然的
34
     *      - 当 $mixed 为**回调函数**,$mixed 的执行结果将作为 I::get 的返回值
35
     * @param mixed $keyString 取决于 $mixed 的类型:
36
     *      - 当 $mixed 为**数组或对象**时,$keyString 表示:点(.)分割代表层级的字符串,下划线用于对象中转化成驼峰方法,支持数组和对象嵌套
37
     *      - 当 $mixed 为**布尔值**(即表达式)时,$keyString 表示:$mixed 为 true 时返回的值
38
     *      - 当 $mixed 为**字符串**时,$keyString 强制转为整型,表示:截取 $mixed 时,子串的起始位置
39
     *      - 当 $mixed 为 **null** 时,此参数无效
40
     *      - 当 $mixed 为**回调函数**,如果 $mixed 的返回值代表 true(如:1),则执行此回调
41
     * @param mixed $defaultValue 取决于 $mixed 的类型:
42
     *      - 当 $mixed 为**数组或对象**时,$defaultValue 表示:拿不到值时会直接返回该默认值
43
     *      - 当 $mixed 为**布尔值**(即表达式)时,$defaultValue 表示:$mixed 为 false 时返回的值
44
     *      - 当 $mixed 为**字符串**时,$defaultValue 表示:截取 $mixed 时,子串的长度,null 时表示长度为 1
45
     *      - 当 $mixed 为 **null** 时,返回 $defaultValue
46
     *      - 当 $mixed 为**回调函数**,如果 $mixed 的返回值代表 false(如:0),则执行此回调
47
     *
48
     * @return mixed
49
     */
50 51
    public static function get($mixed, $keyString, $defaultValue = null)
51
    {
52 51
        if (is_bool($mixed)) { // 布尔类型
53 1
            return true === $mixed ? $keyString : $defaultValue;
54 51
        } elseif (is_callable($mixed)) { // 回调
55 1
            $result = self::call($mixed);
56 1
            if ($result) {
57 1
                self::call($keyString);
58
            } else {
59 1
                self::call($defaultValue);
60
            }
61 1
            return $result;
62 51
        } elseif (is_array($mixed) || is_object($mixed)) { // 数组和对象
63 51
            if (false === is_string($keyString) && is_callable($keyString)) {
64
                $mixed = self::call($keyString, [$mixed]);
65
            } else {
66 51
                $keyArray = explode('.', $keyString);
67 51
                foreach ($keyArray as $key) {
68 51
                    if (is_array($mixed)) {
69 51
                        if (array_key_exists($key, $mixed) && null !== $mixed[$key]) {
70 50
                            $mixed = $mixed[$key];
71
                        } else {
72 51
                            return $defaultValue;
73
                        }
74 2
                    } elseif (is_object($mixed)) {
75 2
                        $method = 'get' . ucfirst(Strings::toCamel($key));
76 2
                        if (method_exists($mixed, $method)) {
77 1
                            $mixed = $mixed->$method();
78 2
                        } elseif (property_exists($mixed, $key) && null !== $mixed->$key) {
79 2
                            $mixed = $mixed->$key;
80
                        } else {
81
                            try {
82 1
                                $mixed = $mixed->$key;
83 1
                            } catch (Exception $e) {
0 ignored issues
show
Unused Code introduced by
catch (\Exception $e) is not reachable.

This check looks for unreachable code. It uses sophisticated control flow analysis techniques to find statements which will never be executed.

Unreachable code is most often the result of return, die or exit statements that have been added for debug purposes.

function fx() {
    try {
        doSomething();
        return true;
    }
    catch (\Exception $e) {
        return false;
    }

    return false;
}

In the above example, the last return false will never be executed, because a return statement has already been met in every possible execution path.

Loading history...
84 2
                                return $defaultValue;
85
                            }
86
87
                        }
88
                    } else {
89 1
                        return self::get($mixed, $key, $defaultValue);
90
                    }
91
                }
92
            }
93 50
            return $mixed;
94 1
        } elseif (is_string($mixed) || is_numeric($mixed)) { // 字符串或数字
95 1
            $pos = (int)$keyString;
96 1
            $length = null === $defaultValue ? 1 : (int)$defaultValue;
97 1
            return Strings::sub($mixed, $pos, $length);
98 1
        } elseif (null === $mixed) { // null
99 1
            return $defaultValue;
100
        } else { // 资源
101 1
            return $defaultValue;
102
        }
103
    }
104
105
    /**
106
     * 设置值
107
     *
108
     * @param array|object $mixed 对象或数组
109
     * @param string $key 键
110
     * @param mixed $value 值
111
     * @param boolean $overWrite 如果对应的值存在,是否用给定的值覆盖,默认 true,即:是
112
     *
113
     * @return mixed
114
     */
115 1
    public static function set(&$mixed, $key, $value, $overWrite = true)
116
    {
117 1
        $get = self::get($mixed, $key);
118 1
        if (null === $get || true === $overWrite) {
119 1
            if (is_array($mixed)) {
120 1
                $mixed[$key] = $value;
121 1
            } elseif (is_object($mixed)) {
122 1
                $method = 'set' . ucfirst(Strings::toCamel($key));
123 1
                if (method_exists($mixed, $method)) {
124 1
                    $mixed->$method($value);
125 1
                } elseif (property_exists($mixed, $key)) {
126 1
                    $mixed->$key = $value;
127
                } else {
128 1
                    throw new Exception('无法设置值');
129
                }
130
            }
131 1
            return $value;
132
        }
133 1
        return $get;
134
    }
135
136
    /**
137
     * 触发回调
138
     *
139
     * @param callback $callback 回调函数
140
     * @param array $params 回调参数
141
     * @return mixed
142
     */
143 10
    public static function call($callback, $params = [])
144
    {
145 10
        $result = false;
146 10
        is_callable($callback) && $result = call_user_func_array($callback, $params);
147 10
        return $result;
148
    }
149
150
    /**
151
     * 定义一个常量
152
     *
153
     * @param string $constant 常量名
154
     * @param mixed $value 值
155
     *
156
     * @return void
157
     */
158 1
    public static function def($constant, $value)
159
    {
160 1
        defined($constant) || define($constant, $value);
161 1
    }
162
163
    /**
164
     * 让 empty 支持函数调用
165
     *
166
     * 注意:此函数并不比 empty 好,只是为了让 empty 支持函数调用
167
     *
168
     * 例如:empty($array[0]) 就不能用此函数代替,另外,empty 是语法结构,性能明显比函数高
169
     *
170
     * @see http://php.net/manual/zh/function.empty.php
171
     *
172
     * @param mixed $data
173
     * @return boolean
174
     */
175 5
    public static function isEmpty($data)
176
    {
177 5
        return empty($data);
178
    }
179
180
    /**
181
     * 获取 php.ini 配置值
182
     *
183
     * @param string $key 配置名
184
     * @param mixed $default 默认值
185
     *
186
     * @return mixed
187
     */
188 2
    public static function phpini($key, $default = null)
189
    {
190 2
        return false !== ($ini = ini_get($key)) ? $ini : (false !== ($ini = get_cfg_var($key)) ? $ini : $default);
191
    }
192
193
    /**
194
     * 显示 PHP 错误
195
     *
196
     * @param boolean $show 是否显示,默认是
197
     *
198
     * @return void
199
     */
200 1
    public static function displayErrors($show = true)
201
    {
202 1
        ini_set("display_errors", true === $show ? 'On' : 'Off');
203 1
        true === $show && error_reporting(E_ALL | E_STRICT);
204 1
    }
205
206
    /**
207
     * 别名列表
208
     *
209
     * @var array
210
     */
211
    public static $aliases = [
212
        '@vendor' => __DIR__ . '/../../../../vendor',
213
        '@icy2003/php_tests' => __DIR__ . '/../tests',
214
        '@icy2003/php_runtime' => __DIR__ . '/../runtime',
215
        '@icy2003/php' => __DIR__,
216
    ];
217
218
    /**
219
     * 用别名获取真实路径
220
     *
221
     * @param string $alias 别名
222
     *
223
     * @return string|boolean
224
     */
225 50
    public static function getAlias($alias)
226
    {
227 50
        $alias = Strings::replace($alias, ["\\" => '/']);
228 50
        if (strncmp($alias, '@', 1)) {
229 18
            return $alias;
230
        }
231
232 50
        $pos = 0;
233 50
        while (true) {
234 50
            $pos = strpos($alias, '/', $pos);
235 50
            $root = $pos === false ? $alias : substr($alias, 0, $pos);
236 50
            if (isset(static::$aliases[$root])) {
237 50
                if (is_string(static::$aliases[$root])) {
238 50
                    return $pos === false ? static::$aliases[$root] : static::$aliases[$root] . substr($alias, $pos);
239
                } elseif (is_array(static::$aliases[$root])) {
240
                    foreach (static::$aliases[$root] as $name => $path) {
241
                        if (strpos($alias . '/', $name . '/') === 0) {
242
                            return $path . substr($alias, strlen($name));
243
                        }
244
                    }
245
                } else {
246
                    return false;
247
                }
248
            }
249 50
            if ($root == $alias) {
250
                break;
251
            }
252 50
            $pos++;
253
        }
254
        // 对 Yii2 的支持
255
        if ($result = self::call(['\Yii', 'getAlias'], [$alias])) {
256
            self::setAlias($alias, $result);
257
            return $result;
258
        }
259
260
        return false;
261
    }
262
263
    /**
264
     * 是否是 Yii2 项目
265
     *
266
     * @return boolean
267
     */
268
    public static function isYii2()
269
    {
270
        return method_exists('\Yii', 'getVersion');
271
    }
272
273
    /**
274
     * 设置别名
275
     *
276
     * @param string $alias 别名
277
     * @param string|null $path 路径
278
     *
279
     * @return void
280
     */
281 1
    public static function setAlias($alias, $path)
282
    {
283
        // 对 Yii2 的支持
284
        try {
285 1
            self::call(['\Yii', 'getAlias'], [$alias]);
286
        } catch (Exception $e) {
287
            self::call(['\Yii', 'setAlias'], [$alias, $path]);
288
        }
289 1
        if (strncmp($alias, '@', 1)) {
290
            $alias = '@' . $alias;
291
        }
292 1
        $pos = strpos($alias, '/');
293 1
        $root = $pos === false ? $alias : substr($alias, 0, $pos);
294 1
        if ($path !== null) {
295 1
            $path = strncmp($path, '@', 1) ? rtrim($path, '\\/') : static::getAlias($path);
296 1
            if (!isset(static::$aliases[$root])) {
297 1
                if ($pos === false) {
298 1
                    static::$aliases[$root] = $path;
299
                } else {
300 1
                    static::$aliases[$root] = [$alias => $path];
301
                }
302
            } elseif (is_string(static::$aliases[$root])) {
303
                if ($pos === false) {
304
                    static::$aliases[$root] = $path;
305
                } else {
306
                    static::$aliases[$root] = [
307
                        $alias => $path,
308
                        $root => static::$aliases[$root],
309
                    ];
310
                }
311
            } else {
312
                static::$aliases[$root][$alias] = $path;
313 1
                krsort(static::$aliases[$root]);
314
            }
315
        } elseif (isset(static::$aliases[$root])) {
316
            if (is_array(static::$aliases[$root])) {
317
                unset(static::$aliases[$root][$alias]);
318
            } elseif ($pos === false) {
319
                unset(static::$aliases[$root]);
320
            }
321
        }
322 1
    }
323
324
    /**
325
     * 判断给定选项值里是否设置某选项
326
     *
327
     * @param integer $flags 选项值
328
     * @param integer $flag 待判断的选项值
329
     *
330
     * @return boolean
331
     */
332 4
    public static function hasFlag($flags, $flag)
333
    {
334 4
        return $flags === ($flag | $flags);
335
    }
336
337
    /**
338
     * 创建一个对象
339
     *
340
     * @param array|string $params
341
     *      - 字符串:该字符串将被作为类名转成数组处理
342
     *      - 数组:
343
     *          1. class:表示类名
344
     *          2. 其他:该类的属性,初始化这些属性或者调用相应的 set 方法
345
     * @param array $config
346
     * - 构造函数传参
347
     *
348
     * @return object
349
     * @throws Exception
350
     */
351
    public static function obj($params, $config = [])
352
    {
353
        if (is_string($params)) {
354
            $params = ['class' => $params];
355
        }
356
        if (is_array($params) && isset($params['class'])) {
357
            try {
358
                $class = $params['class'];
359
                unset($params['class']);
360
                $reflection = new ReflectionClass($class);
361
                $object = $reflection->newInstanceArgs($config);
362
                foreach ($params as $name => $value) {
363
                    self::set($object, $name, $value);
364
                }
365
                return $object;
366
            } catch (Exception $e) {
367
                throw new Exception('初始化 ' . $class . ' 失败', $e->getCode(), $e);
368
            }
369
        }
370
        throw new Exception('必须带 class 键来指定一个类');
371
    }
372
373
    /**
374
     * 静态配置
375
     *
376
     * @var array
377
     */
378
    public static $ini = [
379
        'USE_CUSTOM' => false,
380
        'EXT_LOADED' => true,
381
    ];
382
383
    /**
384
     * 读取或设置一个全局配置
385
     *
386
     * - 该配置是利用静态类进行存储的
387
     * - 如果给定 $value,则为设置,不给则为获取
388
     * - 可选默认配置有:
389
     *      1. USE_CUSTOM:默认 false,即尝试使用 php 原生函数的实现,如果此参数为 true,则使用 icy2003/php 的实现
390
     *      2. EXT_LOADED:默认 true,即尝试检测是否有扩展,如果为 false,直接认为没有该扩展
391
     *
392
     * @param string $key
393
     * @param mixed $value
394
     *
395
     * @return void|mixed
396
     */
397 4
    public static function ini($key, $value = null)
398
    {
399 4
        if (null !== $value) {
400 3
            self::$ini[$key] = $value;
401
        } else {
402 4
            return self::get(self::$ini, $key);
403
        }
404 3
    }
405
406
    /**
407
     * 是否有加载 PHP 扩展
408
     *
409
     * @param string $extName
410
     *
411
     * @return boolean
412
     */
413
    public static function isExt($extName)
414
    {
415
        if (false === extension_loaded($extName) || false === self::ini('EXT_LOADED')) {
416
            return false;
417
        }
418
        return true;
419
    }
420
421
    /**
422
     * 判断当前操作系统是不是 windows
423
     *
424
     * @return boolean
425
     */
426
    public static function isWin()
427
    {
428
        return 'WIN' === strtoupper(substr(PHP_OS, 0, 3));
429
    }
430
}
431