October CMS滑块图片上传插件问题：路径未存库及自定义存储需求

核心问题排查与修正 #

1. 修复Controller命名空间错误 #

你的Controller中引入的Osaka\SliderTop\Models\SliderImage命名空间与Model不一致，导致无法正确调用模型、写入数据库，需修正为与Model匹配的命名空间：

<?php namespace MyPlug\SliderTop\Controllers;

use BackendMenu;
use Backend\Classes\Controller;
use MyPlug\SliderTop\Models\SliderImage; // 修正命名空间
use Flash;

/**
 * Slider Images Controller Backend Controller
 */
class SliderImagesController extends Controller
{
    public $implement = [
        \Backend\Behaviors\FormController::class,
        \Backend\Behaviors\ListController::class,
    ];

    public $formConfig = 'config_form.yaml';
    public $listConfig = 'config_list.yaml';
    public $requiredPermissions = ['myplug.slidertop.sliderimagescontroller'];

    public function __construct()
    {
        parent::__construct();
        BackendMenu::setContext('MyPlug.SliderTop', 'slidertop', 'sliderimagescontroller');
    }
}

2. 配置自定义存储路径+确保关联数据写入 #

October CMS的attachOne关联会自动处理文件存储与数据库关联，只需正确配置自定义路径即可：

修正后的Model

<?php namespace MyPlug\SliderTop\Models;

use Model;

class SliderImage extends Model
{
    use \October\Rain\Database\Traits\Validation;

    public $table = 'myplug_slidertop_images';
    // attachOne关联字段无需放入fillable，October会自动处理关联数据
    public $fillable = ['title', 'description'];

    // 配置attachOne关联，指定自定义存储路径
    public $attachOne = [
        'image' => [
            'System\Models\File',
            'disk' => 'public', // 使用public磁盘
            'public' => true // 标记为公开访问
        ]
    ];

    // 自定义存储路径（替代磁盘配置的方案）
    public function getImagePath()
    {
        return 'uploads/slider-top/'; // 相对public目录的自定义路径
    }

    public $rules = [
        'title' => 'required',
        'image' => 'required|image'
    ];
}

可选：配置自定义磁盘

如需更灵活的存储规则，可在config/filesystems.php中添加自定义磁盘：

'disks' => [
    // ...其他磁盘配置
    'slider_disk' => [
        'driver' => 'local',
        'root' => public_path('uploads/slider-top'),
        'url' => env('APP_URL').'/uploads/slider-top',
        'visibility' => 'public',
    ],
],

之后在Model的attachOne中指定disk => 'slider_disk'即可。

3. 确保数据库表结构正确 #

myplug_slidertop_images表无需包含image字段，attachOne关联会自动通过system_files表存储文件信息并建立外键关联。表需包含以下字段：

• id（主键）
• title（字符串）
• description（文本）
• created_at、updated_at（时间戳）

4. 优化列表与表单配置 #

config_list.yaml

# ===================================
#  List Column Definitions
# ===================================
columns:
    title:
        label: 标题
        sortable: true
    description:
        label: 描述
        sortable: true
    image:
        label: 图片
        type: image
        width: 100

config_form.yaml

# ===================================
#  Form Field Definitions
# ===================================
fields:
    title:
        label: 标题
        type: text
        required: true
    description:
        label: 描述
        type: textarea
    image:
        label: 图片
        type: fileupload
        span: full
        mode: image
        imageHeight: 200
        imageWidth: 200
        required: true

验证测试步骤 #

1. 删除public目录下的孤立无效文件
2. 执行php artisan october:up确保数据库表结构正确
3. 进入后端创建新滑块图片，检查：
   • 图片是否上传到自定义路径
   • system_files表是否有对应记录，且attachment_id关联到myplug_slidertop_images的记录ID
   • 后端列表是否正常显示图片缩略图

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