SilverStripe 3.4：如何将默认记录从模型添加到数据库

Question

无法在SilverStripe Documentation 中找到如何让 DataObject 模型在 /dev/build 上注入一组默认记录

谁能指出我正确的方向

这是我目前拥有的，显然我想将预先配置的选项注入到我的模块的这个恰当命名的配置模型中。

class Configuration extends DataObject
{
    private static $db = array(
        'Option' => 'Varchar',
        'Value'  => 'Varchar'
    );

    private static $summary_fields = array(
        'Option' => 'Option',
        'Value'  => 'Value',
    );
}

提前感谢任何方向/指针。

更新 我被下面的@Barry 转到了 SiteConfig

但是按照他的做法，requireDefaultRecords() 没有注入默认值

注意：我已经重新访问了 /dev/build?flush

class RMSConfiguration extends DataExtension
{
    private static $db = array(
        'username'  => 'Varchar',
        'password'  => 'Varchar',
        'agent_id'  => 'Varchar(15)',
        'client_id' => 'Varchar(15)',
        'testMode'  => 'Int(1)',
        'timezone'  => 'Varchar',
        'apiUrl'    => 'Varchar(255)'
    );

    public function updateCMSFields(FieldList $fields)
    {
        $fields->addFieldsToTab(
            "Root.RMSConfig",
            array(
                TextField::create('username', 'RMS Username'),
                TextField::create('password', 'RMS Password'),
                TextField::create('agent_id', 'RMS Agent ID'),
                TextField::create('client_id', 'RMS Client ID'),
                TextField::create('apiUrl', 'API Url'),
                CheckboxField::create("testMode", 'Toggle Test Mode'),
                DropdownField::create("timezone", 'Timezone', static::$timezones)
            )
        );

    }

    public function requireDefaultRecords()
    {
        parent::requireDefaultRecords();

        $arrOptions = array(
            'timezone' => 'Australia/Sydney',
            'apiUrl'   => 'https://api.example.com.au/',
            'testMode' => 0
        );

        foreach ($arrOptions as $strOption => $strValue) {
            if (!$configuration = self::get()->filter('Option', $strOption)->first()) {
                $configuration = self::create(array( 'Option' => $strOption ));
            }

            $configuration->Value = $strValue;
            $configuration->write();
        }
    }

    /**
     * List of timezones supported by PHP >=5.3.x
     *
     * @var array
     */
    public static $timezones = array(
        "Africa/Abidjan",
        "Africa/Accra",
        "Africa/Addis_Ababa",
        "Africa/Algiers",
        ...
        ...
        "Zulu"
    );
}

Answer 1

在 DataObject 中使用函数 requireDefaultRecords - 在每个 dev/build 期间都会调用此函数。

注意：首先检查是否存在防止重复的选项，因为每次开发构建时都会调用它。

class Configuration extends DataObject {

    private static $db = array(
        'Option' => 'Varchar',
        'Value'  => 'Varchar'
    );

    private static $summary_fields = array(
        'Option' => 'Option',
        'Value'  => 'Value',
    );

    function requireDefaultRecords() {
        parent::requireDefaultRecords();

        $arrOptions = array(
            'Option1' => 'Value1',
            'Option2' => 'Value2',
            'Option3' => 'Value3',
        );

        foreach ($arrOptions as $strOption => $strValue) {
            if (!$configuration = Configuration::get()->filter('Option',$strOption)->first())
                $configuration = Configuration::create(array('Option' => $strOption));

            $configuration->Value = $strValue;
            $configuration->write();
        }
    }
}

最后一条评论是 SiteConfig 有一个 module SiteConfig，它被 SilverStripe、大多数模块使用，我建议您在其中放置这样的配置值。

如果您确实选择了SiteConfig，那么请查看函数populateDefaults 和documentation 的用法，这是一个示例...

/**
 * Sets the Date field to the current date.
 */
public function populateDefaults() {
    $this->Date = date('Y-m-d');
    parent::populateDefaults();
}

（如果在扩展中使用上述内容，则可能需要$this->owner->Date 而不是$this->Date）

如果所有值都是静态的，则不需要上述函数，而是仅从该数组中读取它们（同样在 DataObject 中）

public static $defaults = array(
    'Option1'  => 'Value1',
    'Option2'  => 'Value2'
);

这也适用于任何DataObject，但由于SiteConfig 管理一个记录，并且在创建时填充该记录，这比requireDefaultRecords 更方便使用。