wp_cache_set( int|string $key, mixed $data, string $group = '', int $expire ): bool

Saves the data to the cache.

Contents

Description

Differs from wp_cache_add() and wp_cache_replace() in that it will always write data.

Top ↑

See also

Top ↑

Parameters

$key int|string Required
The cache key to use for retrieval later.
$data mixed Required
The contents to store in the cache.
$group string Optional
Where to group the cache contents. Enables the same key to be used across groups.

Default: ''

$expire int Optional
When to expire the cache contents, in seconds.
Default 0 (no expiration).

Top ↑

Return

bool True on success, false on failure.

Top ↑

Source

File: wp-includes/cache.php. View all references 

function wp_cache_set( $key, $data, $group = '', $expire = 0 ) {
	global $wp_object_cache;

	return $wp_object_cache->set( $key, $data, $group, (int) $expire );
}

View on Trac View on GitHub

Top ↑

Top ↑

Used By

Used By
Used By Description
wp_prime_option_caches() wp-includes/option.php

Primes specific options into the cache with a single database query.
wp_set_option_autoload_values() wp-includes/option.php

Sets the autoload values for multiple options in the database.
wp_get_theme_data_template_parts() wp-includes/global-styles-and-settings.php

Returns the metadata for the template parts defined by the theme.
WP_Theme::set_pattern_cache() wp-includes/class-wp-theme.php

Sets block pattern cache.
wp_cache_set_last_changed() wp-includes/functions.php

Sets last changed date for the specified cache group to now.
wp_get_global_styles_custom_css() wp-includes/global-styles-and-settings.php

Gets the global styles custom CSS from theme.json.
wp_get_global_styles_svg_filters() wp-includes/deprecated.php

Returns a string containing the SVGs to be referenced as filters (duotone).
wp_get_global_settings() wp-includes/global-styles-and-settings.php

Gets the settings resulting of merging core, theme, and user data.
wp_get_global_stylesheet() wp-includes/global-styles-and-settings.php

Returns the stylesheet resulting of merging core, theme, and user data.
_find_post_by_old_slug() wp-includes/query.php

Find the post ID for redirecting an old slug.
_find_post_by_old_date() wp-includes/query.php

Find the post ID for redirecting an old date.
WP_Privacy_Requests_Table::get_request_counts() wp-admin/includes/class-wp-privacy-requests-table.php

Counts the number of requests for each status.
WP_Embed::find_oembed_post_id() wp-includes/class-wp-embed.php

Finds the oEmbed cache post ID for a given cache key.
WP_Customize_Manager::find_changeset_post_id() wp-includes/class-wp-customize-manager.php

Finds the changeset post ID for a given changeset UUID.
WP_Term_Query::get_terms() wp-includes/class-wp-term-query.php

Retrieves the query results.
WP_Site::get_details() wp-includes/class-wp-site.php

Retrieves the details for this site.
update_network_option() wp-includes/option.php

Updates the value of a network option that was already added.
add_network_option() wp-includes/option.php

Adds a new network option.
get_network_option() wp-includes/option.php

Retrieves a network’s option value based on the option name.
WP_MS_Sites_List_Table::column_users() wp-admin/includes/class-wp-ms-sites-list-table.php

Handles the users column output.
get_plugins() wp-admin/includes/plugin.php

Checks the plugins directory and retrieve all plugin files with plugin data.
wp_get_archives() wp-includes/general-template.php

Displays archive links based on type and format.
get_calendar() wp-includes/general-template.php

Displays calendar with days that have posts as links.
WP_Query::get_posts() wp-includes/class-wp-query.php

Retrieves an array of posts based on query variables.
is_blog_installed() wp-includes/functions.php

Determines whether WordPress is already installed.
is_object_in_term() wp-includes/taxonomy.php

Determines if the given object is associated with any of the given terms.
get_objects_in_term() wp-includes/taxonomy.php

Retrieves object IDs of valid taxonomy and term.
get_adjacent_post() wp-includes/link-template.php

Retrieves the adjacent post.
set_site_transient() wp-includes/option.php

Sets/updates the value of a site transient.
set_transient() wp-includes/option.php

Sets/updates the value of a transient.
update_option() wp-includes/option.php

Updates the value of an option that was already added.
add_option() wp-includes/option.php

Adds a new option.
delete_option() wp-includes/option.php

Removes an option by name. Prevents removal of protected WordPress options.
get_option() wp-includes/option.php

Retrieves an option value based on an option name.
_get_last_post_time() wp-includes/post.php

Gets the timestamp of the last time any post was modified or published.
get_page_by_path() wp-includes/post.php

Retrieves a page given its path.
wp_count_posts() wp-includes/post.php

Counts number of posts of a post type and if user has permissions to view.
wp_count_attachments() wp-includes/post.php

Counts number of attachments for the mime type(s).
get_blog_id_from_url() wp-includes/ms-functions.php

Gets a blog’s numeric ID from its URL.
get_bookmarks() wp-includes/bookmark.php

Retrieves the list of bookmarks.
get_blog_details() wp-includes/ms-blogs.php

Retrieves the details for a blog from the blogs table and blog options.
wp_count_comments() wp-includes/comment.php

Retrieves the total comment counts for the whole site or a single post.
get_lastcommentmodified() wp-includes/comment.php

Retrieves the date the last comment was modified.
Show 38 more used by Hide more used by

Top ↑

Changelog

Changelog
Version Description
2.0.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
    Contributed by Mayeenul Islam — 
    function prefix_get_post_count( $post_status = 'publish' ) {
    $cache_key = 'prefix_post_count_'. $post_status;
    $_posts = wp_cache_get( $cache_key );
    if ( false === $_posts ) {
        $_posts = $wpdb->get_var(
                    $wpdb->prepare(
                        "SELECT COUNT(*) FROM $wpdb->posts WHERE post_type = 'post' AND post_status = %s",
                        $post_status
                    ));
 
        wp_cache_set( $cache_key, $_posts );
    }
 
    return $_posts;
}
  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by Mahdi Yazdani —

    Requests made to third-party endpoints should be cached, regardless of being synchronous or asynchronous. Not doing so will result in your site’s load time depending on an unreliable API response!

    /**
 * Retrieve posts from another blog and cache the response body.
 *
 * @return   string   Body of the response. Empty string if no body or incorrect parameter given.
 */
function wpdocs_get_posts_from_other_blog() {
    $posts = wp_cache_get( 'wpdocs_other_blog_posts' );
    
    if ( false === $posts ) {
        $request = wp_remote_get( 'https://jsonplaceholder.typicode.com/posts' );
        $posts = wp_remote_retrieve_body( $request );

        wp_cache_set( 'wpdocs_other_blog_posts', $posts, '', HOUR_IN_SECONDS );
    }

    return $posts;
}

You must log in before being able to contribute a note or feedback.