在PHP工具开发中，随着功能不断扩展，代码文件和类会越来越多，如果不做规范的组织，很容易出现类名冲突、文件引用混乱的问题，命名空间和合理的项目结构规划就是解决这类问题的核心方案。
命名空间的基础用法
命名空间本质上是一个逻辑上的代码划分区域，用于区分不同模块的同名类、函数、常量。声明命名空间使用namespace关键字，一般放在PHP文件的最顶部，一个文件只能声明一个命名空间（除极少数特殊情况）。
以下是一个简单的工具类命名空间示例：
<?php
// 声明当前文件属于App\Tools\String命名空间
namespace App\Tools\String;
class StringHelper
{
// 字符串截取方法
public static function subStr($str, $len)
{
return mb_substr($str, 0, $len, 'UTF-8');
}
}通过命名空间规划工具项目结构
命名空间最好和项目的目录结构一一对应，这样可以配合自动加载机制减少手动引入文件的成本。常见的PHP工具项目结构可以参考以下划分：
- src目录：存放所有核心源代码，是命名空间的根目录
- src/Tools：存放通用工具类，对应
App\Tools命名空间 - src/Utils：存放项目内部使用的工具方法，对应
App\Utils命名空间 - src/Contracts：存放接口定义，对应
App\Contracts命名空间 - tests目录：存放测试文件
- composer.json：项目依赖和自动加载配置
比如我们在src/Tools/Array目录下创建一个数组处理工具类，对应的命名空间就是App\Tools\Array，文件结构如下：
<?php
// 文件路径：src/Tools/Array/ArrayHelper.php
namespace App\Tools\Array;
class ArrayHelper
{
// 数组去重方法
public static function unique($arr)
{
return array_unique($arr);
}
}搭配自动加载实现便捷调用
如果手动用require或者include引入文件，会随着文件增多变得非常繁琐，PHP的自动加载机制可以解决这个问题，最常用的是通过Composer配置PSR-4自动加载规则。
在composer.json中添加以下配置：
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
}配置完成后执行composer dump-autoload生成自动加载文件，之后在项目中只需要引入自动加载文件，就可以直接调用对应命名空间下的类：
<?php
require_once 'vendor/autoload.php';
use App\Tools\String\StringHelper;
use App\Tools\Array\ArrayHelper;
// 调用字符串工具方法
$str = StringHelper::subStr('测试字符串内容', 4);
// 调用数组工具方法
$arr = ArrayHelper::unique([1, 2, 2, 3]);命名空间使用的注意事项
使用命名空间时需要注意几个常见问题：
- 全局空间的类、函数调用时，如果不想写完整命名空间，可以用
use关键字引入，或者用\前缀表示全局空间，比如\PDO就是全局的PDO类 - 同一个命名空间下的类可以直接调用，不需要额外引入
- 命名空间的大小写要和目录结构的大小写保持一致，避免在不同操作系统下出现文件路径识别问题
- 不要在同一个文件中定义多个命名空间，除非是特殊的兼容性场景，否则会增加代码维护难度
总结
通过命名空间划分PHP工具的功能模块，再配合和命名空间对应的目录结构以及自动加载机制，可以让项目结构清晰明了，后续新增功能、排查问题都会更高效。在规划项目结构时，可以根据工具的实际功能维度拆分命名空间，比如按功能类型、按业务模块划分，只要保持命名空间和目录的对应关系一致，就能充分发挥命名空间的作用。