使用命名空间可避免PHP代码中的命名冲突并提升可维护性。首先在文件首行用namespace App\Controllers;声明命名空间，对应目录结构如src/Controllers/，命名采用大驼峰法。通过use App\Models\User;导入类，同名类可用as设置别名。多级命名空间如App\Services\Payment应匹配src/Services/Payment/路径。在命名空间内调用全局函数时通常无需反斜杠，但存在同名函数需用\strlen()指向全局。结合PSR-4规范，在composer.json中配置"autoload": { "psr-4": { "App\\": "src/" } }并执行composer dump-autoload，确保类文件路径与命名空间一致，实现自动加载。
如果您在编写PHP代码时需要组织大量类、函数和常量，避免命名冲突并提升代码可维护性，则可以使用命名空间来划分逻辑结构。以下是关于PHP命名空间的规范用法与组织方式。
本文运行环境：MacBook Pro，macOS Sonoma
一、定义基本命名空间
命名空间通过 namespace 关键字声明，通常位于文件的首行（声明前不能有输出或空白行）。它的作用是将相关的类、接口、函数和常量分组到一个独立的作用域中，防止名称冲突。
1、在PHP文件顶部使用 namespace 声明命名空间，例如：namespace App\Controllers;
2、确保每个命名空间对应项目中的目录结构，如 App\Controllers 对应路径 src/Controllers/。
立即学习“PHP免费学习笔记（深入）”；
3、命名空间名称建议采用大驼峰命名法，且不包含下划线，层级之间用反斜杠分隔。
二、使用命名空间中的类
当需要引用其他命名空间中定义的类时，可以通过 use 语句导入，从而简化类的调用过程。这有助于减少重复书写完整命名空间路径。
1、在文件开头使用 use 引入目标类，例如：use App\Models\User;
2、若存在同名类，则可通过别名为其中一个类设置简称，例如：
use App\Models\User;
use Admin\Models\User as AdminUser;
3、在代码中直接使用导入的类名或别名创建实例：
$user = new User();
$admin = new AdminUser();
三、多级子命名空间的组织方式
大型项目常采用多级命名空间以精确反映目录结构和模块划分。每一级命名空间对应项目中的一层目录，增强代码的可读性和可维护性。
1、按功能模块划分命名空间层级，例如：namespace App\Services\Payment;
2、该命名空间应对应物理路径 src/Services/Payment/ 下的PHP文件。
3、在调用此类服务时，需正确引入完整命名空间路径或使用别名缩短调用链。
四、全局命名空间的访问
某些情况下，需要调用未定义在任何命名空间下的全局类或函数（如内置函数），此时可通过反斜杠前缀强制从全局空间解析。
1、在已声明命名空间的文件中调用全局函数时，可省略反斜杠，例如：echo strlen("test");
2、若当前命名空间中存在同名函数，需使用 \strlen() 明确指向全局函数。
3、对于异常类等常用全局类，在命名空间内引用时建议使用 use Exception; 导入，避免每次都加反斜杠。
五、自动加载与PSR-4规范结合
现代PHP项目普遍采用 Composer 进行依赖管理，并遵循 PSR-4 自动加载标准，使得命名空间与文件路径自动映射，无需手动包含文件。
1、在 composer.json 中配置自动加载规则，例如：
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
2、执行 composer dump-autoload 生成自动加载映射表。
3、确保类文件的实际路径与命名空间完全匹配，例如：
类 App\Controllers\HomeController 必须位于 src/Controllers/HomeController.php。
