OctoberCMS 3.6版本中关系型表单渲染问题的解决方案

在OctoberCMS 3.6版本升级后，开发者可能会遇到一个关于关系型表单渲染的兼容性问题。本文将详细分析问题原因并提供解决方案。

问题现象

当使用morphMany关系类型并通过partial渲染关联数据时，系统会抛出"Call to undefined method Backend\Widgets\Lists::setFormValues"错误。这个问题在3.5.x版本中不存在，但在升级到3.6.11版本后出现。

问题根源

OctoberCMS 3.6版本对关系控制器进行了重要改进，现在它会初始化所有必要的widgets，无论它们是否被使用。而在3.5版本中，系统会尝试猜测哪些widgets被使用。这一改变主要是为了支持嵌套关系的正确功能。

解决方案

开发者需要调整控制器中的方法重写方式。具体有以下两种解决方案：

方案一：类型检查（向后兼容）

在relationExtendManageWidget或relationExtendViewWidget方法中，添加对widget类型的检查：

public function relationExtendManageWidget($widget, $field, $model)
{
    if ($widget instanceof \Backend\Widgets\Form) {
        // 你的代码逻辑
    }
}

方案二：使用新的方法名称（推荐）

直接将方法重命名为对应的新方法名：

旧方法名	新方法名
relationExtendViewWidget	relationExtendViewFormWidget
relationExtendManageWidget	relationExtendManageFormWidget

例如，将：

public function relationExtendManageWidget($widget, $field, $model)

改为：

public function relationExtendManageFormWidget($widget, $field, $model)

最佳实践

对于新项目，建议直接使用新的方法名。对于现有项目升级，可以先采用类型检查方案，然后逐步迁移到新的方法名。

这一改进虽然带来了短暂的兼容性问题，但为OctoberCMS的关系处理能力带来了更强大的功能支持，特别是对复杂嵌套关系的处理能力得到了显著提升。