W3cubDocs

/WordPress

WP_Object_Cache::get( int|string $key, string $group = 'default', bool $force = false, bool $found = null )

Retrieves the cache contents, if it exists.

Description

The contents will be first attempted to be retrieved by searching by the key in the cache group. If the cache is hit (success) then the contents are returned.

On failure, the number of cache misses will be incremented.

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: 'default'

$force

(bool) (Optional) Unused. 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

Return

(mixed|false) The cache contents on success, false on failure to retrieve contents.

Source

File: wp-includes/class-wp-object-cache.php

public function get( $key, $group = 'default', $force = false, &$found = null ) {
		if ( empty( $group ) ) {
			$group = 'default';
		}

		if ( $this->multisite && ! isset( $this->global_groups[ $group ] ) ) {
			$key = $this->blog_prefix . $key;
		}

		if ( $this->_exists( $key, $group ) ) {
			$found             = true;
			$this->cache_hits += 1;
			if ( is_object( $this->cache[ $group ][ $key ] ) ) {
				return clone $this->cache[ $group ][ $key ];
			} else {
				return $this->cache[ $group ][ $key ];
			}
		}

		$found               = false;
		$this->cache_misses += 1;
		return false;
	}

Changelog

Version Description
2.0.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_object_cache/get