WP_Object_Cache::add( int|string $key, mixed $data, string $group = 'default', int $expire )
Adds data to the cache if it doesn’t already exist.
Parameters
- $key
-
(int|string) (Required) What to call the contents in the cache.
- $data
-
(mixed) (Required) The contents to store in the cache.
- $group
-
(string) (Optional) Where to group the cache contents.
Default value: 'default'
- $expire
-
(int) (Optional) When to expire the cache contents. Default 0 (no expiration).
Return
(bool) False if cache key and group already exist, true on success
Source
File: wp-includes/cache.php
public function add( $key, $data, $group = 'default', $expire = 0 ) {
if ( wp_suspend_cache_addition() )
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 );
}
Changelog
| Version | Description |
|---|---|
| WP-2.0.0 | Introduced. |