• 命名空间 转


    PHP命名空间规则解析及高级功能

    2010-03-09 17:48 来源:中国站长站综合 编辑:水色皇朝【纠错1人评论

    A-A+

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

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

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

    1. < ?php  
    2. // application library 1  
    3. namespace AppLib1;  
    4. const MYCONST = 'AppLib1MYCONST';  
    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 AppLib2;  
    4.  
    5. const MYCONST = 'AppLib2MYCONST';  
    6.  
    7. function MyFunction() {  
    8.  return __FUNCTION__;  
    9. }  
    10.  
    11. class MyClass {  
    12.  static function WhoAmI() {  
    13. eturn __METHOD__;  
    14.  }  
    15. }  
    16. ?> 

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

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

    任何PHP代码都可以引用完全限定名称,它是一个以命名空间反斜线开头的标识符,如AppLib1MYCONST,AppLib2MyFunction( )等。

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

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

    ◆限定名称(Qualified name)

    至少有一个命名空间分隔符的标识符,如Lib1MyFunction( )。

    ◆非限定名称(Unqualified name)

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

    在相同的命名空间内工作

    仔细思考下面的代码:

    myapp1.php

    1. < ?php  
    2. namespace AppLib1;  
    3.  
    4. require_once('lib1.php');  
    5. require_once('lib2.php');  
    6.  
    7. header('Content-type: text/plain');  
    8. echo MYCONST . " ";  
    9. echo MyFunction() . " ";  
    10. echo MyClass::WhoAmI() . " ";  
    11. ?>  

    即使我们同时包括了lib1.php和lib2.php,MYCONST,MyFunction和MyClass标识符只能在lib1.php中引用,这是因为myapp1.php的代码在相同的AppLib1命名空间内。

    执行结果:

    1. AppLib1MYCONST  
    2. AppLib1MyFunction  
    3. AppLib1MyClass::WhoAmI  

    命名空间导入

    可以使用use操作符导入命名空间,如:

    myapp2.php

     
    1. < ?php  
    2. use AppLib2;  
    3.  
    4. require_once('lib1.php');  
    5. require_once('lib2.php');  
    6.  
    7. header('Content-type: text/plain');  
    8. echo Lib2MYCONST . " ";  
    9. echo Lib2MyFunction() . " ";  
    10. echo Lib2MyClass::WhoAmI() . " ";  
    11. ?>  

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

    执行结果:

    1. AppLib2MYCONST  
    2. AppLib2MyFunction  
    3. AppLib2MyClass::WhoAmI 

    命名空间别名

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

    myapp3.php

    1. < ?php  
    2. use AppLib1 as L;  
    3. use AppLib2MyClass as Obj;  
    4.  
    5. header('Content-type: text/plain');  
    6. require_once('lib1.php');  
    7. require_once('lib2.php');  
    8.  
    9. echo LMYCONST . " ";  
    10. echo LMyFunction() . " ";  
    11. echo LMyClass::WhoAmI() . " ";  
    12. echo Obj::WhoAmI() . " ";  
    13. ?>  

    第一个use语句将AppLib1定义为“L”,任何使用“L”的限定名称在编译时都会被翻译成“AppLib1”,因此我们就可以引用LMYCONST和LMyFunction而不是完全限定名称了。

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

    执行结果:

    1. AppLib1MYCONST  
    2. AppLib1MyFunction  
    3. AppLib1MyClass::WhoAmI  
    4. AppLib2MyClass::WhoAmI  

    PHP命名解析规则

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

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

    2.非限定名称和限定名称根据导入规则进行翻译,例如,如果ABC导入为C,调用CDe( )就会被翻译成ABCDe( );

    3.在PHP命名空间内,所有限定名称尚未根据导入规则转换,例如,如果在命名空间AB中调用CDe( ),那么会被翻译成ABCDe( );

    4.非限定类名称根据当前的导入规则进行转换,使用全名替换导入的短名称,例如,如果类C在命名空间AB中被导入为X,那么new X( )就会被翻译为new ABC( );

    5.在命名空间中非限定函数调用在运行时解析,例如,如果MyFunction( )在命名空间AB中被调用,PHP首先会查找函数ABMyFunction( ),如果没有找到,然后会在全局空间中查找MyFunction( );

    6.调用非限定或限定类名在运行时被解析,例如,如果我们在命名空间AB中调用new C( ),PHP将会查找类ABC,如果没有找到,PHP会尝试自动载入ABC。

    PHP命名空间高级特性

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

    __NAMESPACE__常量

    __NAMESPACE__是一个PHP字符串,它总是返回当前命名空间的名称,在全局空间中它是一个空字符串。

    1. < ?php  
    2. namespace AppLib1;  
    3. echo __NAMESPACE__; // outputs: AppLib1  
    4. ?>  
    5.  

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

    1. < ?php  
    2. namespace AppLib1;  
    3.  
    4. class MyClass {  
    5.  public function WhoAmI() {  
    6. return __METHOD__;  
    7.  }  
    8. }  
    9.  
    10. $c = __NAMESPACE__ . '\MyClass';  
    11. $m = new $c;  
    12. echo $m->WhoAmI(); // outputs: AppLib1MyClass::WhoAmI  
    13. ?>  

    namespace关键字

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

    1. < ?php  
    2. namespace AppLib1;  
    3.  
    4. class MyClass {  
    5.  public function WhoAmI() {  
    6. return __METHOD__;  
    7.  }  
    8. }  
    9.  
    10. $m = new namespaceMyClass;  
    11. echo $m->WhoAmI(); // outputs: AppLib1MyClass::WhoAmI  
    12. ?>  

    自动载入命名空间类

    PHP 5中最省时省力的特性是自动载入,在全局(非命名空间)PHP代码中,可以写一个标准自动载入函数:

    1. < ?php  
    2. $objnew MyClass1(); // classes/MyClass1.php is auto-loaded  
    3. $objnew MyClass2(); // classes/MyClass2.php is auto-loaded  
    4.  
    5. // autoload function  
    6. function __autoload($class_name) {  
    7.  require_once("classes/$class_name.php");  
    8. }  
    9. ?>  

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

    另外,你的类文件层次结构会按照命名空间的结构重新组织,例如,MyClass.php文件可以创建在/classes/App/Lib1文件夹下:

    /classes/App/Lib1/MyClass.php

    1. < ?php  
    2. namespace AppLib1;  
    3.  
    4. class MyClass {  
    5.  public function WhoAmI() {  
    6. return __METHOD__;  
    7.  }  
    8. }  
    9. ?>  

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

    myapp.php

    1. < ?php  
    2. use AppLib1MyClass as MC;  
    3.  
    4. $obj = new MC();  
    5. echo $obj->WhoAmI();  
    6.  
    7. // autoload function  
    8. function __autoload($class) {  
    9.  // convert namespace to full file path  
    10.  $class = 'classes/' . str_replace('\', '/', $class) . '.php';  
    11.  require_once($class);  
    12. }  
    13. ?>  

    解释:

    1.类AppLib1MyClass的别名是MC;

    2. new MC( )在编译时被翻译成new AppLib1MyClass( );

    3.字符串AppLib1MyClass被传递给__autoload函数,使用文件路径正斜线替换所有命名空间中的反斜线,然后修改字符串,classesAppLib1MyClass.php文件被自动载入;

    总结

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

  • 相关阅读:
    vue首页组件切换
    vue 页面 添加背景音乐
    vue 新闻列表滚动效果
    vuex中的this.$store.commit
    echarts图例的位置及大小,环图中间字
    octotree — 树形展示 Github 项目代码
    D3 GEO应用专题(一):绘制旋转的3D地球
    vue/cli 3.0脚手架搭建vue项目
    微软锁屏壁纸
    Spring Boot构建RESTful API与单元测试
  • 原文地址:https://www.cnblogs.com/clphp/p/5133843.html
Copyright © 2020-2023  润新知