php namespace用法

封面图 • 2025-10-29 • PHP

在 PHP 中，`namespace` 是用来组织代码结构、避免类名冲突的重要特性。它类似于其他编程语言（如 Java 或 C#）中的包（package）或命名空间（namespace）。PHP 从版本 5.3 开始支持命名空间。

---

## 📌 一、基本用法

### 1. 声明命名空间

在 PHP 文件中，使用 `namespace` 关键字来声明当前文件所属的命名空间：

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

class Helper {
    public static function sayHello() {
        echo "Hello from Helper!";
    }
}
```

### 2. 使用命名空间中的类

在其他文件中使用该类时，需要使用 `use` 关键字导入类：

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

use MyProject\Utils\Helper;

require 'Helper.php';

Helper::sayHello(); // 输出: Hello from Helper!
```

---

## 📌 二、多级命名空间

命名空间可以嵌套，用反斜杠 `\` 分隔：

```php
namespace MyProject\Models\User;

class User {
    public function getName() {
        return "John Doe";
    }
}
```

使用方式：

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

use MyProject\Models\User\User;

$user = new User();
echo $user->getName(); // 输出: John Doe
```

---

## 📌 三、别名（Alias）

你可以为长命名空间设置别名，提高可读性：

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

use MyProject\Models\User\User as UserModel;

$user = new UserModel();
echo $user->getName();
```

---

## 📌 四、全局命名空间

如果不想使用命名空间，可以直接写类：

```php
<?php
class GlobalClass {
    public function sayHi() {
        echo "Hi from global class!";
    }
}
```

也可以在命名空间中使用全局类：

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

use GlobalClass;

$global = new GlobalClass();
$global->sayHi();
```

---

## 📌 五、自动加载（Autoloading）

推荐使用 **Composer** 来管理自动加载，这样就不需要手动 `include` 或 `require`。

在 `composer.json` 中配置：

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

然后运行：

```bash
composer dump-autoload
```

---

## 📌 六、命名空间的注意事项

| 项目 | 说明 |
|------|------|
| 命名空间不能嵌套在函数或类中 | 只能在文件顶部定义 |
| 命名空间是静态的 | 不像动态语言那样可以运行时改变 |
| 命名空间与目录结构一致 | 推荐按照命名空间结构组织文件夹 |

---

## 📌 七、示例：完整项目结构

```
/myproject
├── composer.json
├── src/
│   ├── MyProject/
│   │   ├── App/
│   │   │   └── Main.php
│   │   └── Utils/
│   │       └── Helper.php
└── index.php
```

`src/MyProject/App/Main.php`:

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

use MyProject\Utils\Helper;

class Main {
    public function run() {
        Helper::sayHello();
    }
}
```

`index.php`:

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

use MyProject\App\Main;

$main = new Main();
$main->run(); // 输出: Hello from Helper!
```

---

## ✅ 总结

| 功能 | 示例 |
|------|------|
| 声明命名空间 | `namespace MyProject\Utils;` |
| 导入类 | `use MyProject\Utils\Helper;` |
| 别名 | `use MyProject\Utils\Helper as H;` |
| 多级命名空间 | `namespace MyProject\Models\User;` |
| 自动加载 | Composer + PSR-4 |

如果你有具体的使用场景（比如 Laravel、Symfony 或自定义框架），我也可以提供更详细的指导。