类定义常见问题解析：避免代码隐患

写代码时，类定义看似简单，但一不小心就会掉进坑里。尤其是在做项目压缩打包、备份迁移的时候，这些问题更容易暴露出来。比如你本地运行好好的程序，放到服务器上就报错，查来查去发现是类命名不规范导致加载失败。

类名重复或命名冲突

很多人图省事，把工具类都叫 Util 或者 Helper。可一旦项目大了，多个文件夹下都有同名类，自动加载机制就懵了。PHP 的自动加载（autoloader）靠的是命名空间和类名对应路径，重名直接导致找不到类。

正确的做法是用命名空间区分模块：

namespace Backup\Compression;

class ZipHelper {
    public function compress($files) {
        // 压缩逻辑
    }
}

忘记声明属性或方法的访问修饰符

新手常犯的一个错误是直接写属性，不加 public、private 或 protected。PHP 7.4 之前还能容忍，但从 PHP 8 开始会直接报错。比如下面这种写法是非法的：

class FileProcessor {
    $source; // 错误：缺少访问修饰符
    
    function process() { // 默认 public，但最好显式写出
        // 处理文件
    }
}

应该明确写出修饰符：

class FileProcessor {
    public $source;
    private $logFile;

    public function process() {
        // 处理逻辑
    }
}

静态属性和方法滥用

为了方便，有些人把所有工具方法都写成 static，结果在单元测试或者需要 mock 的时候完全没法替换。更麻烦的是，静态状态在长时间运行的服务中可能积累脏数据，压缩任务跑着跑着就出错。

比如这个例子：

class Compressor {
    public static $tempDir = '/tmp';
    
    public static function zip($files) {
        // 使用 self::$tempDir
    }
}

看着简洁，但一旦多个任务同时运行，$tempDir 被意外修改，后果难料。更好的方式是实例化对象，通过构造函数传参控制行为。

构造函数参数顺序混乱

类一复杂，构造函数参数就多。有人图快，按随便顺序堆参数，等几个月后回来改代码，根本记不清第二个字符串到底是起始路径还是目标路径。

建议用关联数组或配置对象传参：

class BackupManager {
    private $config;

    public function __construct(array $config) {
        $this->config = array_merge([
            'source' => './data',
            'destination' => './backup',
            'format' => 'zip'
        ], $config);
    }
}

这样调用也清晰：

$backup = new BackupManager([
    'source' => '/home/user/docs',
    'destination' => '/mnt/external',
    'format' => 'tar.gz'
]);

忽略析构函数或资源释放

压缩大文件时，可能开了临时句柄或占用了内存缓存。如果类没有在销毁时清理资源，长期运行的脚本容易内存泄漏。

记得加上 __destruct：

public function __destruct() {
    if ($this->tempHandle) {
        fclose($this->tempHandle);
        $this->tempHandle = null;
    }
}

类定义常见问题：程序员容易踩的坑

类名重复或命名冲突

忘记声明属性或方法的访问修饰符

静态属性和方法滥用

构造函数参数顺序混乱

忽略析构函数或资源释放