如何在CraftCMS的Redactor编辑器中修正图片路径问题

我之前在Craft项目里也碰到过一模一样的Redactor图片路径问题，折腾了好一会儿才搞定，给你几个靠谱的解决方案：

1. 直接修改Redactor配置，指定上传URL前缀 #

你可以在现有的Redactor JSON配置里添加imageUploadUrl和imageUploadPath参数，强制生成带开头斜杠的路径。修改后的配置如下：

{
  "buttons": ["formatting", "bold", "italic", "unorderedlist", "orderedlist", "link", "image", "video", "html"],
  "plugins": ["fullscreen", "video"],
  "linkNewTab": true,
  "toolbarFixed": true,
  "imageFigure": false,
  "imageUploadUrl": "/assets/images/",
  "imageUploadPath": "@webroot/assets/images/"
}

• imageUploadUrl是前端访问的URL前缀，必须以斜杠开头，对应你实际的图片上传目录的URL路径
• imageUploadPath是服务器端的绝对路径（可以用Craft的别名比如@webroot），指向图片存储的物理位置

2. 调整Craft资产卷的URL前缀设置 #

如果你的图片是存在Craft的资产卷（Asset Volume）里的，直接修改资产卷的配置更省心：

• 进入Craft后台的设置 → 资产卷
• 找到你用来存储博客图片的资产卷，点击编辑
• 在“URL前缀”字段里，确保开头带有斜杠，比如填写/assets/images而不是assets/images
• 保存设置后，新上传的图片就会自动生成带开头斜杠的相对路径；你也可以在“URL设置”里选择“绝对URL”，直接生成完整的https://www.website.com/...格式路径

3. 用自定义模块/钩子强制修正路径 #

如果上面两种方法都不适用，你可以通过Craft的事件钩子来拦截Redactor输出的内容，手动给图片路径添加斜杠：

• 创建一个自定义模块，监听beforeSave事件（针对博客条目）
• 在事件处理函数里，取出Redactor字段的内容，用正则表达式匹配所有<img>标签的src属性，给缺少开头斜杠的路径加上斜杠
  示例代码（放在模块的init()方法里）：

use craft\events\ModelEvent;
use craft\elements\Entry;
use yii\base\Event;

Event::on(
    Entry::class,
    Entry::EVENT_BEFORE_SAVE,
    function(ModelEvent $event) {
        /** @var Entry $entry */
        $entry = $event->sender;
        // 假设你的Redactor字段handle是`blogContent`
        if ($entry->section->handle === 'blog' && isset($entry->blogContent)) {
            // 正则匹配并修正img的src路径
            $entry->blogContent = preg_replace('/<img([^>]+)src="(?!\/|http)([^"]+)"/', '<img$1src="/$2"', $entry->blogContent);
        }
    }
);

这些方法里，前两种是最简便的，优先推荐调整资产卷或者Redactor配置，第三种适合需要特殊逻辑的场景。

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