执行wp-cli命令触发PHP类继承与单例模式冲突的Fatal error如何解决

问题根因 #

PHP继承规则明确要求：子类重写父类方法时，访问权限不能比父类更严格。你的父类LocalBusiness构造方法为public，而单例子类FrontLocalBusiness为了禁止外部实例化将构造方法设为private，违反了该规则因此触发致命错误。
仅WP-CLI执行时报错是因为WP-CLI启动时会全量加载所有主题、插件的类文件做语法校验，而正常Web请求一般采用类懒加载机制，且开发/生产环境的错误报告等级通常低于CLI，因此没有触发报错。

解决方案（不破坏FrontLocalBusiness单例模式） #

方案1：修改父类构造方法访问权限（最简便） #

将父类LocalBusiness的__construct()访问权限从public改为protected即可：

class LocalBusiness {
    // 原有公共属性、getter/setter逻辑全部保留
    protected function __construct() {
        // 原有构造逻辑不变
    }
}

• 对FrontLocalBusiness无影响：子类可合法将构造方法声明为private，单例逻辑完全不需要改动
• 对另一个子类AdminLocalBusiness无影响：如果该类需要正常外部实例化，只需在类内声明public __construct()并调用parent::__construct()即可
• 父类代码不需要做其他修改，代码复用需求完全满足

方案2：改用组合模式复用代码（不需要修改父类） #

如果父类构造方法逻辑不允许修改，可放弃继承，改为在FrontLocalBusiness内持有LocalBusiness实例，通过方法转发实现代码复用：

class FrontLocalBusiness {
    private static ?self $instance = null;
    private LocalBusiness $business;

    private function __construct() {
        $this->business = new LocalBusiness();
    }

    public static function getInstance(): self {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    // 直接转发父类的getter/setter方法即可
    public function getBusinessAttr() {
        return $this->business->getBusinessAttr();
    }

    public function setBusinessAttr($value) {
        $this->business->setBusinessAttr($value);
    }
}

该方案完全不需要改动现有父类和单例的外部调用逻辑，仅内部实现从继承改为组合，同样满足代码复用需求。

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