PHP 中 WordPress AJAX 请求间无法共享类属性的解决方案

wordpress 插件中通过 ajax 调用不同 php 方法时，类属性无法跨请求访问，根本原因是每次 ajax 请求都触发全新 php 实例——类属性仅在单次请求生命周期内有效，不会自动持久化。

在 WordPress 开发中，一个常见误区是认为 ->row3b 这样的类属性能在多个 AJAX 请求之间“保持状态”。但事实是：每个 AJAX 请求都会初始化一个全新的 PHP 执行环境。即使你使用了单例模式（GetInstance()），WordPress 的 AJAX 处理机制（admin-ajax.php）会为每次请求重新加载并实例化你的类——这意味着 getBTCData() 中设置的 $this->row3b = '2.45%' 在请求结束（die() 后）即被销毁；当后续 testFunc() 被调用时，它运行在一个完全独立的类实例中，$this->row3b 从未被赋值，自然为空。

✅ 正确方案：使用 WordPress 的 Transients API 持久化数据

Transients 是 WordPress 提供的轻量级、带过期时间的键值存储机制，专为跨请求共享临时数据设计，完美匹配你的场景：

Transor

专业的AI翻译工具，支持网页、字幕、PDF、图片实时翻译

下载

// 在 getBTCData() 中保存数据（替换原有逻辑）
public function getBTCData() {
    require __DIR__ . "/vendor/autoload.php";
    $client = new GuzzleHttp\Client();

    try {
        $response = $client->get('https://api.alternative.me/v1/ticker/bitcoin/');
        $data = json_decode($response->getBody(), true);

        if (isset($data[0]['price_usd'], $data[0]['percent_change_24h'])) {
            $btc_price = round((float) $data[0]['price_usd'], 2);
            $btc_change = round((float) $data[0]['percent_change_24h'], 2);

            // ✅ 使用 transient 存储，有效期设为 5 分钟（避免 API 频繁调用）
            set_transient('enigma_dmu_btc_change', $btc_change . '%', 5 * MINUTE_IN_SECONDS);

            echo 'BTC 24h change: ' . $btc_change . '%';
        } else {
            echo 'API response malformed';
        }
    } catch (Exception $e) {
        error_log('BTC API error: ' . $e->getMessage());
        echo 'Failed to fetch BTC data';
    }

    wp_die(); // 替代 die()，符合 WordPress 最佳实践
}

// 在 testFunc() 中读取数据（替换原有逻辑）
public function testFunc() {
    // ✅ 从 transient 安全读取，若不存在则返回默认值
    $btc_change = get_transient('enigma_dmu_btc_change');
    $btc_change = $btc_change ?: 'N/A';

    echo 'BTC 24h change: ' . $btc_change;

    wp_die();
}

⚠️ 关键注意事项

• 不要依赖类属性跨 AJAX 请求：$this->row3b 是实例属性，生命周期仅限于当前 HTTP 请求。
• 必须调用 wp_die()：WordPress AJAX 处理器要求每个处理函数以 wp_die() 或 exit 结束，否则可能输出额外空白或报错。
• 命名空间唯一性：Transient 键名（如 'enigma_dmu_btc_change'）需全局唯一，建议添加插件前缀。
• 错误处理不可少：网络请求（Guzzle）可能失败，务必包裹 try/catch 并记录错误（error_log）。
• 安全性补充：实际生产中，应在 getBTCData() 和 testFunc() 开头验证 nonce（check_ajax_referer()），防止未授权调用。

? 替代方案对比（不推荐但需了解）

通过 Transients，你既保持了代码的面向对象结构，又实现了数据在 AJAX 请求间的可靠传递——这才是 WordPress 生态下的标准解法。