应使用命名空间隔离类名：一、文件顶部声明唯一根命名空间并匹配PSR-4；二、用use as为同名类设别名；三、关键调用加前导反斜杠；四、严格遵循PSR-4目录映射；五、禁用全局命名空间定义可复用代码。
如果您在搭建PHP网站时引入多个模块或第三方库，却频繁遇到“Fatal error: Cannot declare class XXX because the name is already in use”等报错，则很可能是由于类名未通过命名空间隔离导致的全局作用域污染。以下是解决此问题的具体方法：
一、在文件顶部严格声明唯一根命名空间
每个PHP类文件必须以namespace语句开头（仅允许空白符和declare语句前置），且应使用具备项目辨识度的根命名空间前缀，避免与通用库（如Monolog、Doctrine）发生层级重叠。
1、在文件最顶端（无BOM、无空行、无注释）写入namespace MyCompanyWebsite;
2、确保该命名空间与Composer中PSR-4配置完全一致，例如"MyCompany\Website\": "src/"
立即学习“PHP免费学习笔记（深入）”；
3、子模块按功能分层声明，如控制器类使用namespace MyCompanyWebsiteControllers;
4、禁止省略命名空间首部反斜杠逻辑——所有声明均视为绝对路径起点，漏写开头反斜杠会导致相对解析错误，引发类加载失败
二、使用use语句配合as关键字实现同名类共存
当同一文件需同时调用不同来源的同名类（如User）时，仅靠use导入会触发“name already in use”致命错误；必须为每个类显式指定唯一别名，才能在当前作用域内安全共存。
1、在文件顶部声明use MyCompanyWebsiteModelsUser as SiteUser;
2、再声明use VendorAuthUser as AuthUser;
3、代码中分别调用new SiteUser()与new AuthUser()
4、别名不可使用PHP保留字（如as、class、function），且不能与当前命名空间下已定义的类名重复
三、显式采用完全限定名称调用关键元素
绕过use机制的解析歧义，在调用敏感类、函数或常量时直接使用带前导反斜杠的全路径，可强制定位到目标符号，尤其适用于全局内置类被当前命名空间遮蔽的场景。
1、创建异常对象时写成throw new Exception('Message');
2、调用字符串函数时写成strlen($str)而非strlen($str)
3、引用外部trait方法时也须完整写出命名空间，如MyCompanyWebsiteTraitsLogger::log();
4、任何未加反斜杠的全局函数或类调用，在非全局命名空间下均可能被错误解析为当前命名空间内的符号
四、严格遵循PSR-4规范映射目录结构与命名空间
PSR-4自动加载是命名空间生效的前提条件；若物理路径与命名空间不匹配，即使声明正确，类也无法被自动加载，最终仍报“Class not found”错误。
1、将命名空间中的反斜杠逐级对应为目录分隔符，如MyCompanyWebsiteControllers对应src/Controllers/
2、类文件名必须与类名完全一致（含大小写），例如HomeController.php内必须定义class HomeController
3、执行composer dump-autoload更新自动加载映射表
4、Linux系统下目录名大小写敏感，Controllers/与controllers/被视为两个不同路径，必须确保命名空间大小写与实际目录完全一致
五、禁止在全局命名空间中定义可复用类或函数
将可复用组件置于全局命名空间，相当于将其暴露于所有其他代码的潜在冲突风险中；一旦第三方库或后续模块也定义同名标识符，将立即触发致命错误。
1、删除所有未声明namespace的类文件顶部空白行或BOM字符
2、将原全局函数迁移至专属命名空间，例如namespace MyCompanyWebsiteHelpers;
3、对已存在的全局函数调用，统一改写为my_global_function()形式
4、全局命名空间仅保留不可复用的一次性脚本，所有库级、模块级、服务级代码必须归属明确命名空间
