封装可复用的工具函数库，核心在于解耦与标准化。不要把所有功能堆砌在一个巨大的全局文件中，而是按照职责划分层级：核心层提供基础能力（如日志、配置），工具层处理通用逻辑（如数组操作、字符串处理），应用层则针对具体业务进行组合。通过命名空间隔离代码，避免全局污染，并利用依赖注入管理外部资源。
分层架构与依赖管理
在PHP中，良好的工具库应当具备清晰的边界。核心层通常包含单例模式的配置读取器和异常处理器，它们不依赖任何业务逻辑。工具层则依赖于核心层提供的稳定接口，例如一个通用的HTTP客户端或加密工具。这种分层使得在更换底层实现时，上层代码无需修改。
依赖注入是保持工具库独立性的关键。控制器不应直接实例化数据库连接或复杂的业务服务，而应通过构造函数或Setter方法接收这些对象。这样不仅便于单元测试，还能确保工具函数在不同环境下使用不同的配置实例。例如，将数据库连接对象作为参数传递给数据访问层，而不是在内部硬编码创建连接。
立即学习“PHP免费学习笔记（深入）”；
输入验证与错误处理机制
工具函数的健壮性体现在对非法输入的防御上。以数据验证为例，一个标准的验证流程应先检查数据类型，再检查是否为空，最后匹配具体的规则集。这种链式判断能迅速定位错误源头，避免深层嵌套导致的逻辑混乱。
<?php
namespace App\Tools;
class Validator {
private array $rules;
private array $errors = [];
public function __construct(array $rules) {
$this->rules = $rules;
}
public function validate(array $input): bool {
foreach ($this->rules as $field => $rule) {
if (!isset($input[$field]) || empty($input[$field])) {
$this->errors[] = "$field is required";
continue;
}
if (!$this->checkRule($input[$field], $rule)) {
$this->errors[] = "$field format invalid";
}
}
return empty($this->errors);
}
private function checkRule($value, string $rule): bool {
// 简化示例：仅检查邮箱格式
return filter_var($value, FILTER_VALIDATE_EMAIL) !== false;
}
public function getErrors(): array {
return $this->errors;
}
}
// 使用示例
$validator = new Validator(['email' => 'email']);
if ($validator->validate(['email' => 'test@example.com'])) {
echo "Valid input";
} else {
print_r($validator->getErrors());
}
上述代码展示了一个简单的验证器实现。它接受规则数组和输入数据，遍历规则并执行检查。如果验证失败，错误信息会被收集起来供后续处理。运行此代码时，传入符合邮箱格式的字符串会返回“Valid input”，而传入无效格式则会输出相应的错误提示。这种设计允许灵活扩展新的验证规则，只需在checkRule方法中添加逻辑即可。
静态方法与闭包的权衡
对于无状态的工具函数，如字符串格式化或数学计算，使用静态方法是最高效的选择。它们不需要实例化对象，调用简洁且内存占用低。然而，当工具函数需要维护内部状态或与外部系统交互时，闭包或类实例更为合适。闭包可以捕获上下文变量，适合一次性使用的回调场景；而类实例则能通过属性保存状态，适用于需要多次调用的复杂逻辑。选择哪种方式取决于函数的生命周期和使用频率。
