php 命名空间

封面图 • 2026-04-09 • PHP

在 PHP 中，**命名空间（Namespace）** 是用于组织代码结构的一种机制，它可以帮助你避免类、函数和常量的名称冲突。特别是在大型项目或使用第三方库时，命名空间非常有用。

---

## 一、基本概念

- **命名空间**：类似于文件系统中的目录，用来组织代码。
- **类/函数/常量**：可以放在不同的命名空间中，避免名字重复。

---

## 二、定义命名空间

使用 `namespace` 关键字来定义一个命名空间：

```php
<?php
namespace MyProject;

class MyClass {
    public function sayHello() {
        echo "Hello from MyProject!";
    }
}
```

---

## 三、使用命名空间中的类

### 1. 使用 `use` 引入类

```php
<?php
namespace App;

use MyProject\MyClass;

$obj = new MyClass();
$obj->sayHello(); // 输出: Hello from MyProject!
```

### 2. 直接使用全限定名

```php
<?php
namespace App;

$obj = new \MyProject\MyClass();
$obj->sayHello();
```

---

## 四、多级命名空间（嵌套）

命名空间可以是多级的，用反斜杠 `\` 分隔：

```php
<?php
namespace MyProject\SubNamespace;

class SubClass {
    public function sayHi() {
        echo "Hi from SubNamespace!";
    }
}
```

使用方式：

```php
<?php
namespace App;

use MyProject\SubNamespace\SubClass;

$obj = new SubClass();
$obj->sayHi(); // 输出: Hi from SubNamespace!
```

---

## 五、命名空间与文件结构

通常，命名空间会与文件路径对应，比如：

- 命名空间：`MyProject\SubNamespace`
- 文件路径：`/path/to/project/MyProject/SubNamespace.php`

这种结构有助于自动加载（如使用 Composer 的 `autoload`）。

---

## 六、命名空间的全局部分

如果一个类没有被放在任何命名空间中，它就属于“全局命名空间”。

```php
<?php
// Global namespace
class GlobalClass {
    public function sayHello() {
        echo "Hello from global!";
    }
}

namespace MyProject;

$obj = new GlobalClass(); // 错误！找不到 GlobalClass
```

要访问全局类，需要使用 `::` 或 `\`：

```php
$obj = new \GlobalClass(); // 正确
```

---

## 七、命名空间的别名（Alias）

可以为长命名空间起别名，方便使用：

```php
<?php
namespace App;

use MyProject\SubNamespace\SubClass as SC;

$obj = new SC();
$obj->sayHi();
```

---

## 八、自动加载（Autoloading）

PHP 支持通过 `spl_autoload_register()` 或 Composer 自动加载命名空间中的类。

### 示例（使用 Composer）：

1. 在 `composer.json` 中配置：

```json
{
    "autoload": {
        "psr-4": {
            "MyProject\\": "src/"
        }
    }
}
```

2. 在代码中使用：

```php
<?php
require 'vendor/autoload.php';

use MyProject\SubNamespace\SubClass;

$obj = new SubClass();
```

---

## 九、命名空间常见错误

- 没有正确使用 `use` 或全限定名。
- 命名空间与文件路径不一致导致自动加载失败。
- 类名重复（未使用命名空间）。

---

## 十、总结

| 用途 | 说明 |
|------|------|
| 避免名称冲突 | 同名类、函数、常量不会互相干扰 |
| 组织代码结构 | 更清晰的模块划分 |
| 自动加载支持 | 与 Composer 等工具配合使用 |

---

如果你有具体的例子或问题，我可以帮你进一步分析。