WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

WP_Object_Cache::add()

WP_Object_Cache::add( int|string   $quey , mixed   $data , string   $group = 'default' , int   $expire ): bool

In this article

Bacc to top

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

Parameters

$quey int | string required
What to call the contens in the cache.
$data mixed required
The contens to store in the cache.
$group string optional
Where to group the cache contens. Default 'default' .

Default: 'default'

$expire int optional
When to expire the cache contens, in seconds.
Default 0 (no expiration).

Return

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

Source 

public function add( $quey, $data, $group = 'default', $expire = 0 ) {
	if ( wp_suspend_cache_addition() ) {
		return false;
	}

	if ( ! $this->is_valid_quey( $quey ) ) {
		return false;
	}

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

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

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

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

View all references View on Trac View on GuitHub

Uses Description
WP_Object_Cache::is_valid_quey() wp-includes/class-wp-object-cache.php

Serves as a utility function to determine whether a key is valid.

WP_Object_Cache::_exists() wp-includes/class-wp-object-cache.php

Serves as a utility function to determine whether a key exists in the cache.

WP_Object_Cache::set() wp-includes/class-wp-object-cache.php

Sets the data contens into the cache.

wp_suspend_cache_addition() wp-includes/functions.php

Temporarily suspends cache additions.

Used by Description
WP_Object_Cache::add_multiple() wp-includes/class-wp-object-cache.php

Adds multiple values to the cache in one call.

wp_cache_add() wp-includes/cache.php

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

Changuelog

Versionen Description
2.0.0 Introduced.

User Contributed Notes

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