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

PS:年前的时候我曾对doitphp这个国产的php开发框架做过深度调整,目标一多应用(apps)统一放在webapps下,脚手架能同时处理多个app,这个已经完成.二是打通apps之间的互相调用,这个由于涉及到apps之间的复杂关系,一直都在考虑中,想通过一个好的方法去解决这个问题.偶然间深研究了一下PHP特性命名空间,让我多个月的思考立刻有了结果,就是他—-命名空间!
下面摘录了《PHP命名空间规则解析及高级功能》的内容,并进行了延伸,特总结与此

  1. 什么是命名空间

    命名空间是一种特殊的作用域,它包含处于该作用域下的标识符,同时它本身也是一种标识符.
    可以把命名空间与操作系统的目录对应起来.一个命名空间相当于一个目录,命名空间里的类,函数,常量,相当于目录里的文件.同一个目录(命名空间)里的文件名不能相同,但是不同的目录里可以有相同名字的文件.

  2. 使用命名空间为了解决什么问题?

    1. 解决名字冲突,比如定义了一个类,正好这个类与PHP内部的类或是include进来的一个类库里的类重名了.
    2. 提高代码可读性,命名空间有一个别名功能,它可以帮你给一个长达十几个字符的类名起一个别名,从而缩短代码,也不用担心与其他空间的命名冲突.

  3. 哪一些代码会受命名空间的影响.

    三类:类、函数、常量.只有它们兄弟三受影响,其他的该干嘛,还干嘛去.说到常量,php 5.3以后可以使用const关键字来定义常量,5.3前使用define,命名空间只对const关键字有效

  4. 命名空间如何定义

    1.使用 `namespace 空间名` 来申明一个空间,在namespace之前除了declare语句不能有任何其他php语句,同时也不能有任何非php代码(包括空格)
    2. 同一个命名空间是可以定义在多个文件中,这对于组织框架是非常有用的.即以同一个namespace Project;开头的文件,它们是同一个命名空间.所以注意文件之间可不要有相同的类/函数/常量名哦.
    3.当然同一个文件也可以定义多个命名空间,不过非常不建议这样做的
    命名空间案例:

            namespace Project;/*使用namespace关键词来定义空间名*/
            const MYCONST = 'Project\MYCONST';
            function MyFunction() {
                return __FUNCTION__;
            }
            class MyClass {
                static function WhoAmI() {
                    return __METHOD__;
                }
            }
            

    如何引用命名空间常量,函数,类方法:
    1.在`Project`空间下直接使用

            namespace Project;
            echo MYCONST . "";
            echo MyFunction() . "";
            echo MyClass::WhoAmI() . "";
            

    2.在其他`otherProject`空间通过’user Project’引用

            namespace otherProject;
            user Project;
    
            echo Project\MYCONST . "";
            echo Project\MyFunction() . "";
            echo Project\MyClass::WhoAmI() . "";
            
  5. 从代码理解PHP命名空间相关术语

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

      名称中包含\分隔符,并以\分隔符开始的标识符.

                      namespace Project;
                      new \OtherProject\Foo(); //调用'OtherProject'的FOO()方法,而不是Project的
                      

      完全限定名称对一次性函数调用或对象初始化非常有用,但当你产生了大量的调用时它们就没有实用价值了

    2. 限定名称(Qualified name)

      名称中含有\分隔符的标识符

                      namespace Project;
                      new Sub\Foo(); //调用Project\Sub\Foo();
                      
    3. 非限定名称(Unqualified name)

      名称中不包含\分隔符的标识符

                      namespace Project;
                      new Foo(); //调用Project\Foo();
                      foo(); //调用Project\Foo();
                      echo FOO; //调用Project\FOO;
                      
  6. use的使用:

    命名空间–别名

                namespace Project;
                use OtherNS\Sub as Other;
                use OtherNS\Sub2; //相当于use OtherNS\Sub2 as Sub2;
                use \MyClass;
    
                new Foo(); //调用Project\Foo();
                new Other\Foo(); //调用 \OtherNS\Sub\Foo();
                new Sub2\Foo(); //调用\OtherNS\Sub2\Foo();
                new MyClass(); //调用\MyClass();全局函数
            
  7. 代码演示

    app\lib1.php

            namespace lib1;
            const MYCONST = 'app\lib1\MYCONST';
            function MyFunction() {
                return __FUNCTION__;
            }
            class MyClass {
                static function WhoAmI() {
                    return __METHOD__;
                }
            }
            

    app\lib2.php

            namespace lib2;
            const MYCONST = 'app\lib2\MYCONST';
            function MyFunction() {
                return __FUNCTION__;
            }
            class MyClass {
                static function WhoAmI() {
                return __METHOD__;
                }
            }
            
  8. 在相同的命名空间内工作

    1. myapp1.php

      app/myapp1.php

                      namespace lib1;
                      require_once('lib1.php');
                      require_once('lib2.php');
                      echo MYCONST . "";
                      echo MyFunction() . "";
                      echo MyClass::WhoAmI() . "";
                      
    2. 执行结果:

                      app\lib1\MYCONST
                      app\lib1\MyFunction
                      app\lib1\MyClass::WhoAmI
                      

      原理分析:由于MYCONST,MyFunction和MyClass都在’app\lib1′空间下,所以引用相同命名空间lib1.php中的(常量/方法/类)

  9. 命名空间导入

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

    1. myapp2.php

      app/myapp2.php

                      use lib2;
                      require_once('lib1.php');
                      require_once('lib2.php');
                      echo Lib2\MYCONST . "";
                      echo Lib2\MyFunction() . "";
                      echo Lib2\MyClass::WhoAmI() . "";
                      
    2. 执行结果:

                      app\lib2\MYCONST
                      app\lib2\MyFunction
                      app\lib2\MyClass::WhoAmI
                      

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

  10. 命名空间别名

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

    1. myapp3.php

                      #app/myapp3.php
                      use lib1 as L;
                      use lib2\MyClass as Obj;
                      require_once('lib1.php');
                      require_once('lib2.php');
                      echo L\MYCONST . "";
                      echo L\MyFunction() . "";
                      echo L\MyClass::WhoAmI() . "";
                      echo Obj::WhoAmI() . "";
                      
    2. 执行结果:

                      app\lib1\MYCONST
                      app\lib1\MyFunction
                      app\lib1\MyClass::WhoAmI
                      app\lib2\MyClass::WhoAmI
                      

      原理分析:第一个use语句将app\lib1定义为“L”,任何使用“L”的限定名称在编译时都会被翻译成“app\lib1”,因此我们就可以引用L\MYCONST和L\MyFunction而不是完全限定名称了.第二个use语句定义了“obj”作为app\lib2\命名空间中MyClass类的别名,这种方式只适合于类,不能用于常量和函数,现在我们就可以使用new Obj( )或象上面那样运行静态方法了

  11. 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

  12. 自动载入命名空间类

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

                      function __autoload($class_name) {
                      require_once("$class_name.php");
                      }
                      
    2. 命名空间类的实例

                      #app/lib1/MyClass.php
                      namespace app\lib1;
                      class MyClass {
                          static function WhoAmI() {
                              return __METHOD__;
                          }
                      }
                      
    3. 延伸命名空间的自动加载函数

                      #app/main.php
                      use app\lib1\MyClass;
                      $obj = new MyClass();
                      echo $obj->WhoAmI();
                      function __autoload($class) {
                          $class = str_replace('\\', '/', $class) . '.php';
                          require_once($class);
                      }
                      

      分析:
      1.类app\lib1\MyClass
      2. new MyClass( )在编译时被翻译成new app\lib1\MyClass( )
      3.字符串app\lib1\MyClass被传递给__autoload函数,使用文件路径正斜线替换所有命名空间中的反斜线,然后修改字符串,app\lib1\MyClass.php文件被自动载入

    4. 延伸命名空间别名的自动加载函数

                      #app/main.php
                      use app\lib1\MyClass as MC;
                      $obj = new MC();
                      echo $obj->WhoAmI();
                      function __autoload($class) {
                          $class = str_replace('\\', '/', $class) . '.php';
                          require_once($class);
                      }
                      

      分析:
      1.类app\lib1\MyClass的别名是MC
      2. new MC( )在编译时被翻译成new app\lib1\MyClass( )
      3.字符串app\lib1\MyClass被传递给__autoload函数,使用文件路径正斜线替换所有命名空间中的反斜线,然后修改字符串,app\lib1\MyClass.php文件被自动载入


参考:
1.PHP命名空间规则解析及高级功能
1.php官方手册–命名空间概述

相关文章
  1. $_GET,$_POST与urldecode的使用风险
  2. yii2框架的错误处理
  3. Yii2过滤器-behaviors()行为调用
  4. 密码保护:PHP多进程编程
  5. 全排列算法原理和实现
  6. PHP静态方法和非静态方法的使用场景
本站版权
1、本站所有主题由该文章作者发表,该文章作者与尘埃享有文章相关版权
2、其他单位或个人使用、转载或引用本文时必须同时征得该文章作者和尘埃的同意
3、本帖部分内容转载自其它媒体,但并不代表本站赞同其观点和对其真实性负责
4、如本帖侵犯到任何版权问题,请立即告知本站,本站将及时予与删除并致以最深的歉意
5、原文链接:
二维码
Posted in php, 命名空间, 编程语言
Comments are closed.