wp_cache_get( int|string $key, string $group = '', bool $force = false, bool $found = null )

Retrieves the cache contents from the cache by key and group.


Description Description

See also See also


Top ↑

Parameters Parameters

$key

(int|string) (Required) The key under which the cache contents are stored.

$group

(string) (Optional) Where the cache contents are grouped.

Default value: ''

$force

(bool) (Optional) Whether to force an update of the local cache from the persistent cache.

Default value: false

$found

(bool) (Optional) Whether the key was found in the cache (passed by reference). Disambiguates a return of false, a storable value.

Default value: null


Top ↑

Return Return

(bool|mixed) False on failure to retrieve contents or the cache contents on success


Top ↑

Source Source

File: wp-includes/cache.php

function wp_cache_get( $key, $group = '', $force = false, &$found = null ) {
	global $wp_object_cache;

	return $wp_object_cache->get( $key, $group, $force, $found );
}


Top ↑

Changelog Changelog

Changelog
Version Description
2.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    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
    Contributed by Aamer Shahzad
    /**
     * Handles the users column output.
     *
     * @since 4.3.0
     *
     * @param array $blog Current site.
     */
    public function column_users( $blog ) {
        $user_count = wp_cache_get( $blog['blog_id'] . '_user_count', 'blog-details' );
        if ( ! $user_count ) {
            $blog_users = new WP_User_Query(
                array(
                    'blog_id'     => $blog['blog_id'],
                    'fields'      => 'ID',
                    'number'      => 1,
                    'count_total' => true,
                )
            );
            $user_count = $blog_users->get_total();
            wp_cache_set( $blog['blog_id'] . '_user_count', $user_count, 'blog-details', 12 * HOUR_IN_SECONDS );
        }
    
        printf(
            '<a href="%s">%s</a>',
            esc_url( network_admin_url( 'site-users.php?id=' . $blog['blog_id'] ) ),
            number_format_i18n( $user_count )
        );
    }
    

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