PHP 7.3.x版本单例模式子类继承返回类型声明报错咨询

这个报错是PHP版本特性差异导致的：

• PHP 7.4 才正式引入返回类型协变特性，允许子类方法的返回类型是父类方法返回类型的子类型。
• 你当前使用的PHP 7.3不支持该特性，父类getInstance()声明返回self（实际为TheParent类型），子类重写该方法声明返回self（实际为TheChild类型），会被7.3判定为方法签名不兼容，触发致命错误。

另外你的原有代码还存在两个隐藏问题，即使解决返回类型问题也会报错：

• 父类构造函数为private，子类无法调用parent::__construct()
• 父类单例属性$instance为private，且用self绑定，无法适配子类单例的存储需求

推荐使用「延迟静态绑定+移除强返回类型声明+文档注释补全类型提示」的方案，既兼容PHP 7.3，也能满足继承单例的需求，同时不影响IDE的类型识别：

error_reporting(E_ALL);

class TheParent {
    // 改为protected，允许子类继承访问
    protected static $instance;

    // 改为protected，允许子类调用父类构造
    protected function __construct() {
        // ...
    }

    /**
     * 文档注释标注返回当前调用类的实例，IDE可正常识别类型
     * @return static
     */
    public static function getInstance() {
        // 用static替代self，启用延迟静态绑定，自动匹配调用的子类
        if (static::$instance === null) {
            static::$instance = new static();
        }
        return static::$instance;
    }
}

class TheChild extends TheParent {
    // 子类仅需重写构造函数做自定义逻辑，不需要重写getInstance
    protected function __construct() {
        parent::__construct();
        // 子类自定义初始化逻辑
    }
}

// 测试调用
$child = TheChild::getInstance(); // 返回TheChild实例，PHP7.3下无报错
var_dump($child instanceof TheChild); // bool(true)

该方案的优势：

• 完全兼容PHP7.3及以上所有版本
• 子类不需要重复写单例判断逻辑，减少冗余代码
• 文档注释的@return static可以让IDE正确识别返回的实例类型，不影响开发时的代码提示

如果必须保留强类型返回声明，可以将父类和子类的getInstance返回类型统一声明为object（PHP7.2及以上支持），但依然需要配合文档注释来标注具体的类类型，否则IDE无法识别具体实例类型：

// 仅示例强类型兼容方案，优先推荐上面的方案
public static function getInstance(): object {
    // 逻辑不变
}

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