一、命名空间概述
支持命名空间,php版本需要>=5.3.0。从广义上来说,命名空间是一种封装事物的方法。在很多地方都可以见到这种抽象概念。例如,在操作系统中目录用来将相关文件分组,对于目录中的文件来说,它就扮演了命名空间的角色。具体举个例子,文件foo.txt 可以同时在目录/home/greg 和 /home/other 中存在,但在同一个目录中不能存在两个 foo.txt 文件。另外,在目录 /home/greg 外访问 foo.txt 文件时,我们必须将目录名以及目录分隔符放在文件名之前得到/home/greg/foo.txt。这个原理应用到程序设计领域就是命名空间的概念。
在PHP中,命名空间用来解决编写类库或应用程序时创建可重用的代码如类或函数时遇到的两类问题:
1. 用户编写的代码与PHP内部的类/函数/常量或第三方类/函数/常量之间的名字冲突。
2. 为很长的标识符名称(通常是为了缓解第一类问题而定义的)创建一个别名(或简短)的名称,提高源代码的可读性。
二、定义命名空间
1、虽然任意合法的PHP代码都可以包含在命名空间中,但只有类(包括抽象类和traits)、接口、函数和常量受命名空间的影响。
2、命名空间通过关键字namespace来声明,如果一个文件中包含命名空间,它必须在其它所有代码之前声明命名空间,除了用于定义源文件编码格式的关键词declare。
3、所有非PHP代码包括空白符也不能出现在命名空间的声明之前,另外,与PHP其它的语言特征不同,同一个命名空间可以定义在多个文件中,即允许将同一个命名空间的内容分割存放在不同的文件中。
A、声明单个命名空间
<span style="font-family:SimHei;font-size:18px;"><?php
namespace MyProject;
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
?></span>
B、与目录和文件的关系很象,PHP 命名空间也允许指定层次化的命名空间的名称。因此,命名空间的名字可以使用分层次的方式定义。
<?php
namespace MyProject\Sub\Level;
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
?>
C、也可以在同一个文件中定义多个命名空间
<span style="font-family:SimHei;font-size:18px;"><?php
namespace MyProject {
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
}
namespace AnotherProject {
const CONNECT_OK = 1;
class Connection { /* ... */ }
function connect() { /* ... */ }
}
?></span>
三、使用命名空间
PHP命名空间中的元素可以通过三种方式引用
1、非限定名称,或不包含前缀的类名称,例如 $a=new foo(); 如果当前命名空间是currentnamespace,foo将被解析为 currentnamespace\foo,如果使用 foo 的代码是全局的,不包含在任何命名空间中的代码,则 foo 会被解析为foo,取决于当前代码所处的命名空间。注意:如果命名空间中的函数或常量未定义,则该非限定的函数名称或常量名称会被解析为全局函数名称或常量名称。
2、限定名称或包含前缀的名称,例如 $a = new subnamespace\foo();如果当前的命名空间是currentnamespace,则foo会被解析为 currentnamespace\subnamespace\foo。如果使用 foo 的代码是全局的,不包含在任何命名空间中的代码,foo 会被解析为subnamespace\foo。
3、完全限定名称或包含了全局前缀操作符的名称,例如:$a = new \currentnamespace\foo(); 解析结果则不受当前命名空间的影响,直接解析为该完全限定的名称。
PHP支持两种抽象的访问当前命名空间内部元素的方法,__NAMESPACE__ 魔术常量和namespace关键字。常量__NAMESPACE__的值是包含当前命名空间名称的字符串,在全局的不包括在任何命名空间中的代码,它包含的是一个空的字符串。
四、别名/导入(注意别名/导入命名空间的前提是该命名空间所在的文件已经被require或include)
命名空间的一个重要特征是允许通过别名引用或导入外部的完全限定名称,这有点类似于在类 unix 文件系统中可以创建对其它的文件或目录的符号连接。所有支持命名空间的PHP版本支持三种别名或导入方式:为类名称使用别名、为接口使用别名或为命名空间名称使用别名,PHP 5.6开始允许使用use关键字导入函数或常量或者为它们设置别名。
注:引用或取别名的命名空间名称,前导的反斜杠是不必要的也不推荐的,因为导入的名称必须是完全限定的,不会根据当前的命名空间作相对解析。(相当于默认在取别名/导入的名称前加前缀\)
<span style="font-family:SimHei;font-size:18px;"><?php
namespace foo;
use My\Full\Classname as Another;
// 等价于use My\Full\NSname as NSname
use My\Full\NSname;
// 导入一个全局类
use ArrayObject;
// importing a function (PHP 5.6+)
use function My\Full\functionName;
// aliasing a function (PHP 5.6+)
use function My\Full\functionName as func;
// importing a constant (PHP 5.6+)
use const My\Full\CONSTANT;
$obj = new namespace\Another; // 实例化 foo\Another 对象
$obj = new Another; // 实例化 My\Full\Classname 对象
NSname\subns\func(); // 调用函数 My\Full\NSname\subns\func
$a = new ArrayObject(array(1)); // 实例化 ArrayObject 对象
// 如果不使用 "use \ArrayObject" ,则实例化一个 foo\ArrayObject 对象
func(); // calls function My\Full\functionName
echo CONSTANT; // echoes the value of My\Full\CONSTANT
?></span>
五、全局空间
如果没有定义任何命名空间,所有的类与函数的定义都是在全局空间,与 PHP引入命名空间概念前一样。在引用的名称前加上前缀 \ 表示该名称是全局空间中的名称,即使该名称位于其它的命名空间中时也是如此。
<span style="font-family:SimHei;font-size:18px;"><?php
namespace A\B\C;
/* 这个函数是 A\B\C\fopen */
function fopen() {
/* ... */
$f = \fopen(...); // 调用全局的fopen函数
return $f;
}
?></span>