PHP 面向对象程序设计(oop)学习笔记 (五) - PHP 命名空间


Posted in PHP onJune 12, 2014

命名空间概述

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

用户编写的代码与PHP内部的类/函数/常量或第三方类/函数/常量之间的名字冲突。
为很长的标识符名称(通常是为了缓解第一类问题而定义的)创建一个别名(或简短)的名称,提高源代码的可读性。
PHP 命名空间提供了一种将相关的类、函数和常量组合到一起的途径。下面是一个说明 PHP 命名空间语法的示例:

定义命名空间

虽然任意合法的PHP代码都可以包含在命名空间中,但只有三种类型的代码受命名空间的影响,它们是:类,函数和常量。命名空间通过关键字namespace 来声明。如果一个文件中包含命名空间,它必须在其它所有代码之前声明命名空间。另外,与PHP其它的语言特征不同,同一个命名空间可以定义在多个文件中,即允许将同一个命名空间的内容分割存放在不同的文件中。当然你也可以在同一个文件中定义多个命名空间。

namespace MyProject;
class MyClass
{
    #code...
}

定义子命名空间:与目录和文件的关系很象,PHP 命名空间也允许指定层次化的命名空间的名称。因此,命名空间的名字可以使用分层次的方式定义:

namespace MyProject\helper\http;
class MyClass
{
    #code...
}

在同一个文件中定义多个命名空间:在同一个文件中声明多个命名空间有两种方式,不过在实际编程实践中,非常不提倡在同一个文件中定义多戈命名空间。这种方式的主要用于将多个 PHP 脚本合并在同一个文件中。下面列出第一种方法。

namespace MyProject\helper\http;
class MyClass
{
    #code...
}
namespace MyProject\helper\request;
class MyClass
{
    #code...
}

不过强烈不建议使用这种方法,可以参考下面的大括号定义法:

namespace MyProject\helper\http;
{
    class MyClass
    {
        #code...
    }
}
namespace MyProject\helper\request;
{
    class MyClass
    {
        #code...
    }
}

PHP 命名空间中的元素使用

在讨论如何使用命名空间之前,必须了解 PHP 是如何知道要使用哪一个命名空间中的元素的。类名可以通过三种方式引用:

非限定名称,或不包含前缀的类名称,例如 $a=new foo(); 或 foo::staticmethod();。如果当前命名空间是 currentnamespace,foo 将被解析为 currentnamespace\foo。如果使用 foo 的代码是全局的,不包含在任何命名空间中的代码,则 foo 会被解析为foo。 警告:如果命名空间中的函数或常量未定义,则该非限定的函数名称或常量名称会被解析为全局函数名称或常量名称。详情参见 使用命名空间:后备全局函数名称/常量名称。

限定名称,或包含前缀的名称,例如 $a = new subnamespace\foo(); 或 subnamespace\foo::staticmethod();。如果当前的命名空间是 currentnamespace,则 foo 会被解析为 currentnamespace\subnamespace\foo。如果使用 foo 的代码是全局的,不包含在任何命名空间中的代码,foo 会被解析为subnamespace\foo。

完全限定名称,或包含了全局前缀操作符的名称,例如, $a = new \currentnamespace\foo(); 或 \currentnamespace\foo::staticmethod();。在这种情况下,foo 总是被解析为代码中的文字名(literal name)currentnamespace\foo。
使用命名空间:别名/导入

允许通过别名引用或导入外部的完全限定名称,是命名空间的一个重要特征。PHP 命名空间支持 有两种使用别名或导入方式:为类名称使用别名,或为命名空间名称使用别名。在PHP中,别名是通过操作符 use 来实现的。

注意PHP不支持导入函数或常量。

namespace foo;
use My\Full\Classname as Another;
// 下面的例子与 use My\Full\NSname as NSname 相同
use My\Full\NSname;
// 导入一个全局类
use \ArrayObject;

名称解析规则

在说明名称解析规则之前,我们先看一些重要的定义:

非限定名称Unqualified name:名称中不包含命名空间分隔符的标识符,例如 Foo
限定名称Qualified name:名称中含有命名空间分隔符的标识符,例如 Foo\Bar
完全限定名称Fully qualified name:名称中包含命名空间分隔符,并以命名空间分隔符开始的标识符,例如 \Foo\Bar。 namespace\Foo 也是一个完全限定名称。
名称解析遵循下列规则:

对完全限定名称的函数,类和常量的调用在编译时解析。例如 new \A\B 解析为类 A\B。
所有的非限定名称和限定名称(非完全限定名称)根据当前的导入规则在编译时进行转换。例如,如果命名空间 A\B\C 被导入为 C,那么对 C\D\e() 的调用就会被转换为 A\B\C\D\e()。
在命名空间内部,所有的没有根据导入规则转换的限定名称均会在其前面加上当前的命名空间名称。例如,在命名空间 A\B 内部调用 C\D\e(),则 C\D\e() 会被转换为 A\B\C\D\e() 。
非限定类名根据当前的导入规则在编译时转换(用全名代替短的导入名称)。例如,如果命名空间 A\B\C 导入为C,则 new C() 被转换为 new A\B\C() 。
在命名空间内部(例如A\B),对非限定名称的函数调用是在运行时解析的。例如对函数 foo() 的调用是这样解析的:
1) 在当前命名空间中查找名为 A\B\foo() 的函数
2) 尝试查找并调用 全局(global) 空间中的函数 foo()。
在命名空间(例如A\B)内部对非限定名称或限定名称类(非完全限定名称)的调用是在运行时解析的。下面是调用 new C() 及 new D\E() 的解析过程: new C()的解析:
在当前命名空间中查找A\B\C类。
尝试自动装载类A\B\C。

new D\E()的解析:
在类名称前面加上当前命名空间名称变成:A\B\D\E,然后查找该类。
尝试自动装载类 A\B\D\E。

为了引用全局命名空间中的全局类,必须使用完全限定名称 new \C()。

Example 名称解析示例

<?php
namespace A;
use B\D, C\E as F;
// 函数调用
foo();      // 首先尝试调用定义在命名空间"A"中的函数foo()
            // 再尝试调用全局函数 "foo"
\foo();     // 调用全局空间函数 "foo" 
my\foo();   // 调用定义在命名空间"A\my"中函数 "foo" 
F();        // 首先尝试调用定义在命名空间"A"中的函数 "F" 
            // 再尝试调用全局函数 "F"
// 类引用
new B();    // 创建命名空间 "A" 中定义的类 "B" 的一个对象
            // 如果未找到,则尝试自动装载类 "A\B"
new D();    // 使用导入规则,创建命名空间 "B" 中定义的类 "D" 的一个对象
            // 如果未找到,则尝试自动装载类 "B\D"
new F();    // 使用导入规则,创建命名空间 "C" 中定义的类 "E" 的一个对象
            // 如果未找到,则尝试自动装载类 "C\E"
new \B();   // 创建定义在全局空间中的类 "B" 的一个对象
            // 如果未发现,则尝试自动装载类 "B"
new \D();   // 创建定义在全局空间中的类 "D" 的一个对象
            // 如果未发现,则尝试自动装载类 "D"
new \F();   // 创建定义在全局空间中的类 "F" 的一个对象
            // 如果未发现,则尝试自动装载类 "F"
// 调用另一个命名空间中的静态方法或命名空间函数
B\foo();    // 调用命名空间 "A\B" 中函数 "foo"
B::foo();   // 调用命名空间 "A" 中定义的类 "B" 的 "foo" 方法
            // 如果未找到类 "A\B" ,则尝试自动装载类 "A\B"
D::foo();   // 使用导入规则,调用命名空间 "B" 中定义的类 "D" 的 "foo" 方法
            // 如果类 "B\D" 未找到,则尝试自动装载类 "B\D"
\B\foo();   // 调用命名空间 "B" 中的函数 "foo" 
\B::foo();  // 调用全局空间中的类 "B" 的 "foo" 方法
            // 如果类 "B" 未找到,则尝试自动装载类 "B"
// 当前命名空间中的静态方法或函数
A\B::foo();   // 调用命名空间 "A\A" 中定义的类 "B" 的 "foo" 方法
              // 如果类 "A\A\B" 未找到,则尝试自动装载类 "A\A\B"
\A\B::foo();  // 调用命名空间 "A\B" 中定义的类 "B" 的 "foo" 方法
              // 如果类 "A\B" 未找到,则尝试自动装载类 "A\B"
?>
PHP 相关文章推荐
PHP文本数据库的搜索方法
Oct 09 PHP
php is_file 判断给定文件名是否为一个正常的文件
May 10 PHP
php操作xml
Oct 27 PHP
php自动识别文件编码并转换为UTF-8的方法
Jun 12 PHP
PHPer 需要了解的 5 个 Composer 小技巧
Aug 18 PHP
php截取中文字符串函数实例
Feb 23 PHP
php结合正则批量抓取网页中邮箱地址
May 19 PHP
PHP基于phpqrcode生成带LOGO图像的二维码实例
Jul 10 PHP
yii数据库的查询方法
Dec 28 PHP
PHP中key和current,next的联合运用实例分析
Mar 29 PHP
php 的反射详解及示例代码
Aug 25 PHP
详解Yii2 之 生成 URL 的方法
Jun 16 PHP
新浪SAE云平台下使用codeigniter的数据库配置
Jun 12 #PHP
Codeigniter整合Tank Auth权限类库详解
Jun 12 #PHP
PHP错误Cannot use object of type stdClass as array in错误的解决办法
Jun 12 #PHP
php自动识别文件编码并转换为UTF-8的方法
Jun 12 #PHP
codeigniter集成ucenter1.6双向通信的解决办法
Jun 12 #PHP
使用CodeIgniter的类库做图片上传
Jun 12 #PHP
Codeigniter出现错误提示Error with CACHE directory的解决方案
Jun 12 #PHP
You might like
php的一个登录的类 [推荐]
2007/03/16 PHP
php中关于普通表单多文件上传的处理方法
2011/03/25 PHP
PHP加密解密字符串汇总
2015/04/26 PHP
php实现点击可刷新验证码
2015/11/07 PHP
PHP采用超长(超大)数字运算防止数字以科学计数法显示的方法
2016/04/01 PHP
导入extjs、jquery 文件时$使用冲突问题解决方法
2014/01/14 Javascript
javascript简单性能问题及学习笔记
2014/02/04 Javascript
JavaScript定义变量和变量优先级问题探讨
2014/10/11 Javascript
js实现右下角提示框的方法
2015/02/03 Javascript
学习JavaScript设计模式(单例模式)
2015/11/26 Javascript
基于Bootstrap里面的Button dropdown打造自定义select
2016/05/30 Javascript
JS构造函数与原型prototype的区别介绍
2016/07/04 Javascript
JavaScript 轮播图和自定义滚动条配合鼠标滚轮分享代码贴
2016/10/28 Javascript
深入理解JavaScript继承的多种方式和优缺点
2017/05/12 Javascript
react-router4 嵌套路由的使用方法
2017/07/24 Javascript
微信小程序实现选项卡功能
2020/06/19 Javascript
微信小程序自定义对话框弹出和隐藏动画
2018/07/19 Javascript
微信小程序webview与h5通过postMessage实现实时通讯的实现
2019/08/20 Javascript
基于原生JS封装的Modal对话框插件的示例代码
2020/09/09 Javascript
Python单元测试框架unittest使用方法讲解
2015/04/13 Python
python并发和异步编程实例
2018/11/15 Python
Python I/O与进程的详细讲解
2019/03/08 Python
通过python调用adb命令对App进行性能测试方式
2020/04/23 Python
Django 实现 Websocket 广播、点对点发送消息的代码
2020/06/03 Python
Python实现计算图像RGB均值方式
2020/06/04 Python
python smtplib发送多个email联系人的实现
2020/10/09 Python
Python导入父文件夹中模块并读取当前文件夹内的资源
2020/11/19 Python
Selenium 配置启动项参数的方法
2020/12/04 Python
CPB肌肤之钥美国官网:Clé de Peau Beauté
2017/09/05 全球购物
Artist Guitars新西兰:乐器在线商店
2017/09/17 全球购物
优衣库台湾官网:UNIQLO台湾
2019/02/01 全球购物
马来西亚奢侈品牌购物商城:Valiram 247
2020/09/29 全球购物
护士的岗位职责
2013/12/04 职场文书
幼儿园教师国培感言
2014/02/02 职场文书
python爬取企查查企业信息之selenium自动模拟登录企查查
2021/04/08 Python
Android开发之底部导航栏的快速实现
2022/04/28 Java/Android