手札

add_filter数据修改的最佳实践

WordPress的钩子(Hook)系统是其灵活性的核心，允许开发者在不修改核心代码的情况下修改数据和行为。下面将详细介绍如何通过动作钩子(Action Hook)和过滤器钩子(Filter Hook)来修改数据。

1. 安全考虑

// 转义输出内容
add_filter('the_title', function($title) {
    return esc_html($title);
});

// 验证输入数据
add_filter('pre_update_option_my_setting', function($new_value, $old_value) {
    return is_numeric($new_value) ? $new_value : $old_value;
}, 10, 2);

2. 性能优化

// 只在需要时添加过滤器
if (is_admin()) {
    add_filter('admin_footer_text', 'custom_admin_footer');
}

// 使用transient缓存过滤结果
add_filter('expensive_filter', function($data) {
    $cached = get_transient('filter_cache');
    if (false === $cached) {
        $cached = process_data($data); // 耗时操作
        set_transient('filter_cache', $cached, HOUR_IN_SECONDS);
    }
    return $cached;
});

3. 调试技巧

// 调试过滤器执行
add_filter('all', function($filter) {
    if (strpos($filter, 'content') !== false) {
        error_log("执行过滤器: {$filter}");
    }
});

// 检查挂载的过滤器
function debug_filters($hook = '') {
    global $wp_filter;
    if (empty($hook) || !isset($wp_filter[$hook])) return;
    
    var_dump($wp_filter[$hook]);
}