Skip to main content

Module helpers

Module helpers 

Source
Expand description

评论模块的辅助函数:数据转换、校验、哈希与头像生成。

所有工具函数仅在 feature = "server" 启用的服务端构建中使用。

Functions§

compute_content_hash
计算评论内容哈希,用于检测短时间内的重复提交。
format_relative_time
将 UTC 时间格式化为相对时间(刚刚 / N 分钟前 / N 小时前 / N 天前 / 日期)。
gravatar_url
根据邮箱生成 Cravatar(Gravatar 国内镜像)头像 URL。
md5_hash
计算字符串的 MD5 哈希,用于 Gravatar。
row_to_admin_comment
将数据库行转换为后台管理使用的评论结构。
row_to_public_comment
将数据库行转换为前端展示的公开评论结构。
validate_comment_content
校验评论内容:非空且不超过 10000 字符。
validate_comment_email
校验评论作者邮箱格式。
validate_comment_honeypot
校验蜜罐字段:正常用户蜜罐为空,机器人可能填入任意内容。
validate_comment_name
校验评论作者昵称:非空且不超过 50 字符。
validate_comment_url
校验评论作者网址:为空时允许,非空时必须以 http:// 或 https:// 开头、 不含 HTML 特殊字符与空白,且不超过 200 字符。