PHP 命名空间总结

PHP 5.3 及以上版本中引入了命名空间 的概念。

 

notes：

1. 在 PHP 中，命名空间用来解决在编写 类库 或 应用程序 时创建 可重用 的 代码如 类 或 函数 时碰到的两类问题：

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

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

 

2. 如果一个文件中包含命名空间，它必须在其它所有代码之前声明命名空间。

【例1】同目录下的两个 php 文件

file 1：Member.php

<?php
namespace member;

class Member {
    public $name;
}

 

file 2：test.php

<?php
namespace test;
include 'Member.php';

$res = new \member\Member();

var_dump($res);

引用 Member 类时需要使用 命名空间运算符（namespace operater，就是类前面的那个反斜杠），PHP 将从命名空间栈的顶部开始查找类。

 

要引用 Member 类，需要知道当前文件在哪一个命名空间中，如：

a. 在 member 命名空间中，Member 类称为 Member

b. 在 全局命名空间 中，称为 member/Member

c. 在 其他命名空间中，称为 \member\Member

 

执行 test.php，输出：

object(member\Member)[1]
  public 'name' => null

 

 

3. 定义子命名空间

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

 

4. 使用命名空间：别名 / 导入

允许通过别名引用或导入外部的完全限定名称，是命名空间的一个重要特征。这有点类似于在类 unix 文件系统中可以创建对其它的文件或目录的符号连接。

所有支持命名空间的PHP版本支持三种别名或导入方式：为类名称使用别名、为接口使用别名或为命名空间名称使用别名。PHP 5.6 开始允许导入函数或常量或者为它们设置别名。

 

【例2】

file 1：Member.php

<?php
namespace MyProject\member;

class Member {
    public $name;
    public static function getName(){
        return 'my name is dee';
    }
}

 

file 2: test.php

<?php
namespace test;
use MyProject\member;
include 'Member.php';

echo member\Member::getName();

或

<?php
namespace test;
use MyProject\member as m;
include 'Member.php';

echo m\Member::getName();

输出：my name is dee

 

至于在框架中没有使用 include 函数 是由于使用了 __autoload 函数自动加载文件，但是该函数只能在 非命名控件下 定义，也就是 全局 情况下：

Member.php

<?php

class Member {
    public $name;
    public static function getName(){
        return 'my name is dee';
    }
}

 

test.php

<?php

function __autoload($classname){
    include $classname.'.php';
}    


echo Member::getName();

 

如果在已经有了 命名空间 的类中，可以使用函数 spl_auto_register 来注册一个类中的方法来代替 __autoload 函数（参见 http://blog.csdn.net/sky_zhe/article/details/38523145）。

 

 

5. 可以通过 __NAMESPACE__ 查看当前明明空间：

<?php
namespace test;

function testNamespace(){
    return __NAMESPACE__;
}

echo testNamespace();

输出：test

 

 

附：TP 3.2 手册中关于命名空间

 

参考：

http://www.php.net/manual/zh/language.namespaces.php

http://www.oschina.net/question/147332_138188

http://higrid.net/hi/docs/php-namespace-and-autoload

http://php.net/manual/zh/function.spl-autoload-register.php