thinkphp 命名空间

Posted 2020-08-25 不见晨曦的占星师

什么是命名空间？从广义上来说，命名空间是一种封装事物的方法。在很多地方都可以见到这种抽象概念。例如，在操作系统中目录用来将相关文件分组，对于目录中的文件来说，它就扮演了命名空间的角色。具体举个例子，文件 foo.txt 可以同时在目录/home/greg 和 /home/other 中存在，但在同一个目录中不能存在两个 foo.txt 文件。另外，在目录 /home/greg 外访问 foo.txt 文件时，我们必须将目录名以及目录分隔符放在文件名之前得到 /home/greg/foo.txt。这个原理应用到程序设计领域就是命名空间的概念。

在php中，命名空间用来解决在编写类库或应用程序时创建可重用的代码如类或函数时碰到的两类问题：

 

1. 用户编写的代码与PHP内部的类/函数/常量或第三方类/函数/常量之间的名字冲突。（？？？？？？）
2. 为很长的标识符名称(通常是为了缓解第一类问题而定义的)创建一个别名（或简短）的名称，提高源代码的可读性。（？？？？？？）

 

PHP 命名空间提供了一种将相关的类、函数和常量组合到一起的途径。下面是一个说明 PHP 命名空间语法的示例：

Example #1 命名空间语法示例

<?php
namespace my\name; // 参考 "定义命名空间" 小节

class MyClass {}
function myfunction() {}
const MYCONST = 1;

$a = new MyClass;
$c = new \my\name\MyClass; // 参考 "全局空间" 小节

$a = strlen(‘hi‘); // 参考 "使用命名空间：后备全局函数/常量" 小节

$d = namespace\MYCONST; // 参考 "namespace操作符和__NAMESPACE__常量” 小节

$d = __NAMESPACE__ . ‘\MYCONST‘;
echo constant($d); // 参考 "命名空间和动态语言特征" 小节
?>

 

Note:

名为PHP或php的命名空间，以及以这些名字开头的命名空间（例如PHP\Classes）被保留用作语言内核使用，而不应该在用户空间的代码中使用。（？？？？？？？）

 

3.2版本全面采用命名空间方式定义和加载类库文件，有效的解决多个模块之间的冲突问题，并且实现了更加高效的类库自动加载机制。（？？？？？？）

由于新版完全采用了命名空间的特性，因此只需要给类库正确定义所在的命名空间，而命名空间的路径与类库文件的目录一致，那么就可以实现类的自动加载。 例如，Org\Util\File类的定义为：

1. namespace Org\Util;
2. class File {
3. }

其所在的路径是 ThinkPHP/Library/Org/Util/File.class.php，因此，如果我们实例化该类的话：

1. $class = new \Org\Util\File();

系统会自动加载 ThinkPHP/Library/Org/Util/File.class.php 文件。

根命名空间

根命名空间是一个关键的概念，以上面的Org\Util\File类为例，Org就是一个根命名空间，其对应的初始命名空间目录就是系统的类库目录（ThinkPHP/Library），Library目录下面的子目录会自动识别为根命名空间，这些命名空间无需注册即可使用。

例如，我们在Library目录下面新增一个My根命名空间目录，然后定义一个Test类如下：

1. namespace My;
2. class Test {
3. public function sayHello(){
4. echo ‘hello‘;
5. }
6. }

Test类保存在 ThinkPHP/Library/My/Test.class.php，我们就可以直接实例化和调用：

1. $Test = new \My\Test();
2. $Test->sayHello();

模块中的类库命名空间的根都是以模块名命名，例如：

1. namespace Home\Model;
2. class UserModel extends \Think\Model {
3. }

其类文件位于 Application/Home/Model/UserModel.class.php。

1. namespace Admin\Event;
2. class UserEvent {
3. }

其类文件位于 Application/Admin/Event/UserEvent.class.php。