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