W3cubDocs

/WordPress

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

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

Description

See also

Parameters

$key

(int|string) (Required) The cache key to use for retrieval later.

$data

(mixed) (Required) The data to add to the cache.

$group

(string) (Optional) The group to add the cache to. Enables the same key to be used across groups.

Default value: ''

$expire

(int) (Optional) 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

File: wp-includes/cache.php

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–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_cache_add