WordPress插件开发：PHP回调中存储动态数据，规避全局变量

针对你需要在多次Ajax调用中复用JSON数组且不使用全局变量的需求，推荐以下几种符合WordPress最佳实践的方案：

方案一：使用WordPress Transient API（推荐） #

Transient是WordPress原生的临时缓存机制，数据会自动过期清理，适合存储跨请求的临时数据，不会污染全局空间。

实现步骤 #

1. 注册Ajax回调与安全验证
   先绑定Ajax动作，并添加nonce验证（必须，防止CSRF攻击）：

   add_action('wp_ajax_get_my_data', 'my_plugin_handle_ajax_data');
   add_action('wp_ajax_nopriv_get_my_data', 'my_plugin_handle_ajax_data'); // 允许未登录用户访问（可选）
   
   function my_plugin_handle_ajax_data() {
       // 验证nonce合法性
       check_ajax_referer('my_plugin_data_nonce', 'nonce');
       $filename = plugin_dir_path(__FILE__) . 'data.json'; // 你的JSON文件路径
   

2. 首次调用：读取JSON并缓存
   当首次请求时，读取JSON文件并将数组存入transient：

   $action_type = isset($_POST['action_type']) ? sanitize_text_field($_POST['action_type']) : '';
   
       switch ($action_type) {
           case 'initial':
               if (file_exists($filename)) {
                   $my_array = json_decode(file_get_contents($filename), true);
                   if (is_array($my_array)) {
                       // 缓存数据1小时，可根据需求调整过期时间
                       set_transient('my_plugin_data_array', $my_array, HOUR_IN_SECONDS);
                       wp_send_json_success($my_array);
                   } else {
                       wp_send_json_error('JSON数据格式无效');
                   }
               } else {
                   wp_send_json_error('JSON文件不存在');
               }
               break;
   

3. 后续调用：从缓存读取并返回子数组
   第二次、第三次请求时，直接从transient读取缓存的数组，再根据请求的key返回子数组：

   case 'sub_array':
               // 从缓存获取数组，若缓存过期则重新读取
               $my_array = get_transient('my_plugin_data_array');
               if (!is_array($my_array)) {
                   if (file_exists($filename)) {
                       $my_array = json_decode(file_get_contents($filename), true);
                       set_transient('my_plugin_data_array', $my_array, HOUR_IN_SECONDS);
                   } else {
                       wp_send_json_error('数据不可用');
                   }
               }
   
               $request_key = isset($_POST['request_key']) ? sanitize_text_field($_POST['request_key']) : '';
               if (isset($my_array[$request_key])) {
                   wp_send_json_success($my_array[$request_key]);
               } else {
                   wp_send_json_error('无效的请求key');
               }
               break;
           default:
               wp_send_json_error('无效的请求类型');
               break;
       }
   
       wp_die(); // 必须终止Ajax请求
   }
   

4. 前端Ajax调用示例
   配合前端代码区分请求类型，传递nonce确保安全：

   // 首次请求获取完整数组
   jQuery.ajax({
       url: ajaxurl,
       type: 'POST',
       data: {
           action: 'get_my_data',
           nonce: myPluginData.nonce,
           action_type: 'initial'
       },
       success: function(res) {
           if (res.success) {
               console.log('初始数据:', res.data);
               // 调用第二次请求
               getSubArray('some key');
           } else {
               console.error('错误:', res.data);
           }
       }
   });
   
   // 获取子数组的通用函数
   function getSubArray(key) {
       jQuery.ajax({
           url: ajaxurl,
           type: 'POST',
           data: {
               action: 'get_my_data',
               nonce: myPluginData.nonce,
               action_type: 'sub_array',
               request_key: key
           },
           success: function(res) {
               if (res.success) {
                   console.log('子数组:', res.data);
               } else {
                   console.error('错误:', res.data);
               }
           }
       });
   }
   

5. 传递nonce与Ajax地址
   通过WordPress的localize脚本功能，将nonce和ajaxurl传递到前端：

   add_action('wp_enqueue_scripts', 'my_plugin_enqueue_scripts');
   function my_plugin_enqueue_scripts() {
       wp_enqueue_script('my-plugin-script', plugin_dir_url(__FILE__) . 'script.js', ['jquery'], '1.0', true);
       wp_localize_script('my-plugin-script', 'myPluginData', [
           'nonce' => wp_create_nonce('my_plugin_data_nonce'),
           'ajaxurl' => admin_url('admin-ajax.php')
       ]);
   }
   

方案二：使用Session（用户特定场景） #

如果数据是用户专属的，可使用PHP Session存储，但需手动开启WordPress的Session支持：

1. 开启Session

   add_action('init', 'my_plugin_start_session');
   function my_plugin_start_session() {
       if (!session_id()) {
           session_start();
       }
   }
   

2. 存储与读取数据
   首次调用时将数组存入$_SESSION，后续调用直接读取：

   // 首次调用
   $_SESSION['my_plugin_array'] = $my_array;
   
   // 后续调用
   $my_array = $_SESSION['my_plugin_array'];
   

关键注意事项 #

• 安全优先：必须添加nonce验证和参数 sanitize 处理，防止恶意请求。
• 缓存失效处理：若JSON文件更新，需手动删除transient（delete_transient('my_plugin_data_array')），确保用户获取最新数据。
• 避免全局变量的原因：全局变量易引发命名冲突，降低代码可维护性，在多插件共存的WordPress环境中风险极高。

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