Silverstripe 3：如何强制HTMLEditorField上传图片至指定目录？

你说得没错，HTMLEditorField的官方文档确实没有像UploadField那样明确的setFolderName方法，但通过结合SilverStripe的配置和TinyMCE的钩子，完全可以实现全局或单个字段的自定义上传目录。下面是两种可靠的方案：

方案1：单个字段自定义（推荐） #

这个方法允许你为每个HTMLEditorField单独指定上传目录，不需要修改全局配置。

步骤1：创建自定义HTMLEditorField扩展 #

首先，创建一个继承自HTMLEditorField的自定义类，添加设置上传目录的方法，并配置TinyMCE的文件浏览器指向目标文件夹：

class CustomHtmlEditorField extends HTMLEditorField {
    protected $uploadFolder = 'Uploads'; // 默认目录

    // 设置自定义上传目录
    public function setUploadFolder(string $folderPath): self {
        $this->uploadFolder = $folderPath;
        return $this;
    }

    public function getUploadFolder(): string {
        return $this->uploadFolder;
    }

    // 初始化时配置TinyMCE的文件浏览器
    public function FieldHolder($properties = []) {
        // 自动创建目标文件夹（如果不存在）
        $targetFolder = Folder::find_or_make($this->getUploadFolder());

        // 让TinyMCE的媒体管理器默认打开这个文件夹
        $this->setConfig(
            'file_browser_callback',
            function() use ($targetFolder) {
                return Controller::join_links(
                    admin_url('assets/show'),
                    '?ID=' . $targetFolder->ID
                );
            }
        );

        // 可选：强制上传文件保存到该目录（防止用户手动选择其他目录）
        $this->setConfig(
            'upload_handler',
            function($file) use ($targetFolder) {
                $file->ParentID = $targetFolder->ID;
                $file->write();
                return $file;
            }
        );

        return parent::FieldHolder($properties);
    }
}

步骤2：在CMS字段中使用自定义编辑器 #

在你的Page或DataObject类的getCMSFields方法中，替换默认的HTMLEditorField为自定义类，并设置上传目录：

public function getCMSFields() {
    $fields = parent::getCMSFields();

    // 替换原有字段，设置自定义上传目录
    $customEditor = CustomHtmlEditorField::create('Content', 'Custom Editor')
        ->setUploadFolder('CustomUploads/MyArticleImages');

    $fields->replaceField('Content', $customEditor);

    // 添加另一个不同目录的编辑器
    $anotherEditor = CustomHtmlEditorField::create('SidebarContent', 'Sidebar Editor')
        ->setUploadFolder('CustomUploads/SidebarAssets');

    $fields->addFieldToTab('Root.Main', $anotherEditor);

    return $fields;
}

方案2：全局配置（适用于所有编辑器） #

如果你想让所有HTMLEditorField都使用同一个自定义目录，可以在mysite/_config.php中配置全局的HtmlEditorConfig：

// 获取默认的CMS编辑器配置
$editorConfig = HtmlEditorConfig::get('cms');

// 设置默认上传目录
$targetFolder = Folder::find_or_make('CustomUploads/GlobalEditorAssets');

// 配置TinyMCE的文件浏览器默认打开该目录
$editorConfig->setOption(
    'file_browser_callback',
    function() use ($targetFolder) {
        return Controller::join_links(
            admin_url('assets/show'),
            '?ID=' . $targetFolder->ID
        );
    }
);

关键注意事项 #

• 确保目标目录的权限正确，SilverStripe需要有读写权限来创建文件夹和保存文件。
• 如果需要强制用户只能上传到指定目录（不能手动切换到其他文件夹），可以结合AssetAdmin的权限控制，或者在File的onBeforeWrite钩子中强制设置ParentID。
• 上述代码基于SilverStripe 4.x/5.x版本，如果你使用的是旧版本，可能需要调整API调用（比如admin_url在旧版本中是Director::baseURL() . 'admin/'）。

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