wp_handle_comment_submission() 是 WordPress 中用于处理评论提交的核心函数之一。它通常在用户提交评论时被调用，负责验证和处理评论数据，并最终将评论插入到数据库中。

✅ 函数作用

wp_handle_comment_submission() 的主要功能是：

• 验证用户提交的评论数据（如评论内容、用户名、邮箱等）
• 检查是否为垃圾评论（通过 Akismet 或其他过滤器）
• 处理评论的插入或更新
• 返回错误信息或成功消息

📌 使用场景

这个函数通常在以下情况下被调用：

• 用户在前端表单提交评论时（例如：wp-comments-post.php 文件中）
• 通过 AJAX 提交评论（例如：使用 wp_ajax_ 动作）

📦 函数定义（WordPress 内部）

该函数位于 WordPress 核心文件中，路径通常是：

wp-includes/comment.php

🧠 函数参数（简要说明）

虽然 wp_handle_comment_submission() 本身不接受参数，但它依赖于全局变量 $_POST 中的值，包括：

• comment_post_ID：文章 ID
• author：评论者名称
• email：评论者邮箱
• url：评论者网站
• comment：评论内容
• comment_type：评论类型（如 “pingback” 或 “trackback”）
• cookies：可能包含 cookie 数据

🧪 示例代码

// 在 wp-comments-post.php 中调用
if ( 'POST' == $_SERVER['REQUEST_METHOD'] && !empty( $_POST['comment'] ) ) {
    $comment_data = wp_handle_comment_submission( wp_unslash( $_POST ) );
    if ( is_wp_error( $comment_data ) ) {
        $error = $comment_data->get_error_message();
        // 显示错误信息
    } else {
        // 成功提交评论
        wp_redirect( get_permalink( $comment_data['comment_post_ID'] ) . '#comment-' . $comment_data['comment_ID'] );
        exit;
    }
}

// 假设 $comment_data 是从 $_POST 获取并经过初步清理的数组
$comment_data = array(
    'comment_post_ID'      => $post_id,
    'comment_author'       => $author,
    'comment_author_email' => $email,
    'comment_content'      => $content,
    // ... 其他字段
);

// 调用核心函数处理
$result = wp_handle_comment_submission($comment_data);

if (is_wp_error($result)) {
    // 处理错误
    $error_code = $result->get_error_code();
    // 返回错误信息给前端
} else {
    // 处理成功
    $comment_id = $result['comment_id'];
    $status = $result['comment_status'];
    // 返回成功信息给前端
}

🛡️ 注意事项

1. 安全性：必须对输入进行清理（如使用 wp_unslash() 和 wp_kses() 等函数）。
2. Akismet 支持：WordPress 默认会检查评论是否为垃圾评论，如果启用 Akismet，则会自动标记为 spam。
3. 钩子与过滤器：
   • preprocess_comment：在评论被保存前处理
   • comment_post：评论被保存后触发
   • comment_approved：评论被批准后触发

📚 相关函数

🔍 常见问题

Q: 为什么我的评论没有被保存？

A: 可能是因为：

• 评论内容为空
• 用户未填写必要字段（如名称、邮箱）
• 被 Akismet 标记为垃圾评论
• 表单提交方式不对（如未使用 POST 方法）

📝 总结

如果你有具体的使用场景或遇到问题，可以告诉我，我可以帮你进一步分析。