如何在HackLang中完整废弃一个类？

嘿，这个场景我太熟悉了！用@deprecated注释确实只能靠IDE提示，对运行时的提醒力度不够。针对静态类的废弃，这里有几个实用的方案，能给后续开发者更明确的警示：

从PHP 8.1开始，官方支持了原生的#[Deprecated]属性，直接可以标注在类上，不管是IDE提示还是运行时警告都很到位，这是最优雅的方案：

#[Deprecated(
    message: '请使用 MyNewClass 替代',
    since: '2.0.0' // 可选：标注废弃的版本
)]
class MyDeprecatedClass {
    public static function doDeprecatedThings() {
        // 旧方法逻辑
    }
}

• IDE（比如PhpStorm、VS Code）会直接给类和所有调用处标红提示；
• 运行时如果开启了E_DEPRECATED错误报告，调用类的静态方法时会自动抛出警告；
• 完全不用逐个给方法加标记，一次性搞定整个类。

如果你的项目还在使用PHP 8.1以下的版本，可以利用魔术方法__callStatic来捕获所有静态方法的调用，统一抛出废弃警告：

/**
 * @deprecated use MyNewClass.
 */
class MyDeprecatedClass {
    // 私有构造函数，防止有人实例化这个静态类
    private function __construct() {}

    // 拦截所有静态方法调用
    public static function __callStatic(string $methodName, array $arguments): mixed {
        // 抛出明确的废弃警告
        trigger_error(
            sprintf(
                'MyDeprecatedClass::%s() 已废弃，请使用 MyNewClass::%s() 替代',
                $methodName,
                $methodName
            ),
            E_USER_DEPRECATED
        );

        // 如果需要兼容旧代码，可以把调用转发到原来的私有方法
        return static::$methodName(...$arguments);
    }

    // 把原来的公共静态方法改为私有，强制走__callStatic拦截
    private static function doDeprecatedThings() {
        // 旧方法逻辑
    }
}

这样不管调用哪个静态方法，都会触发警告，不用逐个修改方法，而且能确保所有调用都能收到提示。

如果想做到只要有人引用这个类就立刻提示（哪怕还没调用方法），可以在类的自动加载逻辑里加入警告：

比如自定义一个自动加载器：

spl_autoload_register(function (string $className) {
    if ($className === 'MyDeprecatedClass') {
        trigger_error(
            'MyDeprecatedClass 已完全废弃，请使用 MyNewClass 替代',
            E_USER_DEPRECATED
        );
        // 加载类文件
        require_once __DIR__ . '/path/to/MyDeprecatedClass.php';
    }
});

这个方案能在类被加载的第一时间就给开发者警示，适合你想彻底淘汰这个类的场景。

内容的提问来源于stack exchange，提问作者vmariano