命名空间

ThinkPHP 3.2.2

命名空间

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

命名空间的概念必须了解,否则会成为3.2版本开发的重大障碍。
如果不清楚什么是命名空间,可以参考PHP手册:PHP命名空间

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

namespace Org\Util;
class File {
}

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

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

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

注意:和3.1不同,我们无需在实例化命名空间定义的类之前导入类库文件了。

根命名空间

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

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

namespace My;
class Test {
    public function sayHello(){
        echo 'hello';
    }
}

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

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

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

namespace Home\Model;
class UserModel extends \Think\Model {
}

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

namespace Admin\Event;
class UserEvent {
}

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

3.2.1版本以上的话,允许设置对应用类库不使用命名空间,你在配置文件中进行如下设置:

'APP_USE_NAMESPACE'    =>    false,

那么,所有的应用类库不再需要使用命名空间定义,但继承和调用核心类和系统类的时候,仍然需要使用命名空间,例如:

class UserModel extends \Think\Model {
}

特别注意:如果你需要在3.2版本中实例化PHP内置的类库或者第三方的没有使用命名空间定义的类,需要采用下面的方式:

$class =    new \stdClass();
$sxml  =    new \SimpleXmlElement($xmlstr);