Silverstripe 4：排除特定用户组查看导航按钮及扩展数据不保存问题

你遇到的核心问题是扩展添加的字段无法保存数据，主要有几个关键原因和对应解决办法：

1. 字段类型与表单控件不匹配 #

你用Varchar(255)存储多选的用户组ID，但开启多选的ListboxField提交的是数组，Silverstripe不会自动将数组转为逗号分隔的字符串存入Varchar字段，导致数据无法正确写入。

解决办法： #

方案一：用ORM多对多关联（推荐）

这是Silverstripe处理多实体关联的标准方式，更规范且易维护：

use SilverStripe\ORM\DataExtension;
use SilverStripe\Security\Group;
use SilverStripe\Forms\ListboxField;

class SiteTreeExtension extends DataExtension
{
    // 定义与Group的多对多关联
    private static $many_many = [
        'ExcludedGroups' => Group::class
    ];

    public function updateSettingsFields($fields)
    {
        $groups = Group::get()->map('ID', 'Title');
        // 字段名对应多对多属性名，自动处理多选数据的保存
        $fields->addFieldToTab('Root.Settings', ListboxField::create(
            'ExcludedGroups',
            '排除特定用户组',
            $groups
        )->setMultiple(true)->setAttribute('size', 4));
    }
}

方案二：手动处理数组与字符串转换（坚持用Varchar时）

如果必须用Varchar存储，需要在写入前把数组转成逗号分隔的字符串，读取时再转回数组：

use SilverStripe\ORM\DataExtension;
use SilverStripe\Security\Group;
use SilverStripe\Forms\ListboxField;

class SiteTreeExtension extends DataExtension
{
    private static $db = [
        'ExcludedRoles' => 'Varchar(255)'
    ];

    public function updateSettingsFields($fields)
    {
        $groups = Group::get()->map('ID', 'Title');
        // 读取时将字符串转成数组作为默认选中值
        $selected = $this->owner->ExcludedRoles ? explode(',', $this->owner->ExcludedRoles) : [];
        $fields->addFieldToTab('Root.Settings', ListboxField::create(
            'ExcludedRoles',
            '排除特定用户组',
            $groups,
            $selected
        )->setMultiple(true)->setAttribute('size', 4));
    }

    // 写入数据库前处理数组转字符串
    public function onBeforeWrite()
    {
        parent::onBeforeWrite();
        $excluded = $this->owner->ExcludedRoles;
        if (is_array($excluded)) {
            $this->owner->ExcludedRoles = implode(',', array_filter($excluded));
        }
    }
}

2. 扩展未正确注册 #

如果没在配置文件中注册你的扩展，Silverstripe不会加载它，自然不会创建字段或处理表单提交。

解决办法： #

在app/_config/extensions.yml中添加扩展注册（替换为你实际的命名空间和类名）：

SilverStripe\CMS\Model\SiteTree:
  extensions:
    - App\Extensions\SiteTreeExtension

3. 未执行数据库迁移 #

添加新字段后，必须执行dev/build更新数据库表结构：

php vendor/bin/sake dev/build flush=all

或在浏览器访问：http://你的域名/dev/build?flush=all

验证步骤 #

完成以上操作后，刷新后台页面设置，选择排除的用户组并保存，再查看数据库对应字段（方案一查看SiteTree_ExcludedGroups关联表，方案二查看SiteTree表的ExcludedRoles字段），即可确认数据已成功保存。

内容的提问来源于stack exchange，提问作者Kamil Wawrzyński