WordPress中如何将HTML表单数据插入独立自定义MySQL数据库

1. 处理表单的PHP文件存放位置 #

优先选择两种合规的存放路径，避免WordPress版本更新或主题更新覆盖代码：

• 子主题目录存放：如果你已启用子主题，可在wp-content/themes/你的子主题名/下新建inc目录，将处理逻辑放在inc/team-form-handler.php中，再在子主题的functions.php里用require_once get_stylesheet_directory() . '/inc/team-form-handler.php';引入即可
• 自定义插件存放：更推荐不依赖主题的方案，在wp-content/plugins/下新建custom-team-manager目录，新增入口文件custom-team-manager.php，所有逻辑都放在该插件目录下，在后台启用插件即可生效

2. 表单提交逻辑调用方式 #

直接使用WordPress官方提供的admin-post统一入口处理提交请求，不需要单独编写裸PHP入口文件，表单结构示例如下：

<form method="post" action="<?php echo esc_url( admin_url('admin-post.php') ); ?>">
    <?php wp_nonce_field('team_form_submit', 'team_nonce'); // 安全校验字段 ?>
    <input type="hidden" name="action" value="submit_team_info">
    <!-- 以下为你自定义的表单字段 -->
    <label>战队名称：<input type="text" name="team_name" required></label>
    <label>战队介绍：<textarea name="team_desc" required></textarea></label>
    <button type="submit">提交战队信息</button>
</form>

3. 接收表单数据与安全校验 #

通过WordPress钩子绑定你定义的action名，即可触发对应的处理逻辑，代码示例如下：

// 仅允许登录用户提交的场景，如果需要允许游客提交可额外添加admin_post_nopriv_submit_team_info钩子
add_action('admin_post_submit_team_info', 'handle_team_info_submit');
function handle_team_info_submit() {
    // 安全校验：验证请求合法性
    if (!isset($_POST['team_nonce']) || !wp_verify_nonce($_POST['team_nonce'], 'team_form_submit')) {
        wp_die('非法请求，校验失败');
    }
    // 校验用户登录状态
    if (!is_user_logged_in()) {
        wp_redirect(wp_login_url());
        exit;
    }
    // 获取表单数据并做基础过滤
    $user_id = get_current_user_id();
    $team_name = sanitize_text_field($_POST['team_name']);
    $team_desc = sanitize_textarea_field($_POST['team_desc']);
    // 可自行扩展自定义校验规则，比如战队名字数限制、特殊字符过滤等
    if (mb_strlen($team_name) > 20) {
        wp_redirect(add_query_arg('submit_status', 'invalid_name', wp_get_referer()));
        exit;
    }
    // 调用插入函数写入独立数据库
    $insert_result = insert_team_to_custom_db($user_id, $team_name, $team_desc);
    // 根据处理结果跳转回表单页并携带状态参数
    if ($insert_result) {
        wp_redirect(add_query_arg('submit_status', 'success', wp_get_referer()));
    } else {
        wp_redirect(add_query_arg('submit_status', 'error', wp_get_referer()));
    }
    exit;
}

4. 独立数据库插入函数编写 #

直接复用你之前已经实现的PDO连接逻辑即可，插入操作必须用预处理语句避免SQL注入，代码示例如下：

function insert_team_to_custom_db($user_id, $team_name, $team_desc) {
    // 数据库配置建议统一在wp-config.php中定义常量，不要硬编码在逻辑文件中
    $db_host = CUSTOM_TEAM_DB_HOST;
    $db_name = CUSTOM_TEAM_DB_NAME;
    $db_user = CUSTOM_TEAM_DB_USER;
    $db_pass = CUSTOM_TEAM_DB_PWD;
    try {
        $pdo = new PDO("mysql:host=$db_host;dbname=$db_name;charset=utf8mb4", $db_user, $db_pass);
        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        // 预处理SQL
        $sql = "INSERT INTO 你的战队表名 (user_id, team_name, team_desc, create_time) VALUES (?, ?, ?, ?)";
        $stmt = $pdo->prepare($sql);
        $stmt->execute([$user_id, $team_name, $team_desc, current_time('mysql')]);
        // 返回插入成功的主键ID
        return $pdo->lastInsertId();
    } catch(PDOException $e) {
        // 错误日志记录，生产环境不要直接输出错误详情
        error_log('战队信息插入失败: ' . $e->getMessage());
        return false;
    }
}

5. 前端提交结果展示 #

在你放置表单的页面添加如下代码，即可根据状态参数展示对应提示：

if (isset($_GET['submit_status'])) {
    switch ($_GET['submit_status']) {
        case 'success':
            echo '<p class="success-tip">战队信息提交成功</p>';
            break;
        case 'invalid_name':
            echo '<p class="error-tip">战队名称不能超过20字符</p>';
            break;
        case 'error':
            echo '<p class="error-tip">提交失败，请稍后重试</p>';
            break;
    }
}

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