thinkPHP5.0框架命名空间详解


Posted in PHP onMarch 18, 2017

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

命名空间

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

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

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

// 错误的用法
$class = new stdClass();
$xml = new SimpleXmlElement($xmlstr);
// 正确的用法
$class = new \stdClass();
$xml = new \SimpleXmlElement($xmlstr);

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

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

namespace think\cache\driver;
class File
{
}

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

$class = new \think\cache\driver\File();

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

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

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

我们实例化

$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命名空间,例如下面的代码:

Route::get('hello','index/hello');

请自行使用:

use think\Route

或者:

\think\Route::get('hello','index/hello');

自动注册

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

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

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

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

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

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

define('EXTEND_PATH','../vendor/');

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

手动注册

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

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

\think\Loader::addNamespace('my','../application/extend/my/');

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

\think\Loader::addNamespace([
 'my' => '../application/extend/my/',
 'org' => '../application/extend/org/',
]);

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

'root_namespace' => [
 'my' => '../application/extend/my/',
 'org' => '../application/extend/org/',
]

应用类库包

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

namespace app\index\model;
class User extends \think\Model
{
}

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

namespace app\admin\Event;
class User
{
}

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

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

'app_namespace' => 'application',

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

namespace application\index\model;
class User extends \think\Model
{
}

命名空间别名

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

namespace app\index\model;
use think\Model;
class User extends Model
{
}

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

namespace app\index\controller;
use app\index\model\User;
class Index
{
 public function index()
 {
  $user = new User();
 }
}

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

\think\Loader::addNamespaceAlias('model','app\index\model');

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

namespace app\index\controller;
use model\User;
class Index
{
 public function index()
 {
  $user = new User();
 }
}

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

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

PHP 相关文章推荐
php 模拟POST|GET操作实现代码
Jul 20 PHP
基于PHP静态类的原罪详解
May 06 PHP
php实现文件下载(支持中文文名)
Dec 04 PHP
2个自定义的PHP in_array 函数,解决大量数据判断in_array的效率问题
Apr 08 PHP
php使用pack处理二进制文件的方法
Jul 03 PHP
ThinkPHP3.2.2的插件控制器功能简述
Jul 09 PHP
php基于mcrypt的加密解密实例
Oct 27 PHP
php结合js实现点击超链接执行删除确认操作
Oct 31 PHP
php生成shtml类用法实例
Dec 09 PHP
php生成与读取excel文件
Oct 14 PHP
PHP上传Excel文件导入数据到MySQL数据库示例
Oct 25 PHP
php实现socket推送技术的示例
Dec 20 PHP
thinkPHP5.0框架自动加载机制分析
Mar 18 #PHP
thinkPHP5.0框架引入Traits功能实例分析
Mar 18 #PHP
2017年最新PHP经典面试题目汇总(上篇)
Mar 17 #PHP
thinkPHP5.0框架API优化后的友好性分析
Mar 17 #PHP
thinkPHP5.0框架配置格式、加载解析与读取方法
Mar 17 #PHP
thinkPHP5.0框架独立配置与动态配置方法
Mar 17 #PHP
PHP中类的自动加载的方法
Mar 17 #PHP
You might like
BBS(php & mysql)完整版(三)
2006/10/09 PHP
php初始化对象和析构函数的简单实例
2014/03/11 PHP
PHP计算日期相差天数实例分析
2016/02/23 PHP
php 算法之实现相对路径的实例
2017/10/17 PHP
比较全面的event对像在IE与FF中的区别 推荐
2009/09/21 Javascript
利用js获取服务器时间的两个简单方法
2010/01/08 Javascript
web页面数据展示新想法(json)
2010/06/08 Javascript
推荐一个封装好的getElementsByClassName方法
2014/12/02 Javascript
JS简单实现多级Select联动菜单效果代码
2015/09/06 Javascript
学习JavaScript设计模式(代理模式)
2015/12/03 Javascript
基于javascript实现简单的抽奖系统
2020/04/15 Javascript
Bootstrap每天必学之警告框插件
2016/04/26 Javascript
Angular.js中定时器循环的3种方法总结
2017/04/27 Javascript
jQuery实现键盘回车搜索功能
2017/07/25 jQuery
jQuery实现form表单序列化转换为json对象功能示例
2018/05/23 jQuery
ng-zorro-antd 入门初体验
2018/12/03 Javascript
如何封装了一个vue移动端下拉加载下一页数据的组件
2019/01/06 Javascript
vue自定义表单生成器form-create使用详解
2019/07/19 Javascript
javascript设计模式 ? 代理模式原理与用法实例分析
2020/04/16 Javascript
python基础教程之lambda表达式使用方法
2014/02/12 Python
Python中对元组和列表按条件进行排序的方法示例
2015/11/10 Python
详解Python中的Numpy、SciPy、MatPlotLib安装与配置
2017/11/17 Python
Python基于opencv调用摄像头获取个人图片的实现方法
2019/02/21 Python
python selenium firefox使用详解
2019/02/26 Python
Python递归函数实例讲解
2019/02/27 Python
一篇文章搞定Python操作文件与目录
2019/08/13 Python
tensorflow 只恢复部分模型参数的实例
2020/01/06 Python
H5调用相机拍照并压缩图片的实例代码
2017/07/20 HTML / CSS
Vuori官网:运动服装的终级表现
2021/01/27 全球购物
面向对象概念面试题(.NET)
2016/11/04 面试题
护理自荐信
2013/10/22 职场文书
个人催款函范文
2015/06/24 职场文书
学子宴致辞大全
2015/07/27 职场文书
2019年第四季度财务部门工作计划
2019/11/02 职场文书
java.util.NoSuchElementException原因及两种解决方法
2022/06/28 Java/Android
Valheim服务器 Mod修改安装教程 【ValheimPlus】
2022/12/24 Servers