PHP 5.3新特性命名空间规则解析及高级功能

日前发布的php 5.3中，最重要的一个新特性就是命名空间的加入。本文介绍了php命名空间的一些术语，其解析规则，以及一些高级功能的应用，希望能够帮助读者在项目中真正使用命名空间。

在这里中我们介绍了php命名空间的用途和namespace关键字，在这篇文章中我们将介绍一下use命令的使用以及php如何解析命名空间的名字的。

为了便于对比，我定义了两个几乎一样的代码块，只有命名空间的名字不同。

1. < ?php  
2. // application library 1  
3. namespace app\lib1;  
4. const myconst = 'app\lib1\myconst';  
5. function myfunction() {  
6.  return __function__;  
7. }  
8. class myclass {  
9.  static function whoami() {  
10. eturn __method__;  
11.  }  
12. }  
13. ?>

lib2.php

1. < ?php  
2. // application library 2  
3. namespace app\lib2;  
5. const myconst = 'app\lib2\myconst';  
7. function myfunction() {  
8.  return __function__;  
9. }  
11. class myclass {  
12.  static function whoami() {  
13. eturn __method__;  
14.  }  
15. }  
16. ?> 

开始之前先要理解几个php命名空间相关术语。

◆完全限定名称(fully-qualified name)

任何php代码都可以引用完全限定名称，它是一个以命名空间反斜线开头的标识符，如\app\lib1\myconst，\app\lib2\myfunction( )等。

完全限定名称是没有任何歧义的，开头的反斜线和文件路径的作用有点类似，它表示“根”全局空间，如果我们在全局空间中实现了一个不同的myfunction( )，可以使用\myfunction( )从lib1.php或lib2.php调用它。

完全限定名称对一次性函数调用或对象初始化非常有用，但当你产生了大量的调用时它们就没有实用价值了，在下面的讨论中我们将会看到，php提供了其它选项以解除我们为命名空间打字的烦恼。

◆限定名称(qualified name)

至少有一个命名空间分隔符的标识符，如lib1\myfunction( )。

◆非限定名称(unqualified name)

没有命名空间分隔符的标识符，如myfunction( )。

在相同的命名空间内工作

仔细思考下面的代码：

myapp1.php

< ?php  namespace app\lib1;   require_once('lib1.php');  require_once('lib2.php');   header('content-type: text/plain');  echo myconst . "\n";  echo myfunction() . "\n";  echo myclass::whoami() . "\n";  ?>  

即使我们同时包括了lib1.php和lib2.php，myconst，myfunction和myclass标识符只能在lib1.php中引用，这是因为myapp1.php的代码在相同的app\lib1命名空间内。

执行结果：

1. app\lib1\myconst  
2. app\lib1\myfunction  
3. app\lib1\myclass::whoami  

命名空间导入

可以使用use操作符导入命名空间，如：

myapp2.php

 < ?php  

1. use app\lib2;  
3. require_once('lib1.php');  
4. require_once('lib2.php');  
6. header('content-type: text/plain');  
7. echo lib2\myconst . "\n";  
8. echo lib2\myfunction() . "\n";  
9. echo lib2\myclass::whoami() . "\n";  
10. ?>

 

可以定义任意数量的use语句，或使用逗号分隔成独立的命名空间，在这个例子中我们导入了app\lib2命名空间，但我们仍然不能直接引用 myconst，myfunction和myclass，因为我们的代码还在全局空间中，但如果我们添加了“lib2\”前缀，它们就变成限定名称 了，php将会搜索导入的命名空间，直到找到匹配项。

执行结果：

1. app\lib2\myconst  
2. app\lib2\myfunction  
3. app\lib2\myclass::whoami 

命名空间别名

命名空间别名可能是最有用的构想了，别名允许我们使用较短的名称引用很长的命名空间。

myapp3.php

1. < ?php  
2. use app\lib1 as l;  
3. use app\lib2\myclass as obj;  
5. header('content-type: text/plain');  
6. require_once('lib1.php');  
7. require_once('lib2.php');  
9. echo l\myconst . "\n";  
10. echo l\myfunction() . "\n";  
11. echo l\myclass::whoami() . "\n";  
12. echo obj::whoami() . "\n";  
13. ?>  

第一个use语句将app\lib1定义为“l”，任何使用“l”的限定名称在编译时都会被翻译成“app\lib1”，因此我们就可以引用l\myconst和l\myfunction而不是完全限定名称了。

第二个use语句定义了“obj”作为app\lib2\命名空间中myclass类的别名，这种方式只适合于类，不能用于常量和函数，现在我们就可以使用new obj( )或象上面那样运行静态方法了。

执行结果：

1. app\lib1\myconst  
2. app\lib1\myfunction  
3. app\lib1\myclass::whoami  
4. app\lib2\myclass::whoami  

php命名解析规则

php标识符名称使用下列命名空间规则进行解析，请参考php用户手册了解更详细的信息：

1.在编译时调用完全限定函数、类或常量；

2.非限定名称和限定名称根据导入规则进行翻译，例如，如果a\b\c导入为c，调用c\d\e( )就会被翻译成a\b\c\d\e( )；

3.在php命名空间内，所有限定名称尚未根据导入规则转换，例如，如果在命名空间a\b中调用c\d\e( )，那么会被翻译成a\b\c\d\e( )；

4.非限定类名称根据当前的导入规则进行转换，使用全名替换导入的短名称，例如，如果类c在命名空间a\b中被导入为x，那么new x( )就会被翻译为new a\b\c( )；

5.在命名空间中非限定函数调用在运行时解析，例如，如果myfunction( )在命名空间a\b中被调用，php首先会查找函数\a\b\myfunction( )，如果没有找到，然后会在全局空间中查找\myfunction( )；

6.调用非限定或限定类名在运行时被解析，例如，如果我们在命名空间a\b中调用new c( )，php将会查找类a\b\c，如果没有找到，php会尝试自动载入a\b\c。

php命名空间高级特性

接下来让我们看一看php命名空间的一些高级特性。

__namespace__常量

__namespace__是一个php字符串，它总是返回当前命名空间的名称，在全局空间中它是一个空字符串。

< ?php  namespace app\lib1;  echo __namespace__; // outputs: app\lib1  ?>   

这个值在调试时非常有用，它也可由于动态生成一个完全限定类名，如：

< ?php  namespace app\lib1;   class myclass {   public function whoami() {  return __method__;   }  }   $c = __namespace__ . '\\myclass';  $m = new $c;  echo $m->whoami(); // outputs: app\lib1\myclass::whoami  ?>  

namespace关键字

namespace关键字可以用于明确引用一个当前命名空间或子命名空间中的项目，它等价于类中的self命名空间：

< ?php  namespace app\lib1;   class myclass {   public function whoami() {  return __method__;   }  }   $m = new namespace\myclass;  echo $m->whoami(); // outputs: app\lib1\myclass::whoami  ?>  

自动载入命名空间类

php 5中最省时省力的特性是自动载入，在全局（非命名空间）php代码中，可以写一个标准自动载入函数：

< ?php  $obj= new myclass1(); // classes/myclass1.php is auto-loaded  $obj= new myclass2(); // classes/myclass2.php is auto-loaded   // autoload function  function __autoload($class_name) {   require_once("classes/$class_name.php");  }  ?>  

在php 5.3中，你可以创建一个命名空间类的实例，在这种情况下，完全限定命名空间和类名传递给__autoload函数，例如，$class_name的值可 能是app\lib1\myclass。你可以在相同的文件夹下放置所有的php类文件，从字符串中提取命名空间，但那样会导致文件名冲突。

另外，你的类文件层次结构会按照命名空间的结构重新组织，例如，myclass.php文件可以创建在/classes/app/lib1文件夹下：

/classes/app/lib1/myclass.php

< ?php  namespace app\lib1;   class myclass {   public function whoami() {  return __method__;   }  }  ?>  

在根文件夹下的文件就使用下面的代码了：

myapp.php

< ?php  use app\lib1\myclass as mc;   $obj = new mc();  echo $obj->whoami();   // autoload function  function __autoload($class) {   // convert namespace to full file path   $class = 'classes/' . str_replace('\\', '/', $class) . '.php';   require_once($class);  }  ?>  

解释：

1.类app\lib1\myclass的别名是mc；

2. new mc( )在编译时被翻译成new app\lib1\myclass( )；

3.字符串app\lib1\myclass被传递给__autoload函数，使用文件路径正斜线替换所有命名空间中的反斜线，然后修改字符串，classes\app\lib1\myclass.php文件被自动载入；

总结

有关php命名空间的使用就介绍到这里，希望您能够对php的命名空间有一个新的认识，并希望你能在新项目中真正使用命名空间。