W3cubDocs

/WordPress

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

Adds data to the cache, if the cache key doesn’t already exist.

Description

See also

Parameters

$keyint|stringrequired
The cache key to use for retrieval later.
$datamixedrequired
The data to add to the cache.
$groupstringoptional
The group to add the cache to. Enables the same key to be used across groups.

Default:''

$expireintoptional
When the cache data should expire, in seconds.
Default 0 (no expiration).

Return

bool True on success, false if cache key and group already exist.

Source

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

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

Changelog

Version Description
2.0.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_cache_add