PHP命名空间用于解决类、函数、常量命名冲突，需在文件顶部声明，支持多级如App\Controllers；用use导入后可简写调用；推荐遵循PSR-4规范并显式调用全局函数。
PHP命名空间（namespace）是用来解决类、函数、常量等命名冲突问题的核心机制，尤其在大型项目或使用多个第三方库时必不可少。正确声明和调用命名空间，能让代码结构更清晰、可维护性更强。
如何声明命名空间
命名空间必须放在文件最顶部（可选的declare语句之后、任何PHP代码之前），且一个文件通常只定义一个主命名空间。
- 基本语法：namespace 后跟命名空间名称，以分号结尾
- 支持多级命名，用反斜杠 \ 分隔，如 namespace App\Controllers;
- 可以嵌套子命名空间，但不推荐在单个文件中多次使用 namespace 切换（PHP 7.4+ 支持同一文件多个命名空间，但易混乱，建议避免）
- 全局命名空间用 namespace {}; 表示（即无名称），此时所有类/函数默认属于全局空间
如何在当前文件中使用其他命名空间
用 use 关键字导入外部命名空间中的类、接口、函数或常量，简化后续调用。
- 导入类：use App\Models\User;
- 起别名：use App\Models\User as UserModel;
- 导入函数（PHP 5.6+）：use function Helpers\format_date;
- 导入常量（PHP 5.6+）：use const Helpers\MAX_RETRY;
- 注意：use 只影响当前文件，不具传递性；它不是“包含文件”，而是“取别名”
如何调用命名空间中的内容
有三种常见方式：完全限定名、相对调用、以及通过 use 导入后直接使用。
立即学习“PHP免费学习笔记（深入）”；
- 完全限定名：以反斜杠开头，如 \App\Models\User::find(1); —— 从全局空间开始解析
- 未加反斜杠的类名：PHP先在当前命名空间下查找，找不到再尝试全局空间（容易出错，不推荐裸写）
- 已 use 导入的类：直接使用类名，如 User::find(1);（前提是已 use App\Models\User;）
- 动态类名需用完整字符串：$class = 'App\\Models\\User'; new $class();（注意双反斜杠转义）
常见陷阱与建议
命名空间看似简单，但几个细节不注意就容易报错。
- 文件路径不必和命名空间严格一致，但遵循 PSR-4 自动加载规范时，强烈建议保持一致（如 namespace App\Controllers 对应 ./src/Controllers/）
- 命名空间名称不区分大小写，但类名区分大小写；建议全部小写+驼峰或短横线风格，保持统一
- 不要在命名空间名中使用下划线（_），虽然语法允许，但不符合PSR标准，Composer自动加载会失败
- 在命名空间内调用全局函数（如 strlen()、date()）时，建议显式加反斜杠：\strlen()，避免被当前命名空间下的同名函数覆盖
基本上就这些。命名空间本身不复杂，但它是组织现代PHP项目的基础——用对了，协作和扩展都省心很多。
