导航菜单
首页 > 网络编程 > PHP编程 » 正文

PHP命名空间与自动加载机制的基础介绍

后台-系统设置-扩展变量-手机广告位-内容正文顶部

include 和 require 是PHP中引入文件的两个基本方法。在小规模开发中直接使用 include 和 require 没哟什么不妥,但在大型项目中会造成大量的 include 和 require 堆积。这样的代码既不优雅,执行效率也很低,而且维护起来也相当困难。

为了解决这个问题,部分框架会给出一个引入文件的配置清单,在对象初始化的时候把需要的文件引入。但这只是让代码变得更简洁了一些,引入的效果仍然是差强人意。PHP5 之后,随着 PHP 面向对象支持的完善,__autoload 函数才真正使得自动加载成为可能。

* include 和 require 功能是一样的,它们的不同在于 include 出错时只会产生警告,而 require 会抛出错误终止脚本。

* include_once 和 include 唯一的区别在于 include_once 会检查文件是否已经引入,如果是则不会重复引入。

=================自动加载==================

实现自动加载最简单的方式就是使用 __autoload 魔术方法。当需要使用的类没有被引入时,这个函数会在PHP报错前被触发,未定义的类名会被当作参数传入。至于函数具体的逻辑,这需要用户自己去实现。

首先创建一个 autoload.php 来做一个简单的测试:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
// 类未定义时,系统自动调用
function __autoload($class)
{
 /* 具体处理逻辑 */
 echo $class;// 简单的输出未定义的类名
}
 
new HelloWorld();
 
/**
 * 输出 HelloWorld 与报错信息
 * Fatal error: Class 'HelloWorld' not found
 */

通过这个简单的例子可以发现,在类的实例化过程中,系统所做的工作大致是这样的:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
/* 模拟系统实例化过程 */
function instance($class)
{
 // 如果类存在则返回其实例
 if (class_exists($class, false)) {
  return new $class();
 }
 // 查看 autoload 函数是否被用户定义
 if (function_exists('__autoload')) {
  __autoload($class); // 最后一次引入的机会
 }
 // 再次检查类是否存在
 if (class_exists($class, false)) {
  return new $class();
 } else { // 系统:我实在没辙了
  throw new Exception('Class Not Found');
 }
}

明白了 __autoload 函数的工作原理之后,那就让我们来用它去实现自动加载。

首先创建一个类文件(建议文件名与类名一致),代码如下:

?
1
2
3
4
5
6
7
8
class [ClassName]
{
 // 对象实例化时输出当前类名
 function __construct()
 {
  echo '<h1>' . __CLASS__ . '</h1>';
 }
}

(我这里创建了一个 HelloWorld 类用作演示)接下来我们就要定义 __autoload 的具体逻辑,使它能够实现自动加载:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
function __autoload($class)
{
 // 根据类名确定文件名
 $file = $class . '.php';
 
 if (file_exists($file)) {
  include $file; // 引入PHP文件
 }
}
 
new HelloWorld();
 
/**
 * 输出 <h1>HelloWorld</h1>
 */

=================命名空间==================

其实命名空间并不是什么新生事物,很多语言(例如C++)早都支持这个特性了。只不过 PHP 起步比较晚,直到 PHP 5.3 之后才支持。

命名空间简而言之就是一种标识,它的主要目的是解决命名冲突的问题。

就像在日常生活中,有很多姓名相同的人,如何区分这些人呢?那就需要加上一些额外的标识。

把工作单位当成标识似乎不错,这样就不用担心 “撞名” 的尴尬了。

这里我们来做一个小任务,去介绍百度的CEO李彦宏:

?
1
2
3
4
5
6
7
8
9
namespace 百度;
 
class 李彦宏
{
 function __construct()
 {
  echo '百度创始人';
 }
}

↑ 这就是李彦宏的基本资料了,namespace 是他的单位标识,class 是他的姓名。

命名空间通过关键字 namespace 来声明。如果一个文件中包含命名空间,它必须在其它所有代码之前声明命名空间。

?
1
2
new 百度\李彦宏(); // 限定类名
new \百度\李彦宏(); // 完全限定类名

↑ 在一般情况下,无论是向别人介绍 "百度 李彦宏" 还是 "百度公司 李彦宏",他们都能够明白。

在当前命名空间没有声明的情况下,限定类名和完全限定类名是等价的。因为如果不指定空间,则默认为全局(\)。

?
1
2
3
4
namespace 谷歌;
 
new 百度\李彦宏(); // 谷歌\百度\李彦宏(实际结果)
new \百度\李彦宏(); // 百度\李彦宏(实际结果)

↑ 如果你在谷歌公司向他们的员工介绍李彦宏,一定要指明是 "百度公司的李彦宏"。否则他会认为百度是谷歌的一个部门,而李彦宏只是其中的一位员工而已。

这个例子展示了在命名空间下,使用限定类名和完全限定类名的区别。(完全限定类名 = 当前命名空间 + 限定类名)

?
1
2
3
4
5
6
7
8
9
10
/* 导入命名空间 */
use 百度\李彦宏;
new 李彦宏(); // 百度\李彦宏(实际结果)
 
/* 设置别名 */
use 百度\李彦宏 AS CEO;
new CEO(); // 百度\李彦宏(实际结果)
 
/* 任何情况 */
new \百度\李彦宏();// 百度\李彦宏(实际结果)

↑ 第一种情况是别人已经认识李彦宏了,你只需要直接说名字,他就能知道你指的是谁。第二种情况是李彦宏就是他们的CEO,你直接说CEO,他可以立刻反应过来。

使用命名空间只是让类名有了前缀,不容易发生冲突,系统仍然不会进行自动导入。

如果不引入文件,系统会在抛出 "Class Not Found" 错误之前触发 __autoload 函数,并将限定类名传入作为参数。

所以上面的例子都是基于你已经将相关文件手动引入的情况下实现的,否则系统会抛出 " Class '百度\李彦宏' not found"。

=================spl_autoload==================

接下来让我们要在含有命名空间的情况下去实现自动加载。这里我们使用 spl_autoload_register() 函数来实现,这需要你的 PHP 版本号大于 5.12。

spl_autoload_register 函数的功能就是把传入的函数(参数可以为回调函数或函数名称形式)注册到 SPL __autoload 函数队列中,并移除系统默认的 __autoload() 函数。

一旦调用 spl_autoload_register() 函数,当调用未定义类时,系统就会按顺序调用注册到 spl_autoload_register() 函数的所有函数,而不是自动调用 __autoload() 函数。

现在,我们来创建一个 Linux 类,它使用 os 作为它的命名空间(建议文件名与类名保持一致):

?
1
2
3
4
5
6
7
8
9
namespace os; // 命名空间
 
class Linux // 类名
{
 function __construct()
 {
  echo '<h1>' . __CLASS__ . '</h1>';
 }
}

接着,在同一个目录下新建一个 PHP 文件,使用 spl_autoload_register 以函数回调的方式实现自动加载:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
spl_autoload_register(function ($class) { // class = os\Linux
 
 /* 限定类名路径映射 */
 $class_map = array(
  // 限定类名 => 文件路径
  'os\\Linux' => './Linux.php',
 );
 
 /* 根据类名确定文件名 */
 $file = $class_map[$class];
 
 /* 引入相关文件 */
 if (file_exists($file)) {
  include $file;
 }
});
 
new \os\Linux();

这里我们使用了一个数组去保存类名与文件路径的关系,这样当类名传入时,自动加载器就知道该引入哪个文件去加载这个类了。

但是一旦文件多起来的话,映射数组会变得很长,这样的话维护起来会相当麻烦。如果命名能遵守统一的约定,就可以让自动加载器自动解析判断类文件所在的路径。接下来要介绍的PSR-4 就是一种被广泛采用的约定方式。

=================PSR-4规范==================

PSR-4 是关于由文件路径自动载入对应类的相关规范,规范规定了一个完全限定类名需要具有以下结构:

\<顶级命名空间>(\<子命名空间>)*\<类名>

如果继续拿上面的例子打比方的话,顶级命名空间相当于公司,子命名空间相当于职位,类名相当于人名。那么李彦宏标准的称呼为 "百度公司 CEO 李彦宏"。

PSR-4 规范中必须要有一个顶级命名空间,它的意义在于表示某一个特殊的目录(文件基目录)。子命名空间代表的是类文件相对于文件基目录的这一段路径(相对路径),类名则与文件名保持一致(注意大小写的区别)。

举个例子:在全限定类名 \app\view\news\Index 中,如果 app 代表 C:\Baidu,那么这个类的路径则是 C:\Baidu\view\news\Index.php

我们就以解析 \app\view\news\Index 为例,编写一个简单的 Demo:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
$class = 'app\view\news\Index';
 
/* 顶级命名空间路径映射 */
$vendor_map = array(
  'app' => 'C:\Baidu',
);
 
/* 解析类名为文件路径 */
$vendor = substr($class, 0, strpos($class, '\\')); // 取出顶级命名空间[app]
$vendor_dir = $vendor_map[$vendor]; // 文件基目录[C:\Baidu]
$rel_path = dirname(substr($class, strlen($vendor))); // 相对路径[/view/news]
$file_name = basename($class) . '.php'; // 文件名[Index.php]
 
/* 输出文件所在路径 */
echo $vendor_dir . $rel_path . DIRECTORY_SEPARATOR . $file_name;

通过这个 Demo 可以看出限定类名转换为路径的过程。那么现在就让我们用规范的面向对象方式去实现自动加载器吧。

首先我们创建一个文件 Index.php,它处于 \app\mvc\view\home 目录中:

?
1
2
3
4
5
6
7
8
9
namespace app\mvc\view\home;
 
class Index
{
  function __construct()
  {
    echo '<h1> Welcome To Home </h1>';
  }
}

接着我们在创建一个加载类(不需要命名空间),它处于 \ 目录中:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
class Loader
{
  /* 路径映射 */
  public static $vendorMap = array(
    'app' => __DIR__ . DIRECTORY_SEPARATOR . 'app',
  );
 
  /**
   * 自动加载器
   */
  public static function autoload($class)
  {
    $file = self::findFile($class);
    if (file_exists($file)) {
      self::includeFile($file);
    }
  }
 
  /**
   * 解析文件路径
   */
  private static function findFile($class)
  {
    $vendor = substr($class, 0, strpos($class, '\\')); // 顶级命名空间
    $vendorDir = self::$vendorMap[$vendor]; // 文件基目录
    $filePath = substr($class, strlen($vendor)) . '.php'; // 文件相对路径
    return strtr($vendorDir . $filePath, '\\', DIRECTORY_SEPARATOR); // 文件标准路径
  }
 
  /**
   * 引入文件
   */
  private static function includeFile($file)
  {
    if (is_file($file)) {
      include $file;
    }
  }
}

最后,将 Loader 类中的 autoload 注册到 spl_autoload_register 函数中:

?
1
2
3
4
5
6
7
8
include 'Loader.php'; // 引入加载器
spl_autoload_register('Loader::autoload'); // 注册自动加载
 
new \app\mvc\view\home\Index(); // 实例化未引用的类
 
/**
 * 输出: <h1> Welcome To Home </h1>
 */

示例中的代码其实就是 ThinkPHP 自动加载器源码的精简版,它是 ThinkPHP 5 能实现惰性加载的关键。

至此,自动加载的原理已经全部讲完了,如果有兴趣深入了解的话,可以参考下面的 ThinkPHP 源码。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
class Loader
{
  protected static $instance = [];
  // 类名映射
  protected static $map = [];
 
  // 命名空间别名
  protected static $namespaceAlias = [];
 
  // PSR-4
  private static $prefixLengthsPsr4 = [];
  private static $prefixDirsPsr4  = [];
  private static $fallbackDirsPsr4 = [];
 
  // PSR-0
  private static $prefixesPsr0   = [];
  private static $fallbackDirsPsr0 = [];
 
  // 自动加载的文件
  private static $autoloadFiles = [];
 
  // 自动加载
  public static function autoload($class)
  {
    // 检测命名空间别名
    if (!empty(self::$namespaceAlias)) {
      $namespace = dirname($class);
      if (isset(self::$namespaceAlias[$namespace])) {
        $original = self::$namespaceAlias[$namespace] . '\\' . basename($class);
        if (class_exists($original)) {
          return class_alias($original, $class, false);
        }
      }
    }
 
    if ($file = self::findFile($class)) {
 
      // Win环境严格区分大小写
      if (IS_WIN && pathinfo($file, PATHINFO_FILENAME) != pathinfo(realpath($file), PATHINFO_FILENAME)) {
        return false;
      }
 
      __include_file($file);
      return true;
    }
  }
 
  /**
   * 查找文件
   * @param $class
   * @return bool
   */
  private static function findFile($class)
  {
    if (!empty(self::$map[$class])) {
      // 类库映射
      return self::$map[$class];
    }
 
    // 查找 PSR-4
    $logicalPathPsr4 = strtr($class, '\\', DS) . EXT;
 
    $first = $class[0];
    if (isset(self::$prefixLengthsPsr4[$first])) {
      foreach (self::$prefixLengthsPsr4[$first] as $prefix => $length) {
        if (0 === strpos($class, $prefix)) {
          foreach (self::$prefixDirsPsr4[$prefix] as $dir) {
            if (is_file($file = $dir . DS . substr($logicalPathPsr4, $length))) {
              return $file;
            }
          }
        }
      }
    }
 
    // 查找 PSR-4 fallback dirs
    foreach (self::$fallbackDirsPsr4 as $dir) {
      if (is_file($file = $dir . DS . $logicalPathPsr4)) {
        return $file;
      }
    }
 
    // 查找 PSR-0
    if (false !== $pos = strrpos($class, '\\')) {
      // namespaced class name
      $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
      . strtr(substr($logicalPathPsr4, $pos + 1), '_', DS);
    } else {
      // PEAR-like class name
      $logicalPathPsr0 = strtr($class, '_', DS) . EXT;
    }
 
    if (isset(self::$prefixesPsr0[$first])) {
      foreach (self::$prefixesPsr0[$first] as $prefix => $dirs) {
        if (0 === strpos($class, $prefix)) {
          foreach ($dirs as $dir) {
            if (is_file($file = $dir . DS . $logicalPathPsr0)) {
              return $file;
            }
          }
        }
      }
    }
 
    // 查找 PSR-0 fallback dirs
    foreach (self::$fallbackDirsPsr0 as $dir) {
      if (is_file($file = $dir . DS . $logicalPathPsr0)) {
        return $file;
      }
    }
 
    return self::$map[$class] = false;
  }
 
  // 注册classmap
  public static function addClassMap($class, $map = '')
  {
    if (is_array($class)) {
      self::$map = array_merge(self::$map, $class);
    } else {
      self::$map[$class] = $map;
    }
  }
 
  // 注册命名空间
  public static function addNamespace($namespace, $path = '')
  {
    if (is_array($namespace)) {
      foreach ($namespace as $prefix => $paths) {
        self::addPsr4($prefix . '\\', rtrim($paths, DS), true);
      }
    } else {
      self::addPsr4($namespace . '\\', rtrim($path, DS), true);
    }
  }
 
  // 添加Ps0空间
  private static function addPsr0($prefix, $paths, $prepend = false)
  {
    if (!$prefix) {
      if ($prepend) {
        self::$fallbackDirsPsr0 = array_merge(
          (array) $paths,
          self::$fallbackDirsPsr0
        );
      } else {
        self::$fallbackDirsPsr0 = array_merge(
          self::$fallbackDirsPsr0,
          (array) $paths
        );
      }
 
      return;
    }
 
    $first = $prefix[0];
    if (!isset(self::$prefixesPsr0[$first][$prefix])) {
      self::$prefixesPsr0[$first][$prefix] = (array) $paths;
 
      return;
    }
    if ($prepend) {
      self::$prefixesPsr0[$first][$prefix] = array_merge(
        (array) $paths,
        self::$prefixesPsr0[$first][$prefix]
      );
    } else {
      self::$prefixesPsr0[$first][$prefix] = array_merge(
        self::$prefixesPsr0[$first][$prefix],
        (array) $paths
      );
    }
  }
 
  // 添加Psr4空间
  private static function addPsr4($prefix, $paths, $prepend = false)
  {
    if (!$prefix) {
      // Register directories for the root namespace.
      if ($prepend) {
        self::$fallbackDirsPsr4 = array_merge(
          (array) $paths,
          self::$fallbackDirsPsr4
        );
      } else {
        self::$fallbackDirsPsr4 = array_merge(
          self::$fallbackDirsPsr4,
          (array) $paths
        );
      }
    } elseif (!isset(self::$prefixDirsPsr4[$prefix])) {
      // Register directories for a new namespace.
      $length = strlen($prefix);
      if ('\\' !== $prefix[$length - 1]) {
        throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
      }
      self::$prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
      self::$prefixDirsPsr4[$prefix]        = (array) $paths;
    } elseif ($prepend) {
      // Prepend directories for an already registered namespace.
      self::$prefixDirsPsr4[$prefix] = array_merge(
        (array) $paths,
        self::$prefixDirsPsr4[$prefix]
      );
    } else {
      // Append directories for an already registered namespace.
      self::$prefixDirsPsr4[$prefix] = array_merge(
        self::$prefixDirsPsr4[$prefix],
        (array) $paths
      );
    }
  }
 
  // 注册命名空间别名
  public static function addNamespaceAlias($namespace, $original = '')
  {
    if (is_array($namespace)) {
      self::$namespaceAlias = array_merge(self::$namespaceAlias, $namespace);
    } else {
      self::$namespaceAlias[$namespace] = $original;
    }
  }
 
  // 注册自动加载机制
  public static function register($autoload = '')
  {
    // 注册系统自动加载
    spl_autoload_register($autoload ?: 'think\\Loader::autoload', true, true);
    // 注册命名空间定义
    self::addNamespace([
      'think'  => LIB_PATH . 'think' . DS,
      'behavior' => LIB_PATH . 'behavior' . DS,
      'traits'  => LIB_PATH . 'traits' . DS,
    ]);
    // 加载类库映射文件
    if (is_file(RUNTIME_PATH . 'classmap' . EXT)) {
      self::addClassMap(__include_file(RUNTIME_PATH . 'classmap' . EXT));
    }
 
    // Composer自动加载支持
    if (is_dir(VENDOR_PATH . 'composer')) {
      self::registerComposerLoader();
    }
 
    // 自动加载extend目录
    self::$fallbackDirsPsr4[] = rtrim(EXTEND_PATH, DS);
  }
 
  // 注册composer自动加载
  private static function registerComposerLoader()
  {
    if (is_file(VENDOR_PATH . 'composer/autoload_namespaces.php')) {
      $map = require VENDOR_PATH . 'composer/autoload_namespaces.php';
      foreach ($map as $namespace => $path) {
        self::addPsr0($namespace, $path);
      }
    }
 
    if (is_file(VENDOR_PATH . 'composer/autoload_psr4.php')) {
      $map = require VENDOR_PATH . 'composer/autoload_psr4.php';
      foreach ($map as $namespace => $path) {
        self::addPsr4($namespace, $path);
      }
    }
 
    if (is_file(VENDOR_PATH . 'composer/autoload_classmap.php')) {
      $classMap = require VENDOR_PATH . 'composer/autoload_classmap.php';
      if ($classMap) {
        self::addClassMap($classMap);
      }
    }
 
    if (is_file(VENDOR_PATH . 'composer/autoload_files.php')) {
      $includeFiles = require VENDOR_PATH . 'composer/autoload_files.php';
      foreach ($includeFiles as $fileIdentifier => $file) {
        if (empty(self::$autoloadFiles[$fileIdentifier])) {
          __require_file($file);
          self::$autoloadFiles[$fileIdentifier] = true;
        }
      }
    }
  }
 
  /**
   * 导入所需的类库 同java的Import 本函数有缓存功能
   * @param string $class  类库命名空间字符串
   * @param string $baseUrl 起始路径
   * @param string $ext   导入的文件扩展名
   * @return boolean
   */
  public static function import($class, $baseUrl = '', $ext = EXT)
  {
    static $_file = [];
    $key     = $class . $baseUrl;
    $class    = str_replace(['.', '#'], [DS, '.'], $class);
    if (isset($_file[$key])) {
      return true;
    }
 
    if (empty($baseUrl)) {
      list($name, $class) = explode(DS, $class, 2);
 
      if (isset(self::$prefixDirsPsr4[$name . '\\'])) {
        // 注册的命名空间
        $baseUrl = self::$prefixDirsPsr4[$name . '\\'];
      } elseif ('@' == $name) {
        //加载当前模块应用类库
        $baseUrl = App::$modulePath;
      } elseif (is_dir(EXTEND_PATH . $name)) {
        $baseUrl = EXTEND_PATH;
      } else {
        // 加载其它模块的类库
        $baseUrl = APP_PATH . $name . DS;
      }
    } elseif (substr($baseUrl, -1) != DS) {
      $baseUrl .= DS;
    }
    // 如果类存在 则导入类库文件
    if (is_array($baseUrl)) {
      foreach ($baseUrl as $path) {
        $filename = $path . DS . $class . $ext;
        if (is_file($filename)) {
          break;
        }
      }
    } else {
      $filename = $baseUrl . $class . $ext;
    }
 
    if (!empty($filename) && is_file($filename)) {
      // 开启调试模式Win环境严格区分大小写
      if (IS_WIN && pathinfo($filename, PATHINFO_FILENAME) != pathinfo(realpath($filename), PATHINFO_FILENAME)) {
        return false;
      }
      __include_file($filename);
      $_file[$key] = true;
      return true;
    }
    return false;
  }
 
  /**
   * 实例化(分层)模型
   * @param string $name     Model名称
   * @param string $layer    业务层名称
   * @param bool  $appendSuffix 是否添加类名后缀
   * @param string $common    公共模块名
   * @return Object
   * @throws ClassNotFoundException
   */
  public static function model($name = '', $layer = 'model', $appendSuffix = false, $common = 'common')
  {
    if (isset(self::$instance[$name . $layer])) {
      return self::$instance[$name . $layer];
    }
    if (strpos($name, '/')) {
      list($module, $name) = explode('/', $name, 2);
    } else {
      $module = Request::instance()->module();
    }
    $class = self::parseClass($module, $layer, $name, $appendSuffix);
    if (class_exists($class)) {
      $model = new $class();
    } else {
      $class = str_replace('\\' . $module . '\\', '\\' . $common . '\\', $class);
      if (class_exists($class)) {
        $model = new $class();
      } else {
        throw new ClassNotFoundException('class not exists:' . $class, $class);
      }
    }
    self::$instance[$name . $layer] = $model;
    return $model;
  }
 
  /**
   * 实例化(分层)控制器 格式:[模块名/]控制器名
   * @param string $name     资源地址
   * @param string $layer    控制层名称
   * @param bool  $appendSuffix 是否添加类名后缀
   * @param string $empty    空控制器名称
   * @return Object|false
   * @throws ClassNotFoundException
   */
  public static function controller($name, $layer = 'controller', $appendSuffix = false, $empty = '')
  {
    if (strpos($name, '/')) {
      list($module, $name) = explode('/', $name);
    } else {
      $module = Request::instance()->module();
    }
    $class = self::parseClass($module, $layer, $name, $appendSuffix);
    if (class_exists($class)) {
      return new $class(Request::instance());
    } elseif ($empty && class_exists($emptyClass = self::parseClass($module, $layer, $empty, $appendSuffix))) {
      return new $emptyClass(Request::instance());
    }
  }
 
  /**
   * 实例化验证类 格式:[模块名/]验证器名
   * @param string $name     资源地址
   * @param string $layer    验证层名称
   * @param bool  $appendSuffix 是否添加类名后缀
   * @param string $common    公共模块名
   * @return Object|false
   * @throws ClassNotFoundException
   */
  public static function validate($name = '', $layer = 'validate', $appendSuffix = false, $common = 'common')
  {
    $name = $name ?: Config::get('default_validate');
    if (empty($name)) {
      return new Validate;
    }
 
    if (isset(self::$instance[$name . $layer])) {
      return self::$instance[$name . $layer];
    }
    if (strpos($name, '/')) {
      list($module, $name) = explode('/', $name);
    } else {
      $module = Request::instance()->module();
    }
    $class = self::parseClass($module, $layer, $name, $appendSuffix);
    if (class_exists($class)) {
      $validate = new $class;
    } else {
      $class = str_replace('\\' . $module . '\\', '\\' . $common . '\\', $class);
      if (class_exists($class)) {
        $validate = new $class;
      } else {
        throw new ClassNotFoundException('class not exists:' . $class, $class);
      }
    }
    self::$instance[$name . $layer] = $validate;
    return $validate;
  }
 
  /**
   * 数据库初始化 并取得数据库类实例
   * @param mixed     $config 数据库配置
   * @param bool|string  $name 连接标识 true 强制重新连接
   * @return \think\db\Connection
   */
  public static function db($config = [], $name = false)
  {
    return Db::connect($config, $name);
  }
 
  /**
   * 远程调用模块的操作方法 参数格式 [模块/控制器/]操作
   * @param string    $url     调用地址
   * @param string|array $vars     调用参数 支持字符串和数组
   * @param string    $layer    要调用的控制层名称
   * @param bool     $appendSuffix 是否添加类名后缀
   * @return mixed
   */
  public static function action($url, $vars = [], $layer = 'controller', $appendSuffix = false)
  {
    $info  = pathinfo($url);
    $action = $info['basename'];
    $module = '.' != $info['dirname'] ? $info['dirname'] : Request::instance()->controller();
    $class = self::controller($module, $layer, $appendSuffix);
    if ($class) {
      if (is_scalar($vars)) {
        if (strpos($vars, '=')) {
          parse_str($vars, $vars);
        } else {
          $vars = [$vars];
        }
      }
      return App::invokeMethod([$class, $action . Config::get('action_suffix')], $vars);
    }
  }
 
  /**
   * 字符串命名风格转换
   * type 0 将Java风格转换为C的风格 1 将C风格转换为Java的风格
   * @param string $name 字符串
   * @param integer $type 转换类型
   * @return string
   */
  public static function parseName($name, $type = 0)
  {
    if ($type) {
      return ucfirst(preg_replace_callback('/_([a-zA-Z])/', function ($match) {
        return strtoupper($match[1]);
      }, $name));
    } else {
      return strtolower(trim(preg_replace("/[A-Z]/", "_\\0", $name), "_"));
    }
  }
 
  /**
   * 解析应用类的类名
   * @param string $module 模块名
   * @param string $layer 层名 controller model ...
   * @param string $name  类名
   * @param bool  $appendSuffix
   * @return string
   */
  public static function parseClass($module, $layer, $name, $appendSuffix = false)
  {
    $name = str_replace(['/', '.'], '\\', $name);
    $array = explode('\\', $name);
    $class = self::parseName(array_pop($array), 1) . (App::$suffix || $appendSuffix ? ucfirst($layer) : '');
    $path = $array ? implode('\\', $array) . '\\' : '';
    return App::$namespace . '\\' . ($module ? $module . '\\' : '') . $layer . '\\' . $path . $class;
  }
 
  /**
   * 初始化类的实例
   * @return void
   */
  public static function clearInstance()
  {
    self::$instance = [];
  }
}
 
/**
 * 作用范围隔离
 *
 * @param $file
 * @return mixed
 */
function __include_file($file)
{
  return include $file;
}
 
function __require_file($file)
{
  return require $file;
}

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值。

收藏此文 赞一个 ( ) 打赏本站

如果本文对你有所帮助请打赏本站

  • 打赏方法如下:
  • 支付宝打赏
    支付宝扫描打赏
    微信打赏
    微信扫描打赏
后台-系统设置-扩展变量-手机广告位-内容正文底部

相关推荐:

留言与评论(共有 0 条评论)
   
验证码:
二维码