查看: 541|回复: 0

[PHP学习] thinkPHP5.0框架命名空间详解

发表于 2018-2-7 08:00:03

本文实例讲述了thinkPHP5.0框架命名空间。分享给大家供大家参考,具体如下:

命名空间

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

如果不清楚命名空间的基本概念,可以参考PHP手册:PHP命名空间

特别注意的是,如果你需要调用PHP内置的类库,或者第三方没有使用命名空间的类库,记得在实例化类库的时候加上 \,例如:

  1. // 错误的用法
  2. $class = new stdClass();
  3. $xml = new SimpleXmlElement($xmlstr);
  4. // 正确的用法
  5. $class = new \stdClass();
  6. $xml = new \SimpleXmlElement($xmlstr);
复制代码

在ThinkPHP5.0中,只需要给类库正确定义所在的命名空间,并且命名空间的路径与类库文件的目录一致,那么就可以实现类的自动加载,从而实现真正的惰性加载。

例如,\think\cache\driver\File类的定义为:

  1. namespace think\cache\driver;
  2. class File
  3. {
  4. }
复制代码

如果我们实例化该类的话,应该是:

  1. $class = new \think\cache\driver\File();
复制代码

系统会自动加载该类对应路径的类文件,其所在的路径是 thinkphp/library/think/cache/driver/File.php。

5.0默认的目录规范是小写,类文件命名是驼峰法,并且首字母大写。

原则上,可以支持驼峰法命名的目录,只要命名空间定义和目录一致即可,例如:

我们实例化

  1. $class = new \Think\Cache\Driver\File();
复制代码

系统则会自动加载 thinkphp/library/Think/Cache/Driver/File.php文件。

根命名空间(类库包)

根命名空间是一个关键的概念,以上面的\think\cache\driver\File类为例,think就是一个根命名空间,其对应的初始命名空间目录就是系统的类库目录(thinkphp/library/think),我们可以简单的理解一个根命名空间对应了一个类库包。

系统内置的几个根命名空间(类库包)如下:

名称 描述 类库目录
think 系统核心类库 thinkphp/library/think
traits 系统Trait类库 thinkphp/library/traits
app 应用类库 application

如果需要增加新的根命名空间,有两种方式:注册新的根命名空间或者放入EXTEND_PATH目录(自动注册)

请注意本文中的示例代码为了简洁,如无指定类库的命名空间的话,都表示指的是think命名空间,例如下面的代码:

  1. Route::get('hello','index/hello');
复制代码

请自行使用:

  1. use think\Route
复制代码

或者:

  1. \think\Route::get('hello','index/hello');
复制代码

自动注册

我们只需要把自己的类库包目录放入EXTEND_PATH目录(extend,可配置),就可以自动注册对应的命名空间,例如:

我们在extend目录下面新增一个my目录,然后定义一个\my\Test类( 类文件位于extend/my/Test.php)如下:

  1. namespace my;
  2. class Test
  3. {
  4. public function sayHello()
  5. {
  6. echo 'hello';
  7. }
  8. }
复制代码

我们就可以直接实例化和调用:

  1. $Test = new \my\Test();
  2. $Test->sayHello();
复制代码

如果我们在应用入口文件中重新定义了EXTEND_PATH常量的话,还可以改变\my\Test类文件的位置,例如:

  1. define('EXTEND_PATH','../vendor/');
复制代码

那么\my\Test类文件的位置就变成了/vendor/my/File.php。

手动注册

也可以通过手动注册的方式注册新的根命名空间,例如:

在应用入口文件中添加下面的代码:

  1. \think\Loader::addNamespace('my','../application/extend/my/');
复制代码

如果要同时注册多个根命名空间,可以使用:

  1. \think\Loader::addNamespace([
  2. 'my' => '../application/extend/my/',
  3. 'org' => '../application/extend/org/',
  4. ]);
复制代码

也可以直接在应用的配置文件中添加配置,系统会在应用执行的时候自动注册。

  1. 'root_namespace' => [
  2. 'my' => '../application/extend/my/',
  3. 'org' => '../application/extend/org/',
  4. ]
复制代码

应用类库包

为了避免和Composer自动加载的类库存在冲突 ,应用类库的命名空间的根都统一以app命名,例如:

  1. namespace app\index\model;
  2. class User extends \think\Model
  3. {
  4. }
复制代码

其类文件位于 application/index/model/User.php。

  1. namespace app\admin\Event;
  2. class User
  3. {
  4. }
复制代码

其类文件位于 application/admin/event/User.php。

如果觉得app根命名空间不合适或者有冲突,可以在应用配置文件中修改:

  1. 'app_namespace' => 'application',
复制代码

定义后,应用类库的命名空间改为:

  1. namespace application\index\model;
  2. class User extends \think\Model
  3. {
  4. }
复制代码

命名空间别名

框架允许给命名空间定义别名,例如:

  1. namespace app\index\model;
  2. use think\Model;
  3. class User extends Model
  4. {
  5. }
复制代码

原来在控制器里面调用方式为:

  1. namespace app\index\controller;
  2. use app\index\model\User;
  3. class Index
  4. {
  5. public function index()
  6. {
  7. $user = new User();
  8. }
  9. }
复制代码

如果我们在应用公共文件中注册命名空间别名如下:

  1. \think\Loader::addNamespaceAlias('model','app\index\model');
复制代码

那么,上面的控制器代码就可以更改为:

  1. namespace app\index\controller;
  2. use model\User;
  3. class Index
  4. {
  5. public function index()
  6. {
  7. $user = new User();
  8. }
  9. }
复制代码

本文后续的章节,均建立在你已经了解PHP命名空间的基础之上,如果不掌握请自行补充PHP基础,否则你在后续的文档和ThinkPHP5.0的学习过程中,对命名空间的缺乏理解会成为你最大的学习障碍。

更多关于thinkPHP相关内容感兴趣的读者可查看本站专题:《ThinkPHP入门教程》、《thinkPHP模板操作技巧总结》、《ThinkPHP常用方法总结》、《codeigniter入门教程》、《CI(CodeIgniter)框架进阶教程》、《Zend FrameWork框架入门教程》、《smarty模板入门基础教程》及《PHP模板技术总结》。

希望本文所述对大家基于ThinkPHP框架的PHP程序设计有所帮助。

您可能感兴趣的文章:

  • Thinkphp模板中使用自定义函数的方法
  • Thinkphp模板中截取字符串函数简介
  • ThinkPHP模板自定义标签使用方法
  • ThinkPHP模板比较标签用法详解
  • ThinkPHP使用smarty模板引擎的方法
  • 浅析ThinkPHP的模板输出功能
  • Thinkphp模板没有解析直接原样输出的解决方法
  • ThinkPHP模板之变量输出、自定义函数与判断语句用法
  • thinkphp模板继承实例简述
  • thinkPHP5.0框架模块设计详解
  • thinkPHP5.0框架安装教程
  • thinkPHP5框架渲染模板的3种方式简述


回复

使用道具 举报