更新Widget值时如何重置Transient？Instagram组件缓存问题

Got it, let's tackle this transient cache issue with your Instagram widget. The core problem here is that your current setup isn't tying cached data to the specific username from the Customizer—so when you update the username, the old cached content (linked to the previous username) keeps loading. Here's how to implement the conditional logic you're thinking of, plus extra safeguards to keep things working smoothly:

1. Create a Username-Specific Cache Key #

First, stop using a generic transient key like instagram_widget_data. Instead, generate a unique key that includes the sanitized username. This ensures each username has its own separate cache entry, so changing usernames won't pull stale data.

2. Implement the Conditional Cache Check #

Every time your widget loads, fetch the current username from the Customizer, then check if a valid transient exists for that username. If not (or if the cache has expired), scrape fresh data and save it to the transient.

Here's a code example you can drop into your widget's render method:

// Get the current username from Customizer settings
$current_username = get_theme_mod('instagram_widget_username', '');
$sanitized_username = sanitize_text_field($current_username);

// Create a unique transient key tied to the username
$transient_key = 'instagram_widget_data_' . $sanitized_username;

// Check if we have valid cached data
$instagram_media = get_transient($transient_key);

// If no cache exists (or it's expired), fetch fresh data
if (false === $instagram_media) {
    // Initialize your instagram-scrapper instance
    $scrapper = new \InstagramScraper\Instagram(); // Adjust to your actual scrapper class
    try {
        $instagram_media = $scrapper->getMedias($sanitized_username, 10); // Fetch 10 posts
        // Save to transient with 1-hour expiration (adjust as needed)
        set_transient($transient_key, $instagram_media, 3600);
    } catch (\Exception $e) {
        $instagram_media = [];
        error_log('Instagram Scraper Error: ' . $e->getMessage());
    }
}

// Render the images
if (!empty($instagram_media)) {
    echo '<div class="instagram-widget">';
    foreach ($instagram_media as $post) {
        echo '<a href="' . esc_url($post->getLink()) . '" target="_blank">';
        echo '<img src="' . esc_url($post->getImageHighResolutionUrl()) . '" alt="Instagram post from ' . esc_attr($sanitized_username) . '" />';
        echo '</a>';
    }
    echo '</div>';
} else {
    echo '<p class="instagram-widget-error">No posts found for username: ' . esc_html($sanitized_username) . '</p>';
}

3. Optional: Clear Stale Cache When Username Updates #

To make the cache switch instant (instead of waiting for the old cache to expire), add a hook that clears the old username's transient when the Customizer setting is saved:

add_action('customize_save_after', 'clear_old_instagram_transient');
function clear_old_instagram_transient() {
    // Get the old and new username values
    $old_username = get_theme_mod('instagram_widget_username');
    $new_username = sanitize_text_field($_POST['customized']['instagram_widget_username'] ?? '');

    // If usernames differ, delete the old transient
    if ($old_username !== $new_username && !empty($old_username)) {
        $old_transient_key = 'instagram_widget_data_' . sanitize_text_field($old_username);
        delete_transient($old_transient_key);
    }
}

This setup ensures that:

• Each username has its own isolated cache
• Fresh data is fetched immediately when the username changes (either via the hook or when the old cache expires)
• Your widget will always display content for the currently set username

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