PHP 8 命名空间避冲突需统一前缀、严格分层、显式导入，须与目录结构、自动加载、引用方式协同；namespace 必居文件首（除 declare 外）；需严格匹配 PSR-4 路径；引用类须 use 或完整限定名；函数常量也需命名空间保护。
PHP 8 中用命名空间避免冲突，核心就三点：**统一前缀、严格分层、显式导入**。它不是加个 namespace 就完事，而是要和目录结构、自动加载、引用方式配合使用，才能真正隔离类、函数、常量，防止“Class already exists”这类错误。
命名空间必须放在文件最顶部
PHP 8 仍延续严格语法：namespace 声明必须是文件中除 declare 指令外的第一条语句。任何空白、注释、输出或代码前置都会报 Parse error。
- ✅ 正确写法：
<?php<br>namespace App\Controllers;<br><br>class UserController { ... } - ❌ 错误写法：
<?php<br>// 注释在 namespace 前<br>namespace App\Controllers; // 报错！
命名空间要与目录结构严格一致
这是自动加载（如 Composer 的 PSR-4）能正常工作的前提。比如你定义了 namespace App\Models\User;，那这个文件就必须放在 src/Models/User/ 目录下，类文件名通常为 UserRepository.php 或 User.php。
- 不一致会导致
Class not found，即使类存在也加载不到 - 推荐层级控制在 3 层以内，例如
App\Services\Payment比App\Core\Infrastructure\Adapters\Http\V1\Controllers\Auth更易维护 - 小写+驼峰或短横线均可，但全项目保持统一（如 Laravel 用 PascalCase，Symfony 常用 snake_case）
引用外部类必须用 use 或完整限定名
PHP 8 不再隐式查找全局空间。在命名空间内直接写 new DateTime() 会尝试实例化当前命名空间下的 DateTime 类（不存在则报错），而不是 PHP 内置的 \DateTime。
立即学习“PHP免费学习笔记（深入）”；
- ✅ 访问内置类：
new \DateTime();或use DateTime;（因DateTime在全局空间，use可省略反斜线） - ✅ 引入同项目类：
use App\Models\User;，之后可直接写new User() - ✅ 处理同名类冲突：
use ThirdParty\Log as ThirdLog;和use App\Log as AppLog;，再分别用new ThirdLog()和new AppLog()
函数和常量也要加命名空间保护
很多人只给类加命名空间，却把工具函数（如 str_slug()）或配置常量（如 MAX_RETRY）扔在全局空间——这极易和第三方库冲突。
- 定义带命名空间的函数：
namespace App\Helpers;<br>function str_slug(string $s): string { return strtolower(preg_replace('/[^a-z0-9]+/', '-', $s)); } - 调用时必须用完整名：
\App\Helpers\str_slug('Hello World')（不能省略开头的\） - 常量同理：
namespace App\Config; const API_TIMEOUT = 5000;→ 调用：\App\Config\API_TIMEOUT
