PHP 命名空间(namesp...LOGIN
简体中文（ZH-CN）English（EN）繁体中文（ZH-TW）日本語（JA）한국어（KO）Melayu（MS）Français（FR）Deutsch（DE）

PHP 命名空间(namespace)

PHP 命名空间(namespace)是在PHP 5.3中加入的

什么是命名空间？从广义上来说，命名空间是一种封装事物的方法。在很多地方都可以见到这种抽象概念。例如，在操作系统中目

录用来将相关文件分组，对于目录中的文件来说，它就扮演了命名空间的角色。具体举个例子，文件 foo.txt 可以同时在目

录/home/greg 和 /home/other 中存在，但在同一个目录中不能存在两个 foo.txt 文件。另外，在目录 /home/greg 外访问 

foo.txt 文件时，我们必须将目录名以及目录分隔符放在文件名之前得到 /home/greg/foo.txt。这个原理应用到程序设计领域就是


命名空间的概念。 

PHP 命名空间可以解决以下两类问题：

1.    用户编写的代码与PHP内部的类/函数/常量或第三方类/函数/常量之间的名字冲突。

2.    为很长的标识符名称(通常是为了缓解第一类问题而定义的)创建一个别名（或简短）的名称，提高源代码的可读性。

定义命名空间

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

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

语法格式如下：

<?php
// 定义代码在 'MyProject' 命名空间中
namespace MyProject;
// ... 代码 ...
?>
你也可以在同一个文件中定义不同的命名空间代码，如：
<?php
namespace MyProject1;
// MyProject1 命名空间中的PHP代码
namespace MyProject2;
// MyProject2 命名空间中的PHP代码
// 另一种语法
namespace MyProject3 {
// MyProject3 命名空间中的PHP代码
}
?>

在声明命名空间之前唯一合法的代码是用于定义源文件编码方式的 declare 语句。另外，所有非 PHP 代码包括空白符都不能出现在命名空间的声明之前：

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

而下面的代码就会报错

<html>
 <?php
 namespace MyProject; // 命名空间前出现了“<html>” 会致命错误 -　命名空间必须是程序脚本的第一条语句
 ?>

子命名空间

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

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

上面的例子创建了常量 MyProjectSubLevelCONNECT_OK，类 MyProjectSubLevelConnection 和函数MyProjectSubLevelConnect。

命名空间使用

在讨论如何使用命名空间之前，必须了解 PHP 是如何知道要使用哪一个命名空间中的元素的。可以将 PHP 命名空间与文件系统作一个简单的类比。在文件系统中访问一个文件有三种方式：

   1. 相对文件名形式如foo.txt。它会被解析为 currentdirectory/foo.txt，其中 currentdirectory 表示当前目录。因此如果当前目录是 /home/foo，则该文件名被解析为/home/foo/foo.txt。

  2. 相对路径名形式如subdirectory/foo.txt。它会被解析为 currentdirectory/subdirectory/foo.txt。      

  3. 绝对路径名形式如/main/foo.txt。它会被解析为/main/foo.txt。

PHP 命名空间中的元素使用同样的原理。例如，类名可以通过三种方式引用：

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

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

3.    完全限定名称，或包含了全局前缀操作符的名称，例如， $a = new currentnamespacefoo(); 或 currentnamespacefoo::staticmethod();。在这种情况下，foo 总是被解析为代码中的文字名(literal name)currentnamespacefoo。

下面是一个使用这三种方式的实例：

实例

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

实例

<?php
 namespace Foo\Bar;
 include 'file1.php';
 
 const FOO = 2;
 function foo() {}
 class foo
 {
     static function staticmethod() {}
 }
 
 /* 非限定名称 */
 foo(); // 解析为 Foo\Bar\foo resolves to function Foo\Bar\foo
 foo::staticmethod(); // 解析为类 Foo\Bar\foo的静态方法staticmethod。resolves to class Foo\Bar\foo, method staticmethod
 echo FOO; // resolves to constant Foo\Bar\FOO
 
 /* 限定名称 */
 subnamespace\foo(); // 解析为函数 Foo\Bar\subnamespace\foo
 subnamespace\foo::staticmethod(); // 解析为类 Foo\Bar\subnamespace\foo,
 // 以及类的方法 staticmethod
 echo subnamespace\FOO; // 解析为常量 Foo\Bar\subnamespace\FOO
 
 /* 完全限定名称 */
 \Foo\Bar\foo(); // 解析为函数 Foo\Bar\foo
 \Foo\Bar\foo::staticmethod(); // 解析为类 Foo\Bar\foo, 以及类的方法 staticmethod
 echo \Foo\Bar\FOO; // 解析为常量 Foo\Bar\FOO
 ?>

注意访问任意全局类、函数或常量，都可以使用完全限定名称，例如 strlen() 或 Exception 或 INI_ALL。

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

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

命名空间和动态语言特征

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

实例

<?php
 class 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 funcname
 echo constant('constname'), "\n"; // prints global
 ?>

 程序运行结果：

classname::__construct funcname global

 必须使用完全限定名称（包括命名空间前缀的类名称）。注意因为在动态的类名称、函数名称或常量名称中，限定名称和完全限定名称没有区别，因此其前导的反斜杠是不必要的。

实例

动态访问命名空间的元素

<?php
 namespace namespacename;
 class classname
 {
     function __construct()
     {
         echo __METHOD__,"\n";
     }
 }
 function funcname()
 {
     echo __FUNCTION__,"\n";
 }
 const constname = "namespaced";
 
 include 'example1.php';
 
 $a = 'classname';
 $obj = new $a; // prints classname::__construct
 $b = 'funcname';
 $b(); // prints funcname
 echo constant('constname'), "\n"; // prints global
 /* note that if using double quotes, "\namespacename\classname" must be used */
 $a = '\namespacename\classname';
 $obj = new $a; // prints namespacename\classname::__construct
 $a = 'namespacename\classname';
 $obj = new $a; // also prints namespacename\classname::__construct
 $b = 'namespacename\funcname';
 $b(); // prints namespacename\funcname
 $b = '\namespacename\funcname';
 $b(); // also prints namespacename\funcname
 echo constant('\namespacename\constname'), "\n"; // prints namespaced
 echo constant('namespacename\constname'), "\n"; // also prints namespaced
 ?>

 程序运行结果：

classname::__construct funcname global classname::__construct funcname global namespacenameclassname::__construct namespacenameclassname::__construct namespacenamefuncname namespacenamefuncname namespaced namespaced

namespace关键字和__NAMESPACE__常量

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

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

实例

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

<?php
 namespace MyProject;
 header("Content-type:text/html;charset=utf-8");    //设置编码
 echo '"', __NAMESPACE__, '"'; // 输出 "MyProject"
 ?>

程序运行结果：

"MyProject"

实例

__NAMESPACE__ 示例，全局代码

<?php
 header("Content-type:text/html;charset=utf-8");    //设置编码
 
 echo '"', __NAMESPACE__, '"'; // 输出 "MyProject"
 ?>

程序运行结果：

""

实例

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

使用__NAMESPACE__动态创建名称

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

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

实例

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

<?php
 namespace 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操作符, 全局代码

<?php
 namespace\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不支持导入函数或常量。

在PHP中，别名是通过操作符 use 来实现的. 下面是一个使用所有可能的三种导入方式的例子：

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

<?php
 namespace 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语句

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

3、导入和动态名称  

<?php
 use My\Full\Classname as Another, My\Full\NSname;
 
 $obj = new Another; // 实例化一个 My\Full\Classname 对象
 $a = 'Another';
 $obj = new $a;      // 实际化一个 Another 对象
 ?>

4、导入和完全限定名称 

<?php
 use My\Full\Classname as Another, My\Full\NSname;
 
 $obj = new Another; // instantiates object of class My\Full\Classname
 $obj = new \Another; // instantiates object of class Another
 $obj = new Another\thing; // instantiates object of class My\Full\Classname\thing
 $obj = new \Another\thing; // instantiates object of class Another\thing
 ?>

使用命名空间：后备全局函数/常量

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

例如：

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

<?php
 namespace 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、 命名空间中后备的全局函数/常量 

<?php
 namespace 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_ALL
 
 echo strlen('hi'), "\n"; // 输出 "1"
 if (is_array('hi')) { // 输出 "is not array"
     echo "is array\n";
 } else {
     echo "is not array\n";
 }
 ?>

全局空间

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

实例

使用全局空间说明 

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

命名空间的顺序

自从有了命名空间之后，最容易出错的该是使用类的时候，这个类的寻找路径是什么样的了。

<?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"
 ?>

名称解析遵循下列规则：

1.    对完全限定名称的函数，类和常量的调用在编译时解析。例如 new AB 解析为类 AB。

2.    所有的非限定名称和限定名称（非完全限定名称）根据当前的导入规则在编译时进行转换。例如，如果命名空间 ABC 被导入为 C，那么对 CDe() 的调用就会被转换为 ABCDe()。

3.    在命名空间内部，所有的没有根据导入规则转换的限定名称均会在其前面加上当前的命名空间名称。例如，在命名空间 AB 内部调用CDe()，则 CDe() 会被转换为 ABCDe() 。

4.    非限定类名根据当前的导入规则在编译时转换（用全名代替短的导入名称）。例如，如果命名空间 ABC 导入为C，则 new C() 被转换为 new ABC() 。

5.    在命名空间内部（例如AB），对非限定名称的函数调用是在运行时解析的。例如对函数 foo() 的调用是这样解析的：

1.    在当前命名空间中查找名为 ABfoo() 的函数

2.    尝试查找并调用 全局(global) 空间中的函数 foo()。

6.    在命名空间（例如AB）内部对非限定名称或限定名称类（非完全限定名称）的调用是在运行时解析的。下面是调用 new C() 及 new DE() 的解析过程： new C()的解析:

1.    在当前命名空间中查找ABC类。

2.    尝试自动装载类ABC。

new DE()的解析:

3.    在类名称前面加上当前命名空间名称变成：ABDE，然后查找该类。

4.    尝试自动装载类 ABDE。

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



下一节
<?php namespace namespacename; class classname { function __construct() { echo __METHOD__,"\n"; } } function funcname() { echo __FUNCTION__,"\n"; } const constname = "namespaced"; include 'example1.php'; $a = 'classname'; $obj = new $a; // prints classname::__construct $b = 'funcname'; $b(); // prints funcname echo constant('constname'), "\n"; // prints global /* note that if using double quotes, "\\namespacename\\classname" must be used */ $a = '\namespacename\classname'; $obj = new $a; // prints namespacename\classname::__construct $a = 'namespacename\classname'; $obj = new $a; // also prints namespacename\classname::__construct $b = 'namespacename\funcname'; $b(); // prints namespacename\funcname $b = '\namespacename\funcname'; $b(); // also prints namespacename\funcname echo constant('\namespacename\constname'), "\n"; // prints namespaced echo constant('namespacename\constname'), "\n"; // also prints namespaced ?>
提交重置代码
章节课件