萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> CMS 教學

DedeCMS 織夢自定義表單/模型實現多步分步提交開發實戰記錄

項目背景

企業級問卷/報名系統常面臨字段過多(30+)導致用戶放棄率高的問題。需將單頁長表單拆分為多步驟(如:基本信息 → 業務需求 → 確認提交),並實現數據暫存、防重複提交、字段篩選等高級功能。

技術棧與架構決策

  • 基礎框架: DedeCMS 5.7 自定義模型(而非簡單表單),支持字段類型豐富、權限體系完善
  • 數據暫存: $_SESSION 分步存儲 → 最後一步寫入數據庫
  • 防重複提交: 表單令牌 + 用戶 IP/UID 限制 + 數據庫唯一索引
  • 字段篩選: 後台列表頁增加字段級篩選器(下拉/多選/日期區間)

核心功能實現亮點

1. 字段分步顯示配置化

在模型管理界面新增「步驟編號」字段屬性(1/2/3...),前台模板讀取該屬性動態渲染對應步驟字段,無需硬編碼。

2. 聯動字段顯示模式擴展

原生僅支持 <select>,擴展支持 checkbox(多選)、radio(單選)渲染,適配不同業務場景。

3. 表單變量控制(準入門檻)

  • 全局開關:是否允許匿名提交
  • 頻率控制:同 IP/UID 24h 內最多提交 N 次
  • 時間窗口:指定活動開始/結束時間

4. 後台管理增強

  • 列表頁按任意字段篩選(如:城市=北京、意向產品=課程A、提交時間=本週)
  • 導出 Excel 支持勾選字段、篩選條件
  • 狀態流轉:草稿 → 已提交 → 審核中 → 通過/駁回

開發週期與交付

  • 開發週期:3 個工作日
  • 已上線項目:新東方學員問診系統(日均提交 200+)
  • 代碼複用率:模型配置化設計使新增問卷僅需後台點擊配置,零代碼

關鍵代碼片段(核心邏輯)

前台分步控制器邏輯

// 步驟驗證與數據暫存
$step = max(1, intval($_GET['step']));
$max_step = 3;

if ($_POST) {
    // 字段驗證(根據模型配置動態生成規則)
    $validate = validate_fields($_POST, $model_fields[$step]);
    if ($validate !== true) {
        show_msg($validate, -1);
    }
    // 合併 Session 數據
    $_SESSION['form_data'] = array_merge($_SESSION['form_data'], $_POST);
    // 防重複提交 Token 驗證
    if (!check_form_token($_POST['token'])) {
        show_msg('請勿重複提交', -1);
    }
    
    if ($step == $max_step) {
        // 最後一步:寫入數據庫
        $aid = insert_archives($_SESSION['form_data']);
        unset($_SESSION['form_data']);
        show_msg('提交成功', "success.php?aid=$aid");
    } else {
        // 跳轉下一步
        header("Location: ?step=" . ($step + 1));
        exit;
    }
}

// 讀取 Session 預填表單
$form_data = $_SESSION['form_data'] ?? array();

後台字段篩選器生成

// 根據模型字段配置動態生成篩選 SQL
$where = '1=1';
foreach ($filter_fields as $field => $config) {
    $val = $_GET[$field];
    if ($val !== '') {
        switch ($config['type']) {
            case 'select':
            case 'radio':
                $where .= " AND `$field` = '$val'";
                break;
            case 'checkbox':
                $where .= " AND FIND_IN_SET('$val', `$field`)";
                break;
            case 'date':
                $where .= " AND `$field` BETWEEN '$val[0]' AND '$val[1]'";
                break;
        }
    }
}

效果預覽

步驟1:基本信息

步驟2:業務需求

步驟3:確認提交

總結與反思

  • 優勢: 基於 Dede 模型二次開發,上手快、權限體系現成、適合中小企業快速交付
  • 不足: 代碼重復率高(缺乏 MVC 分層),維護成本隨項目增長上升
  • 展望: 引入 Composer 自動加載、Service 層封裝業務邏輯、Vue/React 重構前台交互,向現代化 PHP 框架演進

給開發者的建議

  1. 優先使用「模型配置化」而非「硬編碼字段」,提升復用性
  2. Session 暫存數據設置合理過期時間(如 30 分鐘),防止垃圾數據堆積
  3. 所有用戶輸入經過 htmlspecialchars() 入庫,輸出時按上下文編碼
  4. 重要操作(提交、導出)記錄操作日志(UID、IP、時間、動作)
copyright © 萬盛學電腦網 all rights reserved