PHP关键特性之命名空间

命名空间主要是为了解决代码中类和函数可能存在冲突的问题，而这个特性其他语言一早就有，PHP则是姗姗来迟，它的出现催生了 PSR-4 的诞生，从而也催生了 Composer 的兴起，所以是非常重要的特性。

命名空间的定义

命名空间是一个容器，这个容器主要是为了识别其下的类和函数。一旦定义了命名空间，它下面的代码就属于这个命名空间了，所以命名空间的定义要在代码的最开始行。

对于同一个包来说，同一个命名空间或者子命名空间的代码没有必要在一个 PHP 文件中定义，子命名空间下的代码是为了完成特定模块的工作，组合起来就是一个包完整的命名空间。

假如编写的代码没有定义命名空间，那说明它属于全局的命名空间（\ 符号）,所以能够直接引用类或者函数（不用添加 \ 符号）。

引用命名空间标识符的三种方式

（1）Fully-qualified name

类似于操作系统上的绝对路径，而且是完整的路径，所以在理解的时候不会有误解。
比如在 new \A\B\C ，那么 C 就被会解析到 A\B 命名空间下的 C 类。

（2）Qualified name

类似于操作系统上的相对路径，它包含部分名字并被引用到当前的命名空间。
比如 B\C() 在命名空间 A 下调用，则最终引用的命名空间就是 A\B\C()。

（3）Unqualified name

类似于Qualified name，但是没包括子命名空间。
比如 C() 在命名空间 A\B 下调用，则最终引用的命名空间就是 A\B\C()。

通过一个例子来说明三种引用方式:

namespace \Example;
require_once "fnction.php";
class ClassA {}
function Function() {}

//完全限定名称
\Example\Function();
\Example\B\Function(); 

//限定名称
B\Function(); //指向 \Example\B\Function();

//非限定名称
$test = new ClassA(); //resolves to \Example\ClassA
Function(); //指向 \Example\Function

注意：

• Inside a namespace,假如在 current scope 没有发现函数和常量的定义，PHP 不会报错。而是去全局命名空间中寻找。
• Inside a namespace,假如在 current scope 没有发现类的定义，则 PHP 会直接报错，不会去全局域中找对应的类，所以假如你需要引用一个 internal 或用户自定义的类，必须使用完全限定名称。

先举个简单的例子，首先编写一段代码（定义在命名空间下），命名为 function.php ：

namespace Foo\Bar\subnamespace;
const FOO = 1;
function foo() 
{
    return "foo\r\n";
}
class foo 
{
    static function staticmethod()
    {
        return __METHOD__ . "\r\n" ;
    }

    function foofunction()
    {
        return __METHOD__ . "\r\n" ;
    }
}

再编写一段代码 test.php，也是处于命名空间之下的代码：

namespace secondsp;
include 'function.php';

class foo
{
    function foofunction()
    {
        return __METHOD__ . "\r\n" ;
    }
}

function is_file($file)
{
    return true ;
}
 
//非限定名称:实例化secondsp\foo类对象
$obj = new foo;  
echo $obj->foofunction();

//实例化Foo\Bar\subnamespace\foo 类对象
$obj = new Foo\Bar\subnamespace\foo ;
echo $obj->foofunction();

//代码会报错，在命名空间内部，假如无法找到当前命名空间下的类，则会报错
//$obj = new ArrayObject(array(1)); 
$obj = new \ArrayObject(array(1)); 

//在命名空间内部，假如无法找到当前命名空间下的函数或者常量，则会寻找 native function
echo  strlen("nihao");

 //引用当前命名空间下的函数
var_dump(is_file('nihao')); //True
//引用全局函数
var_dump(\is_file('nihao')); //False

导入，别名

假如要使用的命名空间层级很长且数量很多，那么在使用的时候特别麻烦，所以可以使用 use 关键字导入命名空间、类、常量、函数等，然后可以使用它们直接引用完整的名称。而 alias 关键字可以给导入的类和函数等重命名。

举个例子如何使用 use 关键字，该代码处于全局命名空间之下：

include 'function.php';

use Foo\Bar\subnamespace\foo ;
$obj = new foo;
echo $obj->foofunction();

use Foo\Bar\subnamespace\foo  as aliasfunname;
$obj = new aliasfunname;
echo $obj->foofunction();
 
use Foo\Bar\subnamespace ; 
$obj = new subnamespace\foo ;
echo $obj->foofunction();

use Foo\Bar\subnamespace  as aliasname;
$obj = new aliasname\foo ;
echo $obj->foofunction();

//由于调用代码并不在命名空间内，所以对于全局的类，无需引入使用
$obj = new ArrayObject(array(1)); 

//导入一个函数
use function Foo\Bar\subnamespace\foo   ;
echo foo();
 
use function Foo\Bar\subnamespace\foo  as func;
echo func();
 
use const  Foo\Bar\subnamespace\FOO;
//echo FOO;

总结：

• 和 Python 不一样，PHP 中的命名空间是语义上的一种概念，和具体代码的位置、布局没有关系，换句话说，使用命名空间的代码需要自己引入库文件（所有文件），至于库文件如何组织无所谓；而在 Python 中，假如模块或包中有一个 __init__.py 文件，则 Python 解析器会自动引入包或所有模块的文件。
• PHP 中作用域的概念很弱化，全局域和局部域分的很清楚，比如在函数或类中无法引用全局空间中的变量。而在命名空间则不同，定义命名空间的代码，假如找不到对应命名空间下的常量和函数，则会使用全局的常量和函数；而假如找不到对应名命名空间下的类（包括自定义类），则代码直接报错。
• 通过 use 关键字使用命名空间的，无须通过完全限定名称的方式（\ 符号）导入，因为 PHP 已经假设导入的是完全限定的命名空间。
• 通过 use 关键字可以导入常量、函数、类、接口、其他命名空间。
• 命名空间是一种语言特性，为了追求更有效的使用，应该有一种使用规范和自动加载机制，这就是 PSR-4 规范。