WordPress 短代码“无效 JSON 响应”错误排查与最佳实践

<?php
function my_custom_shortcode_function() {
    // 开启输出缓冲
    ob_start();

    // 在这里放置所有需要输出的HTML和PHP逻辑
    // 例如，一个简单的表单
    ?>
    <form method="POST">
        <input type="text" name="filter" placeholder="输入关键词..."/>
        <input type="submit" value="搜索"/>
    </form>
    <?php

    // 获取缓冲区内容并返回
    return ob_get_clean();
}
add_shortcode('my_custom_shortcode', 'my_custom_shortcode_function');
?>

<?php
function my_secure_shortcode_function() {
    global $wpdb;
    ob_start();

    $table_name = $wpdb->prefix . 'my_custom_table'; // 推荐使用 $wpdb->prefix 获取表前缀
    $filter = isset($_POST['filter']) ? sanitize_text_field($_POST['filter']) : ''; // 始终对用户输入进行清理

    // 假设 form.html 包含搜索表单
    require_once( WP_PLUGIN_DIR . '/your-plugin-dir/assets/runtime/shortcode/form.html' );

    // 构建安全的查询
    // 注意：这里的 %s 占位符是用于 $table_name 的，因为表名不能直接通过 prepare 转义
    // 但在实际中，表名通常是固定的，或者通过白名单验证，而不是用户输入
    // 对于 LIKE 模式中的 %，需要使用 %% 进行双重转义
    $query = $wpdb->prepare(
        "SELECT id, column1, column2, column3 FROM {$table_name} WHERE column1 LIKE %s OR id LIKE %s",
        '%' . $wpdb->esc_like($filter) . '%', // 使用 $wpdb->esc_like() 转义 LIKE 模式中的特殊字符
        '%' . $wpdb->esc_like($filter) . '%'
    );

    $results = $wpdb->get_results( $query, ARRAY_A );

    if ( ! empty( $results ) ) {
        ?>
        <table>
            <tr>
                <th>列1</th>
                <th>列2</th>
                <th>列3</th>
            </tr>
            <?php foreach ( $results as $row ) : ?>
                <tr>
                    <td><a href="<?php echo esc_url(site_url('/displayjobs?id=' . $row['id'])); ?>"><?php echo esc_html($row['column1']); ?></a></td>
                    <td><?php echo esc_html($row['column2']); ?></td>
                    <td><?php echo esc_html($row['column3']); ?></td>
                </tr>
            <?php endforeach; ?>
        </table>
        <?php
    } else {
        ?>
        <p>抱歉，没有找到匹配的结果。</p>
        <?php
    }

    return ob_get_clean();
}
add_shortcode('my_secure_shortcode', 'my_secure_shortcode_function');
?>

<?php
/**
 * 注册自定义短代码 'my_job_search'
 */
function register_my_job_search_shortcode() {
    add_shortcode('my_job_search', 'my_job_search_shortcode_callback');
}
add_action('init', 'register_my_job_search_shortcode');

/**
 * 自定义工作搜索短代码回调函数
 *
 * @return string 生成的HTML内容
 */
function my_job_search_shortcode_callback() {
    global $wpdb;
    ob_start(); // 开启输出缓冲

    // 定义表名，推荐使用 $wpdb->prefix
    $job_table_name = $wpdb->prefix . 'jobs'; // 假设你的表名为 wp_jobs

    // 获取并清理用户输入
    $filter = isset($_POST['filter']) ? sanitize_text_field($_POST['filter']) : '';

    // 引入搜索表单 HTML
    // 确保路径正确，并使用 require_once 以避免重复引入
    $form_path = WP_PLUGIN_DIR . '/your-plugin-directory/assets/runtime/shortcode/form.html';
    if (file_exists($form_path)) {
        require_once($form_path);
    } else {
        echo '<p>错误：搜索表单文件未找到。</p>';
        return ob_get_clean(); // 提前返回错误信息
    }

    // 如果没有筛选条件，或者表为空，则不执行查询，直接返回表单
    // 检查表是否有条目，但更推荐直接查询，如果结果为空则显示“无结果”
    // if ( $wpdb->get_var( "SELECT COUNT(*) FROM {$job_table_name}" ) == 0 && empty($filter) ) {
    //     // 表单已输出，直接返回
    //     return ob_get_clean();
    // }

    $results = [];
    if (!empty($filter)) {
        // 构建安全的SQL查询
        // 使用 $wpdb->prepare() 防止 SQL 注入
        // 对于 LIKE 中的 % 通配符，使用 %% 进行双重转义
        // 使用 $wpdb->esc_like() 转义用户输入中可能存在的 LIKE 特殊字符
        $query = $wpdb->prepare(
            "SELECT id, column1, column2, column3 FROM {$job_table_name} WHERE column1 LIKE %s OR id LIKE %s",
            '%' . $wpdb->esc_like($filter) . '%',
            '%' . $wpdb->esc_like($filter) . '%'
        );
        $results = $wpdb->get_results($query, ARRAY_A);
    }

    // 显示结果
    if (!empty($results)) {
        ?>
        <table>
            <thead>
                <tr>
                    <th>职位名称</th>
                    <th>地点</th>
                    <th>发布日期</th>
                </tr>
            </thead>
            <tbody>
                <?php foreach ($results as $result) : ?>
                    <tr>
                        <td>
                            <a href="<?php echo esc_url(site_url('/displayjobs?id=' . $result['id'])); ?>">
                                <?php echo esc_html($result['column1']); ?>
                            </a>
                        </td>
                        <td><?php echo esc_html($result['column2']); ?></td>
                        <td><?php echo esc_html($result['column3']); ?></td>
                    </tr>
                <?php endforeach; ?>
            </tbody>
        </table>
        <?php
    } elseif (!empty($filter)) {
        // 只有当有筛选条件但没有结果时才显示此消息
        ?>
        <p>抱歉，没有找到匹配您搜索条件的结果。</p>
        <?php
    }

    return ob_get_clean(); // 获取缓冲区内容并返回
}
?>

<form method="POST">
  <input type="text" name="filter" placeholder="输入职位关键词或ID..." />
  <input type="submit" value="搜索职位" />
</form>