声明变量/函数类型时，AbstractModel与ModelInterface哪个更合适？

你的核心矛盾是依赖倒置原则（DIP）的遵守和IDE方法提示的便利性之间的冲突，我们先拆解两种选择的问题，再给出针对性解决办法：

两种选择的固有问题 #

• 若使用AbstractModel：直接违反DIP——DIP要求高层模块依赖抽象（接口）而非具体实现，抽象类属于带有部分实现的上层实体，并非纯粹的抽象契约，依赖它会降低代码的灵活性和可替换性。
• 若使用ModelInterface：IDE仅能识别接口中声明的方法，无法提示AbstractModel中已实现的通用方法，增加开发过程中的记忆成本和出错概率。

最优解决方案：从设计层面补全抽象契约 #

DIP的核心是客户端依赖的抽象必须包含其所需的所有行为，如果你的代码需要调用$model->foo()，而foo()仅存在于AbstractModel中，说明当前的ModelInterface设计不完整。正确的做法是：

1. 将AbstractModel中需要被外部调用的方法（比如foo()）声明到ModelInterface中；
2. 让AbstractModel实现ModelInterface并提供这些方法的通用实现；
3. 具体模型继承AbstractModel即可自动满足接口契约。

调整后的代码示例：

interface ModelInterface {
    public function foo(); // 补全客户端需要调用的方法声明
}

abstract class AbstractModel implements ModelInterface {
    public function foo() {
        // 通用实现逻辑
    }
}

// 具体模型无需重复实现foo()，直接继承即可
class UserModel extends AbstractModel {}

此时在所有????位置使用ModelInterface：

• 完全符合DIP，依赖的是纯粹的抽象契约；
• IDE会自动提示接口中声明的所有方法（包括foo()），而这些方法的实现由AbstractModel提供，不影响开发体验。

妥协方案：使用PHP交集类型（PHP 8.0+） #

如果无法修改现有接口设计（比如历史代码限制），可以利用PHP 8.0引入的交集类型，同时声明接口和抽象类：

/** @var ModelInterface&AbstractModel $model */
$model = new $modelName();
$model->foo();

function baz(ModelInterface&AbstractModel $model) {}

function bar(): ModelInterface&AbstractModel {}

这种方式既保留了对ModelInterface的依赖（符合DIP的核心要求），又能让IDE识别AbstractModel中的方法，实现提示功能。但这是一种妥协方案，优先推荐从设计层面补全接口的做法。

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