在命名空间提出之前，不同的组件很容易碰到命名的冲突，例如Request、Response等常见的命名。本文将带你理解PHP的核心特性命名空间。

提出

PHP 在 5.3 后提出了命名空间用来解决组件之间的命名冲突问题，主要参考了文件系统的设计：

同一个目录下不允许有相同的文件名 - 同一个命名空间下不允许有相同的类；

不同的目录可以有同名文件 - 不同的命名空间可以有相同的类；

定义

使用namespace关键字来定义一个命名空间。其中，顶层命名空间通常为厂商名，不同开发者的厂商命名空间是唯一的。命名空间不需要与文件目录一一对应，但是最好遵守PSR-4规范。

1. <?php 
2.  
3. namespace Symfony\Component\HttpFoundation; 
4.  
5. class Request { 
6.  
7. } 

命名空间必须在所有代码之前声明，唯一的例外就是 declare 关键字。

1. <?php 
2.  
3. declare(strict_types=1); 
4.  
5. namespace App; 

命名空间内可包含任意 PHP 代码，但是仅对类 (包括抽象类和 Trait)、接口、函数和常量这四种类型生效。

1. <?php 
2. namespace MyProject; 
3.  
4. const CONNECT_OK = 1; 
5. class FOO {} 
6. interface Foo{} 
7. function foo() {} 

使用

使用use关键字来引入命名空间

1. <?php 
2.  
3. namespace App; 
4.  
5. use Symfony\Component\HttpFoundation\Request; 
6. use Foo\Bar; 
7.  
8. class Test { 
9.     public function run() 
10.     { 
11.         $bar = new Bar(); 
12.     } 
13. } 

定义和使用推荐遵循PSR-2的规范

namespace之后必须存在一个空行；

所有use声明必须位于namespace声明之后；

每条use声明必须只有一个use关键字。

use语句块之后必须存在一个空行。

当use引入的类出现同名时，可使用as来定义别名

1. <?php 
2.  
3. namespace App; 
4.  
5. use Foo\Bar as BaseBar; 
6.  
7. class Bar extends BaseBar { 
8.  
9. } 

限定符

除了使用use外，还可以直接使用\限定符来进行解析，规则很简单：如果含有\前缀则代表从全局命名空间开始解析，否则则代表从当前命名空间开始解析。

1. <?php 
2.  
3. namespace App; 
4.  
5. \Foo\Bar\foo();  // 解析成 \Foo\Bar\foo(); 
6. Foo\Bar\foo();  // 解析成 App\Foo\Bar\foo(); 

此规则也适用于函数、常量等

1. $a = \strlen('hi'); // 调用全局函数 strlen 
2. $b = \INI_ALL; // 访问全局常量 INI_ALL 
3. $c = new \Exception('error'); // 实例化全局类 Exception 

有两个需要特别注意的地方：

对于函数和常量而言，如果当前命名空间不存在，则会自动去全局命名空间去寻找，因此可省略\前缀。对于类而言，如果当前命名空间解析不到，不会去全局空间寻找，因此，不可省略\

1. $a = strlen('hi'); 
2. $b = INI_ALL; 
3. $c = new Exception('error'); // 错误 
4. $c = new \Exception('error'); // 正确 

当动态调用命名空间时，该命名空间始终会被当成是全局命名空间，因此可以省略前缀\

$class1 = 'Foo\Bar';

$object1 = new $class1;  // 始终被解析成 \Foo\Bar

在内部访问命名空间

PHP 支持两种抽象的访问当前命名空间内部元素的方法，__NAMESPACE__魔术常量和namespace关键字。

__NAMESPACE__常量的值是包含当前命名空间名称的字符串，如果是在全局命名空间，则返回空字符串。

1. <?php 
2. namespace MyProject; 
3.  
4. function get($classname) 
5. { 
6.     $a = __NAMESPACE__ . '\\' . $classname; 
7.     return new $a; 
8. } 

关键字namespace可用来显式访问当前命名空间或子命名空间中的元素，它等价于类中的self操作符。

1. namespace App; 
2.  
3. use blah\blah as mine; 
4.  
5. blah\mine(); // App\blah\mine() 
6. namespace\blah\mine(); // App\blah\mine() 
7.  
8. namespace\func(); // App\func() 
9. namespace\sub\func(); // App\sub\func() 
10. namespace\cname::method(); // App\cname::method() 
11. $a = new namespace\sub\cname(); // App\sub\cname 
12. $b = namespace\CONSTANT; // App\CONSTANT 

转义\符号

此外，推荐对所有的\进行转义，避免出现不可预期的后果

1. $class = "dangerous\name"; // \n 被解析成换行符 
2. $obj = new $class; 
3.  
4. $class = 'dangerous\name'; // 正确，但是不推荐 
5. $class = 'dangerous\\name'; // 推荐 
6. $class = "dangerous\\name"; // 推荐

Tags: PHP核心特性命名空间

分享到：