支持服务 | DouPHP 开发手册 | 文档中心 | DouPHP企业建站系统

支持服务

简介

本文件面向DouPHP支持服务开发者，系统梳理评论、留言板、常见问题、在线支持、表单收集及提现管理等客户服务能力，覆盖审核机制、留言管理、FAQ分类、工单处理、表单验证、提现状态流转、消息通知、邮件发送、数据导出与统计分析等技术支持功能。新增的数据服务层文本处理增强功能为数据导出和处理提供了更好的基础支持，确保跨平台数据一致性。文档提供可扩展点说明与安全合规建议，帮助快速落地二次开发与第三方客服系统集成。

项目结构

支持服务在DouPHP中以"模块+分层"组织：

控制器层：负责路由、参数校验、视图/响应组装
服务层：封装业务规则、数据访问、跨模块协作
模型/ORM：数据表映射与查询构建
前端模板：展示与交互
配置与中间件：安全、权限、限流等横切关注点

graph TB
subgraph "后台管理"
A["评论控制器"] --> S1["评论服务"]
B["留言板控制器"] --> S2["留言服务"]
C["FAQ控制器"] --> S3["FAQ服务"]
D["支持控制器"] --> S4["支持服务"]
E["表单控制器"] --> S5["表单服务"]
F["提现控制器"] --> S6["提现服务"]
G["数据管理器"] --> S7["数据服务"]
end
subgraph "核心服务"
S1 --> DB1["评论数据访问"]
S2 --> DB2["留言数据访问"]
S3 --> DB3["FAQ数据访问"]
S4 --> DB4["支持数据访问"]
S5 --> DB5["表单数据访问"]
S6 --> DB6["提现数据访问"]
S7 --> DB7["数据导出处理"]
end
subgraph "外部能力"
M["邮件/短信"]
N["附件存储"]
O["审计日志"]
P["钱包服务"]
Q["用户统计"]
R["文本处理引擎"]
end
S1 -.-> M
S2 -.-> M
S4 -.-> M
S1 -.-> N
S2 -.-> N
S4 -.-> N
E -.-> O
S6 -.-> P
S6 -.-> Q
S6 -.-> O
S7 -.-> R

核心组件

评论子系统：支持按模块/商品维度评论、分页展示、管理员回复、显示控制、批量删除、防灌水策略、订单关联校验等
留言板子系统：留言列表、详情查看、已读标记、管理员回复、隐藏/显示切换、批量操作
FAQ子系统：分类管理、关键词检索、增删改查、多语言按钮、批量操作
在线支持子系统：工单/支持条目管理、分类筛选、富文本内容、草稿与附件、多语言字段
表单收集子系统：自定义表单定义、动态元素、数据录入与查看、状态切换、删除确认、审计日志
提现管理子系统：提现申请审核、状态流转管理、余额扣款与退款、银行卡信息脱敏、批量操作、审计记录
数据服务子系统：统一的文本处理逻辑、换行符标准化、跨平台数据一致性保证、数据导出优化

新增数据服务层通过统一的换行符处理逻辑，将Windows(\r\n)、Unix(\n)、Mac(\r)等不同平台的换行符标准化为\n，确保数据在不同平台间的一致性和可移植性。

架构总览

各子系统的通用流程：

请求进入后台控制器，进行参数校验与权限检查
调用对应服务完成业务逻辑（含数据访问、规则判断、通知触发）
返回视图或JSON响应，必要时写入审计日志
通过统一异常与消息机制反馈结果
数据服务层提供统一的文本处理接口，确保跨平台数据一致性

sequenceDiagram
participant U as "管理员"
participant C as "控制器"
participant S as "服务"
participant DS as "数据服务"
participant WS as "钱包服务"
participant DB as "数据库"
participant EXT as "外部能力(邮件/附件/审计)"
U->>C : 提交表单/操作
C->>C : 参数校验/权限检查
C->>S : 执行业务方法
S->>DS : 文本处理/数据标准化
DS-->>S : 标准化数据
S->>DB : 读写数据
S->>WS : 余额操作提现场景
S-->>EXT : 可选：发送邮件/保存附件/记录审计
S-->>C : 返回结果
C-->>U : 成功/失败提示并跳转

详细组件分析

评论子系统

功能要点
- 列表与分页：按模块与商品ID过滤，仅展示已显示评论
- 详情与回复：读取评论及管理员回复，记录IP与管理员ID
- 显示控制：切换是否前台可见
- 批量删除：批量操作接口
- 防灌水：基于未读评论数量限制重复提交
- 权限校验：可配置是否允许非订单用户评论；订单商品唯一评论限制

关键流程（回复）

sequenceDiagram
participant Admin as "管理员"
participant CC as "评论控制器"
participant CS as "评论服务"
participant DB as "数据库"
Admin->>CC : POST 回复(内容, 商品名, 评论ID)
CC->>CS : reply(id, item_name, content, adminId, ip)
CS->>DB : 写入回复记录
DB-->>CS : 成功
CS-->>CC : 成功
CC-->>Admin : 重定向至列表并提示成功

flowchart TD
Start(["开始"]) --> CheckCfg["读取配置<br/>是否必须包含中文/是否允许无订单评论"]
CheckCfg --> LenCheck{"长度与内容校验通过?"}
LenCheck -- 否 --> Reject["拒绝提交"]
LenCheck -- 是 --> OrderCheck{"需要订单校验?"}
OrderCheck -- 是 --> OrderValid{"订单商品存在且未评论?"}
OrderValid -- 否 --> Reject
OrderValid -- 是 --> WaterCheck{"防灌水检查"}
OrderCheck -- 否 --> WaterCheck
WaterCheck --> WaterPass{"未读评论数<=阈值?"}
WaterPass -- 否 --> Reject
WaterPass -- 是 --> Save["保存评论"]
Save --> End(["结束"])

留言板子系统

功能要点
- 列表分页、详情查看、已读标记（AJAX解耦写库）
- 管理员回复、隐藏/显示切换、批量操作

关键流程（已读标记）

sequenceDiagram
participant Admin as "管理员"
participant GC as "留言板控制器"
participant GS as "留言服务"
Admin->>GC : GET 详情页
Admin->>GC : AJAX POST 标记已读
GC->>GS : markRead(id)
GS-->>GC : 成功
GC-->>Admin : 返回1

常见问题（FAQ）子系统

功能要点
- 分类筛选、关键词搜索、分页
- 新增/编辑/删除、批量操作
- 多语言按钮支持标题、答案等字段

关键流程（新增）

sequenceDiagram
participant Admin as "管理员"
participant FC as "FAQ控制器"
participant FS as "FAQ服务"
participant DB as "数据库"
Admin->>FC : POST 新增(标题/分类/答案/关键字)
FC->>FS : insert(data)
FS->>DB : 插入记录
DB-->>FS : 新ID
FS-->>FC : 新ID
FC-->>Admin : 重定向到编辑页并提示成功

在线支持（工单）子系统

功能要点
- 列表按分类与关键词筛选、分页
- 新增/编辑/删除、批量操作
- 富文本内容与附件草稿、多语言字段

关键流程（新增）

sequenceDiagram
participant Admin as "管理员"
participant SC as "支持控制器"
participant SS as "支持服务"
participant ATT as "附件服务"
participant DB as "数据库"
Admin->>SC : POST 新增(标题/分类/内容/草稿Token)
SC->>ATT : 清理旧草稿/生成新草稿Token
SC->>SS : insert(data, draftToken, adminId)
SS->>DB : 插入支持条目
DB-->>SS : 新ID
SS-->>SC : 新ID
SC-->>Admin : 重定向到编辑页并提示成功

表单收集子系统

功能要点
- 表单定义与元素管理（类型、必填、选项、排序）
- 表单数据列表、详情查看、状态切换、删除确认
- 审计日志记录创建/更新/删除操作

关键流程（新增元素）

sequenceDiagram
participant Admin as "管理员"
participant FMC as "表单控制器"
participant FMS as "表单服务"
participant DB as "数据库"
Admin->>FMC : POST 新增元素(名称/类型/必填/选项)
FMC->>FMS : insertElement(data)
FMS->>DB : 插入元素
DB-->>FMS : 成功
FMS-->>FMC : 成功
FMC-->>Admin : 重定向到编辑页

提现管理子系统

功能要点
- 提现申请列表：支持按用户名、提现单号、时间范围筛选与分页
- 详情查看：显示用户信息、提现金额、银行卡信息（脱敏）、处理记录
- 状态流转管理：待审核→已通过/已驳回→已打款的完整流程控制
- 余额管理：申请时自动扣款，驳回时原路退回
- 银行卡解锁：支持查看被隐藏的银行卡详细信息
- 批量操作：批量删除提现记录
- 审计记录：所有操作均记录管理员审计日志

提现状态流转

stateDiagram-v2
[*] --> 待审核
待审核 --> 已通过 : 核准
待审核 --> 已驳回 : 驳回
已通过 --> 已打款 : 标记已打款
已驳回 --> [*]
已打款 --> [*]
note right of 待审核
余额已在申请时扣除
等待管理员处理
end note
note right of 已通过
管理员核准
款项将线下打款
余额维持扣除
end note
note right of 已打款
线下转账完成
终态
end note
note right of 已驳回
管理员驳回
余额原路退回
终态
end note

sequenceDiagram
participant Admin as "管理员"
participant WC as "提现控制器"
participant WS as "提现服务"
participant DB as "数据库"
participant WALLET as "钱包服务"
Admin->>WC : POST 审核(批准/驳回)
WC->>WS : decide(validated)
alt 批准
WS->>WS : approve(id, handleRecord)
WS->>DB : 更新状态为APPROVED
WS->>DB : 记录处理时间与说明
else 驳回
WS->>DB : 开启事务
WS->>DB : 更新状态为REJECTED
WS->>WALLET : 创建退款记录
WS->>DB : 提交事务
end
WS-->>WC : 重定向URL
WC-->>Admin : 返回列表并提示成功

数据服务子系统（新增）

功能要点
- 统一文本处理：标准化不同平台的换行符处理，确保数据一致性
- 跨平台兼容性：支持Windows(\r\n)、Unix(\n)、Mac(\r)换行符的统一转换
- 数据导出优化：为数据导出和处理提供更好的基础支持
- 文本数组解析：将文本内容按行分割为数组，便于数据处理和展示
- 缓存机制：实例级缓存和查询级缓存，提升数据访问性能

换行符处理流程

flowchart TD
Input["输入文本"] --> Normalize["换行符标准化<br/>str_replace(array('\\r\\n', '\\r'), '\\n', text)"]
Normalize --> Split["按换行符分割<br/>explode('\\n', text)"]
Split --> Array["生成text_array数组"]
Array --> Cache["加入缓存"]
Cache --> Output["输出标准化数据"]

依赖关系分析

控制器与服务解耦：控制器仅做参数校验与响应编排，复杂规则下沉至服务
数据访问集中化：服务内使用统一数据库门面进行查询与分页
扩展点清晰：每个模块均提供独立的Request校验类与Service实现，便于替换或增强
外部能力通过Facade/助手函数接入：如附件、审计、消息、邮件、钱包服务等
数据服务层提供统一的文本处理能力，被多个模块复用

graph LR
CC["评论控制器"] --> CS["评论服务"]
GC["留言板控制器"] --> GBS["留言服务"]
FC["FAQ控制器"] --> FAS["FAQ服务"]
SC["支持控制器"] --> SSS["支持服务"]
FMC["表单控制器"] --> FMS["表单服务"]
WC["提现控制器"] --> WVS["提现服务"]
DC["数据控制器"] --> DSS["数据服务"]
CS --> DB["数据库"]
GBS --> DB
FAS --> DB
SSS --> DB
FMS --> DB
WVS --> DB
DSS --> DB
WVS --> WALLET["钱包服务"]
WVS --> AUDIT["审计服务"]
DSS --> TEXT["文本处理引擎"]

性能考虑

分页与索引
- 评论列表按模块与商品ID过滤并分页，建议在(module, item_id, if_show)建立复合索引以提升查询效率
- 留言板与支持列表同样应针对常用筛选字段建立索引
- 提现列表按用户名、提现单号、时间范围筛选，建议建立相应索引
防灌水与计数
- 防灌水统计对同一IP未读评论计数，建议在(ip, if_read, reply_id)建立索引以减少全表扫描
附件与富文本
- 富文本与附件上传建议走对象存储或CDN，避免阻塞主线程
缓存
- FAQ分类与静态内容可引入缓存层降低热点查询压力
- 数据服务层使用实例缓存和查询缓存，减少重复的文本处理和数据库查询
并发与事务
- 批量操作需保证原子性与幂等，必要时使用事务包裹
- 提现驳回操作使用数据库事务确保余额退款的一致性
文本处理优化
- 统一的换行符处理逻辑减少了重复的代码实现
- 标准化的文本处理提升了数据导出和处理的性能
- 缓存机制避免了重复的字符串操作开销

故障排查指南

常见错误定位
- 非法参数：控制器对id等参数进行合法性校验，失败抛出领域异常并返回上一页
- 数据不存在：编辑/读取时若数据为空，抛出异常并引导返回列表
- 权限不足：未登录或无权限访问将触发统一拦截
- 状态流转错误：提现状态变更不符合预设规则时抛出DomainException
- 文本处理错误：换行符处理异常可能导致数据解析错误，需检查输入数据的格式
日志与审计
- 表单相关操作会记录审计日志，便于追溯变更
- 评论回复记录管理员ID与IP，便于问题溯源
- 提现操作记录完整的审核流程与余额变动
- 数据导出操作记录详细的处理日志，便于追踪数据转换过程
调试建议
- 开启调试模式以便输出详细错误信息
- 结合数据库慢查询日志定位性能瓶颈
- 检查提现状态流转是否符合预期规则
- 验证不同平台间的数据一致性，确保换行符处理正确

结论

DouPHP的支持服务以清晰的控制器-服务分层、完善的表单校验与审计机制，提供了评论、留言板、FAQ、在线支持与表单收集等完整能力。新增的数据服务层文本处理增强功能通过统一的换行符处理逻辑，确保了跨平台数据的一致性和可移植性，为数据导出和处理提供了更好的基础支持。提现管理功能通过WithdrawStatus领域模型实现了严格的提现申请状态流转控制，确保资金安全与业务合规。通过模块化设计与扩展点，可便捷地对接邮件、短信、第三方客服系统与数据分析平台。建议在生产环境完善索引、缓存与监控，确保高可用与可观测性。

附录：开发示例与集成指南

扩展表单字段

步骤
- 在表单元素管理中新增元素（类型、必填、选项、排序）
- 在前端渲染时根据元素类型动态生成控件
- 提交时由Request校验器校验字段白名单与规则
- 服务层持久化并格式化展示
参考路径
- 表单元素新增/更新/删除:204-263
- 表单元素列表与格式化:43-99

自定义评论规则

思路
- 在评论服务中扩展校验逻辑（如敏感词过滤、图片数量限制）
- 在控制器中注入新的Request校验场景
- 通过配置项控制行为（如是否允许无订单评论、是否必须包含中文）
参考路径
- 评论权限与防灌水:121-191
- 全局配置入口:1-53

集成第三方客服系统

方案
- 通过"在线支持"模块作为内部工单入口，对外暴露API供第三方客服系统回调
- 使用邮件/短信服务发送工单状态变更通知
- 通过附件服务上传凭证与截图
参考路径
- 支持条目新增/更新/删除:87-219
- 邮件/短信能力（模块）
- 短信能力（模块）

提现状态扩展

思路
- 在WithdrawStatus领域模型中添加新的状态常量
- 扩展状态迁移表，定义允许的流转规则
- 在提现服务中实现新的状态处理方法
- 更新前端展示逻辑，支持新状态的徽章样式
参考路径
- 提现状态定义:32-51
- 提现审核处理:171-276

数据导出与文本处理优化

思路
- 利用数据服务层的统一文本处理功能，确保导出数据的一致性
- 使用标准化的换行符处理，避免跨平台数据解析问题
- 结合缓存机制提升大数据量导出的性能
参考路径
- 数据服务文本处理:142-146
- Box模型文本处理:179-183
- Fragment模型文本处理:81-85

数据安全、隐私保护与合规

输入校验与XSS防护
- 所有表单提交均经过Request校验器白名单与规则校验
- 富文本内容需进行转义与清洗后再展示
最小权限与审计
- 后台操作均需登录与权限校验
- 关键操作记录审计日志（创建/更新/删除）
- 提现操作记录完整的审核流程与余额变动
- 数据导出操作记录详细的处理日志，便于追踪数据转换过程
数据脱敏与导出
- 导出报表时对敏感字段进行脱敏
- 提现银行卡信息默认脱敏显示，需手动解锁查看
- 限制导出范围与频率，防止数据泄露
- 使用标准化的文本处理确保导出数据在不同平台间的一致性
合规建议
- 遵循个人信息保护法与网络安全法要求
- 对用户评论与留言进行必要的内容审核与留存
- 提现操作需符合金融监管要求，保留完整交易记录
- 确保数据导出符合跨平台数据传输标准

添加日期：2026-10-05