PHP 命名空间概述

命名空间在PHP中扮演着至关重要的角色，它帮助开发者组织代码，避免命名冲突，并提升代码的可读性和维护性。本文将详细解释命名空间的核心概念、用法以及在实际编程中的应用。

命名空间的作用

命名空间主要有两个目的：

解决命名冲突：当你在同一个文件中定义多个类、函数或常量时，可能会出现名称重复的情况。通过使用命名空间，你可以为这些元素创建一个独特的全局路径，避免命名冲突。

提升可读性：长的类名、函数名或常量名可能会让代码难以阅读。通过为这些名称创建别名（或简短的名称），你可以显著提高源代码的可读性。

定义命名空间

在PHP中，命名空间可以通过 namespace 关键字定义。命名空间的结构可以看作是一个层级目录系统，每个命名空间可以包含多个类、函数和常量。

子命名空间的定义

要创建子命名空间，可以在命名空间名称后面添加子路径。例如：

namespace MyProject\Sub\Level;
const CONNECT_OK = 1;
class Connection {
    /* ... */
}
function connect() {
    /* ... */
}

在同一个文件中定义多个命名空间

虽然在实际编程中不建议在同一个文件中定义多个命名空间，但在某些特定场景下（例如将多个PHP脚本合并到一个文件中），你可以使用大括号形式的语法：

namespace MyProject {
    const CONNECT_OK = 1;
    class Connection {
        /* ... */
    }
    function connect() {
        /* ... */
    }
}
namespace AnotherProject {
    const CONNECT_OK = 1;
    class Connection {
        /* ... */
    }
    function connect() {
        /* ... */
    }
}

全局命名空间的使用

如果你不希望定义任何命名空间，所有代码都将属于全局命名空间。要明确使用全局命名空间，可以使用 global 关键字或在类名前加上全局前缀 \。例如：

namespace A\B\C;
/* 这个函数是 A\B\C\fopen */
function fopen() {
    /* ... */
    $f = \fopen(...);
    return $f;
}

类的引用方式

在命名空间中，类可以通过三种方式引用：

非限定名称或不包含前缀的名称：例如 new foo() 或 foo::staticmethod()。如果当前命名空间是 currentnamespace，则 foo 会被解析为 currentnamespace\foo。如果没有包含在任何命名空间中的代码，则 foo 会被解析为全局 foo。

限定名称或包含前缀的名称：例如 new subnamespace\foo() 或 subnamespace\foo::staticmethod()。如果当前命名空间是 currentnamespace，则 foo 会被解析为 currentnamespace\subnamespace\foo。如果没有包含在任何命名空间中的代码，则 foo 会被解析为全局 subnamespace\foo。

完全限定名称或包含全局前缀的名称：例如 new \currentnamespace\foo() 或 \currentnamespace\foo::staticmethod()。在这种情况下，foo 总是被解析为代码中的文字名 currentnamespace\foo。

需要注意的是，访问全局类、函数或常量时，必须使用完全限定名称。例如 \strlen() 或 \Exception。

名称解析规则

在PHP中，名称解析遵循以下规则：

完全限定名称的函数、类和常量：在编译时解析。例如 new \A\B 会被解析为类 A\B。

非限定名称和限定名称（非完全限定名称）：在编译时根据导入规则转换。例如，如果命名空间 A\B\C 被导入为 C，那么 C\D\e() 会被转换为 A\B\C\D\e()。

命名空间内部的非限定名称：在运行时解析。例如，对于函数 foo()，PHP 会首先尝试在当前命名空间中查找 A\B\foo()，然后尝试全局 foo()。

命名空间内部的类引用：对于 new C() 和 new D\E()，PHP 会在运行时解析为 A\B\C 和 A\B\D\E。如果类不存在，PHP 会尝试自动装载相应的类。

全局类引用：必须使用完全限定名称。例如 new \B() 会被解析为全局类 B。

注意事项

在父文件包含的子文件中又包含的文件的相对路径是针对父文件目录的，而不是子文件目录。例如：

// 父文件包含的子文件
require 'subfile.php';
// 子文件中的代码
echo __FILE__; // 输出 'subfile.php'

NAMESPACE 和 namespace 关键字

PHP 支持两种抽象的访问当前命名空间内部元素的方法：__NAMESPACE__ 魔术常量和 namespace 关键字。__NAMESPACE__ 可以表示字符串，和 namespace 一样。

使用 `use` 操作符导入/使用别名

use 操作符允许你从命名空间中导入类、函数或常量，并为它们创建别名。例如：

namespace foo;
use My\Full\Classname as Another;
// 下面的例子与 `use My\Full\NSname as NSname` 相同
use My\Full\NSname;
// 导入一个全局类
use ArrayObject;
// 导入一个函数（PHP 5.6+）
use function My\Full\functionName;
// 别名一个函数（PHP 5.6+）
use function My\Full\functionName as func;
// 导入一个常量（PHP 5.6+）
use const My\Full\CONSTANT;
$obj = new namespace\Another; // 实例化 `foo\Another` 对象
$obj = new Another; // 实例化 `My\Full\Classname` 对象
NSname\subns\func(); // 调用函数 `My\Full\NSname\subns\func`
$a = new ArrayObject(array(1)); // 实例化 `ArrayObject` 对象
// 如果不使用 `use ArrayObject`，则实例化一个 `foo\ArrayObject` 对象
func(); // 调用函数 `My\Full\functionName`
echo CONSTANT; // 消耗全局常量 `My\Full\CONSTANT`

在一行中包含多个 `use` 语句

use My\Full\Classname as Another, My\Full\NSname;
// 实例化 `My\Full\Classname` 对象
NSname\subns\func(); // 调用函数 `My\Full\NSname\subns\func`

导入和动态名称

use My\Full\Classname as Another, My\Full\NSname;
$obj = new Another; // 实例化 `My\Full\Classname` 对象
$a = 'Another'; // 字符串 `Another`
$obj = new $a; // 实例化 `Another` 对象

导入和完全限定名称

导入操作只影响非限定名称和限定名称。完全限定名称由于是确定的，故不受导入的影响。

use My\Full\Classname as Another, My\Full\NSname;
$obj = new Another; // 实例化 `My\Full\Classname` 对象
$obj = new \Another; // 实例化 `Another` 对象
$obj = new Another\thing; // 实例化 `My\Full\Classname\thing` 对象
$obj = new \Another\thing; // 实例化 `Another\thing` 对象

使用全局空间说明

在一个命名空间中，当 PHP 遇到一个非限定类、函数或常量名称时，它会根据以下优先级策略来解析该名称：

在当前命名空间中查找类、函数或常量。

如果不存在，则尝试查找全局空间中的相应元素。

因此，在访问系统内部或不包含在命名空间中的类名称时，必须使用完全限定名称。例如：

namespace A\B\C;
class Exception extends \Exception {
}
$a = new Exception('hi'); // $a 是类 `A\B\C\Exception` 的一个对象
$b = new \Exception('hi'); // $b 是类 `Exception` 的一个对象
$c = new ArrayObject; // 致命错误，找不到 `A\B\C\ArrayObject` 类

namespace A\B\C;
const E_ERROR = 45;
function strlen($str) {
    return \strlen($str) - 1;
}
echo E_ERROR, "\n"; // 输出 "45"
echo INI_ALL, "\n"; // 输出 "7" - 使用全局常量 `INI_ALL`
echo strlen('hi'), "\n"; // 输出 "1"
if (is_array('hi')) {
    // 输出 "is array"
    echo "is array\n";
} else {
    echo "is not array\n";
}