首次开发WordPress群发邮件插件 表单触发wp_mail报严重错误如何解决

错误根源 #

• 提前输出错误：你将isset($_POST['button1'])的判断逻辑直接写在插件全局作用域，触发时直接调用showtext()执行echo输出，PHP在发送响应头前不允许有任何输出，WordPress后续加载会话、Cookie相关逻辑时就会抛出严重错误。
• 短代码规范不符合：短代码回调函数要求返回要渲染的内容，不能直接用echo输出，否则会导致内容渲染位置错乱，也容易触发提前输出问题。
• 逻辑分离问题：表单提交触发逻辑和发信逻辑分离，没有做请求时机校验，部分核心函数可能未完成加载就被调用。
• 缺少安全校验：没有CSRF防护、权限校验逻辑，上线后会存在被恶意调用滥发邮件的风险。

修复后的完整代码 #

// 注册短代码
add_shortcode( 'helloworld', 'group_email_shortcode' );
function group_email_shortcode() {
    // 仅允许管理员使用该功能，可根据需求修改权限规则
    if ( ! current_user_can( 'manage_options' ) ) {
        return '您没有权限使用该功能';
    }

    $output = '';
    // 处理表单提交
    if ( isset( $_POST['group_email_submit'] ) && wp_verify_nonce( $_POST['group_email_nonce'], 'send_group_email' ) ) {
        // 校验输入内容
        $subject = sanitize_text_field( $_POST['email_subject'] );
        $message = sanitize_textarea_field( $_POST['email_content'] );
        if ( empty( $subject ) || empty( $message ) ) {
            $output .= '<p style="color:red;">请填写完整的邮件主题和内容</p>';
        } else {
            // 获取所有注册用户的邮箱
            $users = get_users( array( 'fields' => 'user_email' ) );
            $all_sent = true;
            // 批量发信
            foreach ( $users as $email ) {
                $send_res = wp_mail( $email, $subject, $message );
                if ( ! $send_res ) {
                    $all_sent = false;
                }
            }
            // 返回发信结果
            if ( $all_sent ) {
                $output .= '<p style="color:green;">所有邮件已发送成功</p>';
            } else {
                $output .= '<p style="color:red;">部分邮件发送失败，请检查邮件服务配置</p>';
            }
        }
    }

    // 渲染表单
    $output .= '
    <form method="post">
        ' . wp_nonce_field( 'send_group_email', 'group_email_nonce', true, false ) . '
        <p>
            <label>邮件主题：</label>
            <input type="text" name="email_subject" required style="width:100%;margin-top:8px;" />
        </p>
        <p>
            <label>邮件内容：</label>
            <textarea name="email_content" required rows="8" style="width:100%;margin-top:8px;"></textarea>
        </p>
        <p>
            <input type="submit" name="group_email_submit" value="发送给所有注册用户" />
        </p>
    </form>
    ';

    return $output;
}

使用说明 #

• 直接将短代码[helloworld]嵌入到需要展示表单的页面即可使用
• 默认仅站点管理员可以访问和使用发信功能，如需调整权限可修改current_user_can('manage_options')对应的权限规则
• 表单提交后会自动拉取所有注册用户的邮箱批量发送，发信结果会直接在当前页面展示

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