Laravel表单构建器：如何一次性获取不同类型的关联表单字段模型？

场景说明 #

我正在Laravel中开发一款表单构建工具，拥有Form模型及多个表单字段模型（如Input、Textarea、Select等）。希望通过$form->fields()方法获取指定表单下的所有字段，再遍历生成对应输出。

我认为采用带中间表的多态关联是可行方案，但无法确定正确的关联函数。以下是模型骨架：

class Form extends Model
{
    // 返回该表单下的所有字段
    public function fields() {

    }
}

class Input extends Model
{
    // 返回该输入字段所属的表单
    public function form() {
    
    }
}

class Textarea extends Model
{
    // 返回该文本域字段所属的表单
    public function form() {

    }
}

对应的数据库结构示例：

form
- id

input
- id

textarea
- id

forms_fields
- id
- form_id
- field_id
- field_type

我的疑问：

1. 当前架构是否为实现需求的最优方案？
2. 应使用哪些关联函数？

尝试过morphTo和morphToMany函数但未成功，查阅文档发现场景与示例不符。期望$form->fields()返回字段模型集合，但多次出现SQL错误：select * from "forms" where "forms"."" is null，不知问题出在哪里。

解答 #

1. 当前架构是否最优？ #

你的方案完全可行，适合需要给不同字段类型设置独立属性的场景（比如给Input加maxlength、给Select加options字段）。如果后续字段类型的差异不大，也可以考虑合并成单个fields表，用type字段区分类型，这样能减少模型数量，降低维护成本。

另外建议调整中间表字段名贴合Laravel默认约定：把field_id改成fieldable_id，field_type改成fieldable_type，这样关联时可以省去额外参数配置，减少出错概率。

2. 正确的关联函数写法 #

你需要用多态多对多关联（morphToMany和morphedByMany），以下是适配你现有数据库结构的写法：

Form模型的fields方法

class Form extends Model
{
    public function fields()
    {
        // 参数说明：
        // 1. 关联模型的通用父类（或直接用Model类）
        // 2. 多态关系标识（对应中间表的field_id/field_type）
        // 3. 中间表名
        // 4. 当前模型在中间表的外键
        // 5. 关联模型在中间表的外键
        return $this->morphToMany(
            \Illuminate\Database\Eloquent\Model::class,
            'field',
            'forms_fields',
            'form_id',
            'field_id'
        );
    }
}

Input/Textarea模型的form方法

class Input extends Model
{
    public function form()
    {
        // 参数说明：
        // 1. 关联的Form模型
        // 2. 多态关系标识
        // 3. 中间表名
        // 4. 当前模型在中间表的外键
        // 5. 关联模型在中间表的外键
        return $this->morphedByMany(
            Form::class,
            'field',
            'forms_fields',
            'field_id',
            'form_id'
        );
    }
}

class Textarea extends Model
{
    public function form()
    {
        return $this->morphedByMany(
            Form::class,
            'field',
            'forms_fields',
            'field_id',
            'form_id'
        );
    }
}

关于SQL错误的说明 #

你遇到的select * from "forms" where "forms"."" is null错误，是因为关联函数的参数配置不完整，Laravel无法识别正确的关联字段，导致生成了无效的SQL条件。按照上面的写法配置完整参数后，这个问题就能解决。

另外需要注意：中间表的field_type字段必须存储完整的模型类名（比如App\Models\Input），Laravel才能正确实例化对应的模型。

内容的提问来源于stack exchange，提问作者Peter B.