PHP 命名空间规则深层应用

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

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

    lib1.php

    <?php
    // application library 1
    namespace App/Lib1;

    const MYCONST = 'App/Lib1/MYCONST';

    function MyFunction() {
     return __FUNCTION__;
    }

    class MyClass {
     static function WhoAmI() {
    eturn __METHOD__;
     }
    }
    ?>

    lib2.php

    <?php
    // application library 2
    namespace App/Lib2;

    const MYCONST = 'App/Lib2/MYCONST';

    function MyFunction() {
     return __FUNCTION__;
    }

    class MyClass {
     static function WhoAmI() {
    eturn __METHOD__;
     }
    }
    ?>

    开始之前先要理解几个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命名空间内。

    执行结果：

    App/Lib1/MYCONST App/Lib1/MyFunction App/Lib1/MyClass::WhoAmI

    命名空间导入

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

    myapp2.php

    <?php
    use App/Lib2;

    require_once('lib1.php');
    require_once('lib2.php');

    header('Content-type: text/plain');
    echo Lib2/MYCONST . "/n";
    echo Lib2/MyFunction() . "/n";
    echo Lib2/MyClass::WhoAmI() . "/n";
    ?>

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

    执行结果：

    App/Lib2/MYCONST App/Lib2/MyFunction App/Lib2/MyClass::WhoAmI

    命名空间别名

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

    myapp3.php

    <?php
    use App/Lib1 as L;
    use App/Lib2/MyClass as Obj;

    header('Content-type: text/plain');
    require_once('lib1.php');
    require_once('lib2.php');

    echo L/MYCONST . "/n";
    echo L/MyFunction() . "/n";
    echo L/MyClass::WhoAmI() . "/n";
    echo Obj::WhoAmI() . "/n";
    ?>

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

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

    执行结果：

    App/Lib1/MYCONST App/Lib1/MyFunction App/Lib1/MyClass::WhoAmI 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文件夹下：

    <?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文件被自动载入;