PHP 命名空间可以办理以下两类问题:

用户编写的代码与PHP内部的类/函数/常量或第三方类/函数/常量之间的名字冲突。
为很长的标识符名称(常日是为了缓解第一类问题而定义的)创建一个别名(或简短)的名称,提高源代码的可读性。

定义命名空间

默认情形下,所有常量、类和函数名都放在全局空间下,就和PHP支持命名空间之前一样。

php命名空间教程PHP法式员从入门到佛系第二十弹PHP 定名空间namespace RESTful API

命名空间通过关键字namespace 来声明。
如果一个文件中包含命名空间,它必须在其它所有代码之前声明命名空间。
语法格式如下;

<?php // 定义代码在 'MyProject' 命名空间中 namespace MyProject; // ... 代码 ...

你也可以在同一个文件中定义不同的命名空间代码,如:

<?php namespace MyProject;const CONNECT_OK = 1;class Connection { / ... / }function connect() { / ... / }namespace AnotherProject;const CONNECT_OK = 1;class Connection { / ... / }function connect() { / ... / }?>

不建议利用这种语法在单个文件中定义多个命名空间。
建议利用下面的大括号形式的语法。

<?phpnamespace MyProject { const CONNECT_OK = 1; class Connection { / ... / } function connect() { / ... / }}namespace AnotherProject { const CONNECT_OK = 1; class Connection { / ... / } function connect() { / ... / }}?>

将全局的非命名空间中的代码与命名空间中的代码组合在一起,只能利用大括号形式的语法。
全局代码必须用一个不带名称的 namespace 语句加上大括号括起来,例如:

<?phpnamespace MyProject {const CONNECT_OK = 1;class Connection { / ... / }function connect() { / ... / }}namespace { // 全局代码session_start();$a = MyProject\connect();echo MyProject\Connection::start();}?>

在声明命名空间之前唯一合法的代码是用于定义源文件编码办法的 declare 语句。
所有非 PHP 代码包括空缺符都不能涌如今命名空间的声明之前。

<?phpdeclare(encoding='UTF-8'); //定义多个命名空间和不包含在命名空间中的代码namespace MyProject {const CONNECT_OK = 1;class Connection { / ... / }function connect() { / ... / }}namespace { // 全局代码session_start();$a = MyProject\connect();echo MyProject\Connection::start();}?>

以下代码会涌现语法缺点:

<html><?phpnamespace MyProject; // 命名空间前涌现了“<html>” 会致命缺点 - 命名空间必须是程序脚本的第一条语句?>

子命名空间

与目录和文件的关系很像,PHP 命名空间大概可指定层次化的命名空间的名称。
因此,命名空间的名字可以利用分层次的办法定义:

<?phpnamespace MyProject\Sub\Level; //声明分层次的单个命名空间const CONNECT_OK = 1;class Connection { / ... / }function Connect() { / ... / }?>

上面的例子创建了常量 MyProject\Sub\Level\CONNECT_OK,类 MyProject\Sub\Level\Connection 和函数 MyProject\Sub\Level\Connect。

命名空间利用

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。

下面是一个利用这三种办法的实例:

file1.php 文件代码

<?phpnamespace Foo\Bar\subnamespace; const FOO = 1;function foo() {}class foo{ static function staticmethod() {}}?>

file2.php 文件代码

<?phpnamespace Foo\Bar;include 'file1.php';const FOO = 2;function foo() {}class foo{ static function staticmethod() {}}/ 非限定名称 /foo(); // 解析为函数 Foo\Bar\foofoo::staticmethod(); // 解析为类 Foo\Bar\foo ,方法为 staticmethodecho FOO; // 解析为常量 Foo\Bar\FOO/ 限定名称 /subnamespace\foo(); // 解析为函数 Foo\Bar\subnamespace\foosubnamespace\foo::staticmethod(); // 解析为类 Foo\Bar\subnamespace\foo, // 以及类的方法 staticmethodecho subnamespace\FOO; // 解析为常量 Foo\Bar\subnamespace\FOO / 完备限定名称 /\Foo\Bar\foo(); // 解析为函数 Foo\Bar\foo\Foo\Bar\foo::staticmethod(); // 解析为类 Foo\Bar\foo, 以及类的方法 staticmethodecho \Foo\Bar\FOO; // 解析为常量 Foo\Bar\FOO?>

把稳访问任意全局类、函数或常量,都可以利用完备限定名称,例如 \strlen() 或 \Exception 或 \INI_ALL。

在命名空间内部访问全局类、函数和常量:

<?phpnamespace Foo;function strlen() {}const INI_ALL = 3;class Exception {}$a = \strlen('hi'); // 调用全局函数strlen$b = \INI_ALL; // 访问全局常量 INI_ALL$c = new \Exception('error'); // 实例化全局类 Exception?>

命名空间和动态措辞特色

PHP 命名空间的实现受到其措辞自身的动态特色的影响。
因此,如果要将下面的代码转换到命名空间中,动态访问元素。

example1.php 文件代码:

<?phpclass classname{ function __construct() { echo __METHOD__,\"大众\n\公众; }}function funcname(){ echo __FUNCTION__,\"大众\n\公众;}const constname = \"大众global\"大众;$a = 'classname';$obj = new $a; // prints classname::__construct$b = 'funcname';$b(); // prints funcnameecho constant('constname'), \"大众\n\"大众; // prints global?>

必须利用完备限定名称(包括命名空间前缀的类名称)。
把稳由于在动态的类名称、函数名称或常量名称中,限定名称和完备限定名称没有差异,因此其前导的反斜杠是不必要的。

动态访问命名空间的元素

<?phpnamespace namespacename;class classname{ function __construct() { echo __METHOD__,\"大众\n\公众; }}function funcname(){ echo __FUNCTION__,\公众\n\公众;}const constname = \公众namespaced\公众;include 'example1.php';$a = 'classname';$obj = new $a; // 输出 classname::__construct$b = 'funcname';$b(); // 输出函数名echo constant('constname'), \公众\n\"大众; // 输出 global/ 如果利用双引号,利用方法为 \"大众\\namespacename\\classname\"大众/$a = '\namespacename\classname';$obj = new $a; // 输出 namespacename\classname::__construct$a = 'namespacename\classname';$obj = new $a; // 输出 namespacename\classname::__construct$b = 'namespacename\funcname';$b(); // 输出 namespacename\funcname$b = '\namespacename\funcname';$b(); // 输出 namespacename\funcnameecho constant('\namespacename\constname'), \公众\n\"大众; // 输出 namespacedecho constant('namespacename\constname'), \公众\n\"大众; // 输出 namespaced?>

namespace关键字和__NAMESPACE__常量

PHP支持两种抽象的访问当前命名空间内部元素的方法,__NAMESPACE__ 魔术常量和namespace关键字。

常量__NAMESPACE__的值是包含当前命名空间名称的字符串。
在全局的,不包括在任何命名空间中的代码,它包含一个空的字符串。

__NAMESPACE__ 示例, 在命名空间中的代码

<?phpnamespace MyProject;echo '\公众', __NAMESPACE__, '\"大众'; // 输出 \公众MyProject\公众?>

__NAMESPACE__ 示例,全局代码

<?phpecho '\公众', __NAMESPACE__, '\"大众'; // 输出 \"大众\公众?>

常量 __NAMESPACE__ 在动态创建名称时很有用,例如:

利用__NAMESPACE__动态创建名称

<?phpnamespace MyProject;function get($classname){ $a = __NAMESPACE__ . '\\' . $classname; return new $a;}?>

关键字 namespace 可用来显式访问当前命名空间或子命名空间中的元素。
它等价于类中的 self 操作符。

namespace操作符,命名空间中的代码

<?phpnamespace MyProject;use blah\blah as mine; // see \"大众Using namespaces: importing/aliasing\"大众blah\mine(); // calls function blah\blah\mine()namespace\blah\mine(); // calls function MyProject\blah\mine()namespace\func(); // calls function MyProject\func()namespace\sub\func(); // calls function MyProject\sub\func()namespace\cname::method(); // calls static method \公众method\"大众 of class MyProject\cname$a = new namespace\sub\cname(); // instantiates object of class MyProject\sub\cname$b = namespace\CONSTANT; // assigns value of constant MyProject\CONSTANT to $b?>

namespace操作符, 全局代码

<?phpnamespace\func(); // calls function func()namespace\sub\func(); // calls function sub\func()namespace\cname::method(); // calls static method \公众method\"大众 of class cname$a = new namespace\sub\cname(); // instantiates object of class sub\cname$b = namespace\CONSTANT; // assigns value of constant CONSTANT to $b?>

利用命名空间:别名/导入

PHP 命名空间支持 有两种利用别名或导入办法:为类名称利用别名,或为命名空间名称利用别名。

在PHP中,别名是通过操作符 use 来实现的. 下面是一个利用所有可能的三种导入办法的例子:

1、利用use操作符导入/利用别名

<?phpnamespace foo;use My\Full\Classname as Another;// 下面的例子与 use My\Full\NSname as NSname 相同use My\Full\NSname;// 导入一个全局类use \ArrayObject;$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 工具?>

2、 一行中包含多个use语句

<?phpuse My\Full\Classname as Another, My\Full\NSname;$obj = new Another; // 实例化 My\Full\Classname 工具NSname\subns\func(); // 调用函数 My\Full\NSname\subns\func?>

导入操作是在编译实行的,但动态的类名称、函数名称或常量名称则不是。

3、导入和动态名称

<?phpuse My\Full\Classname as Another, My\Full\NSname;$obj = new Another; // 实例化一个 My\Full\Classname 工具$a = 'Another';$obj = new $a; // 实际化一个 Another 工具?>

其余,导入操作只影响非限定名称和限定名称。
完备限定名称由于是确定的,故不受导入的影响。

4、导入和完备限定名称

<?phpuse My\Full\Classname as Another, My\Full\NSname;$obj = new Another; // 实例化 My\Full\Classname 类$obj = new \Another; // 实例化 Another 类$obj = new Another\thing; // 实例化 My\Full\Classname\thing 类$obj = new \Another\thing; // 实例化 Another\thing 类?>

利用命名空间:后备全局函数/常量

在一个命名空间中,当 PHP 碰着一个非限定的类、函数或常量名称时,它利用不同的优先策略来解析该名称。
类名称总是解析到当前命名空间中的名称。
因此在访问系统内部或不包含在命名空间中的类名称时,必须利用完备限定名称,例如:

1、在命名空间中访问全局类

<?phpnamespace A\B\C;class Exception extends \Exception {}$a = new Exception('hi'); // $a 是类 A\B\C\Exception 的一个工具$b = new \Exception('hi'); // $b 是类 Exception 的一个工具$c = new ArrayObject; // 致命缺点, 找不到 A\B\C\ArrayObject 类?>

对付函数和常量来说,如果当前命名空间中不存在该函数或常量,PHP 会退而利用全局空间中的函数或常量。

2、 命名空间中后备的全局函数/常量

<?phpnamespace A\B\C;const E_ERROR = 45;function strlen($str){ return \strlen($str) - 1;}echo E_ERROR, \"大众\n\公众; // 输出 \"大众45\"大众echo INI_ALL, \公众\n\"大众; // 输出 \"大众7\"大众 - 利用全局常量 INI_ALLecho strlen('hi'), \"大众\n\"大众; // 输出 \公众2\"大众if (is_array('hi')) { // 输出 \"大众is not array\公众 echo \公众is array\n\"大众;} else { echo \公众is not array\n\"大众;}?>

全局空间

如果没有定义任何命名空间,所有的类与函数的定义都是在全局空间,与 PHP 引入命名空间观点前一样。
在名称前加上前缀 \ 表示该名称是全局空间中的名称,纵然该名称位于其它的命名空间中时也是如此。

利用全局空间解释

<?phpnamespace A\B\C;/ 这个函数是 A\B\C\fopen /function fopen() { / ... / $f = \fopen(...); // 调用全局的fopen函数 return $f;} ?>

命名空间的顺序

自从有了命名空间之后,最随意马虎出错的该是利用类的时候,这个类的探求路径是什么样的了。

<?phpnamespace 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\"大众 的 \"大众foo\"大众 方法 // 如果类 \公众A\B\"大众 未找到,则考试测验自动装载类 \"大众A\B\"大众?>

名称解析遵照下列规则:

对完备限定名称的函数,类和常量的调用在编译时解析。
例如 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() 的调用是这样解析的:在当前命名空间中查找名为 A\B\foo() 的函数考试测验查找并调用 全局(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()

条记:

可以把非限定名称类比为文件名(例如 comment.php)、.限定名称类比为相对路径名(例如 ./article/comment.php)、完备限定名称类比为绝对路径名(例如 /blog/article/comment.php),这样可能会更随意马虎理解。

再添一例:

<?php //创建空间Blognamespace Blog;class Comment { }//非限定名称,表示当前Blog空间//这个调用将被解析成 Blog\Comment();$blog_comment = new Comment();//限定名称,表示相对付Blog空间//这个调用将被解析成 Blog\Article\Comment();$article_comment = new Article\Comment(); //类前面没有反斜杆\//完备限定名称,表示绝对付Blog空间//这个调用将被解析成 Blog\Comment();$article_comment = new \Blog\Comment(); //类前面有反斜杆\//完备限定名称,表示绝对付Blog空间//这个调用将被解析成 Blog\Article\Comment();$article_comment = new \Blog\Article\Comment(); //类前面有反斜杆\//创建Blog的子空间Articlenamespace Blog\Article;class Comment { }?>