WP_Object_Cache::replace() │ public │ WP 2.0.0

Replaces the contents in the cache, if contents already exist.

Method of the class: WP_Object_Cache{}

No Hooks.

Return

true|false. True if contents were replaced, false if original value does not exist.

Usage

$WP_Object_Cache = new WP_Object_Cache();
$WP_Object_Cache->replace( $key, $data, $group, $expire );

$key(int|string) (required)

What to call the contents in the cache.

$data(mixed) (required)

The contents to store in the cache.

$group(string)

Where to group the cache contents.
Default: 'default'

$expire(int)

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

Notes

• See: WP_Object_Cache::set()

Changelog

WP_Object_Cache::replace() WP Object Cache::replace code ^{WP 6.5.2}

public function replace( $key, $data, $group = 'default', $expire = 0 ) {
	if ( ! $this->is_valid_key( $key ) ) {
		return false;
	}

	if ( empty( $group ) ) {
		$group = 'default';
	}

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

	if ( ! $this->_exists( $id, $group ) ) {
		return false;
	}

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