Laravel中模型继承的最佳实践与查询实现问询

一、数据库表结构选择 #

推荐使用单表继承（Single Table Inheritance, STI），仅需一张animals表，通过type字段区分不同子类。这种方案查询效率高，无需复杂关联，适配你的层级结构（Animal → Dog → 具体犬种）。

迁移示例：

Schema::create('animals', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->string('type'); // 存储值：animal、dog、golden_retriever、daschund
    $table->integer('age')->nullable();
    $table->float('weight')->nullable();
    // 若有子类专属字段，可直接添加（比如狗的`tail_length`），允许空值即可
    $table->timestamps();
});

如果后续不同子类出现大量专属字段，再考虑拆分多表（比如animals存通用数据，dogs存狗专属数据，通过外键关联），但初期单表是最优选择。

二、模型继承实现 #

按照层级关系创建模型，利用Laravel模型继承特性，同时通过全局作用域自动过滤子类数据：

1. 定义发声接口 #

interface MakesSound
{
    public function makeSound(): string;
}

2. 基类Animal模型 #

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;

class Animal extends Model implements MakesSound
{
    protected $table = 'animals';
    protected $discriminatorColumn = 'type';
    
    // 映射type值到对应模型类
    protected static $typeMap = [
        'animal' => self::class,
        'dog' => Dog::class,
        'golden_retriever' => GoldenRetriever::class,
        'daschund' => Daschund::class,
    ];

    // 全局作用域：自动过滤当前模型对应的type数据
    protected static function booted()
    {
        static::addGlobalScope('type_filter', function (Builder $builder) {
            $currentType = array_search(static::class, static::$typeMap);
            if ($currentType) {
                $builder->where(static::$discriminatorColumn, $currentType);
            }
        });
    }

    // 创建模型时自动设置type字段
    protected static function boot()
    {
        parent::boot();
        static::creating(function ($model) {
            $model->{$model->discriminatorColumn} = array_search(static::class, static::$typeMap);
        });
    }

    // 默认发声实现
    public function makeSound(): string
    {
        return 'Generic animal sound';
    }
}

3. Dog模型（继承Animal） #

class Dog extends Animal
{
    // 重写发声方法
    public function makeSound(): string
    {
        return 'Woof!';
    }
}

4. GoldenRetriever模型（继承Dog） #

class GoldenRetriever extends Dog
{
    // 重写发声方法
    public function makeSound(): string
    {
        return 'Soft, gentle woof!';
    }
}

5. Daschund模型（继承Dog） #

class Daschund extends Dog
{
    // 重写发声方法
    public function makeSound(): string
    {
        return 'High-pitched yip!';
    }
}

三、特定子类查询 #

通过全局作用域的自动过滤，可直接用子类模型查询对应数据：

• 查询所有动物：$animals = Animal::get();
• 查询所有狗（含金毛、腊肠）：$dogs = Dog::get();
• 查询仅金毛：$goldens = GoldenRetriever::get();
• 查询仅腊肠：$daschunds = Daschund::get();

如果需要从Animal实例转换为对应子类模型，可在基类添加转换方法：

public function resolveChildModel()
{
    $type = $this->{$this->discriminatorColumn};
    $class = static::$typeMap[$type] ?? self::class;
    return new $class($this->attributes);
}

使用示例：

$animal = Animal::find(1);
$childModel = $animal->resolveChildModel();
echo $childModel->makeSound(); // 自动调用对应子类的发声方法

四、Laravel相关参考方向 #

• 官方文档的模型继承章节：了解Laravel模型的继承特性
• 官方文档的全局作用域章节：掌握如何为模型添加自动过滤逻辑
• Eloquent模型的事件（creating钩子）：学习模型创建时的自动字段赋值

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