[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-includes/ -> class-wp-object-cache.php (summary)

Object Cache API: WP_Object_Cache class

File Size: 475 lines (13 kb)
Included or required: 1 time
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

WP_Object_Cache:: (18 methods):
  __construct()
  __get()
  __set()
  __isset()
  __unset()
  add()
  add_global_groups()
  decr()
  delete()
  flush()
  get()
  incr()
  replace()
  reset()
  set()
  stats()
  switch_to_blog()
  _exists()


Class: WP_Object_Cache  - X-Ref

Core class that implements an object cache.

The WordPress Object Cache is used to save on trips to the database. The
Object Cache stores all of the cache data to memory and makes the cache
contents available by using a key, which is used to name and later retrieve
the cache contents.

The Object Cache can be replaced by other caching mechanisms by placing files
in the wp-content folder which is looked at in wp-settings. If that file
exists, then this file will not be included.

__construct()   X-Ref
Sets up object properties; PHP 5 style constructor.


__get( $name )   X-Ref
Makes private properties readable for backward compatibility.

param: string $name Property to get.
return: mixed Property.

__set( $name, $value )   X-Ref
Makes private properties settable for backward compatibility.

param: string $name  Property to set.
param: mixed  $value Property value.
return: mixed Newly-set property.

__isset( $name )   X-Ref
Makes private properties checkable for backward compatibility.

param: string $name Property to check if set.
return: bool Whether the property is set.

__unset( $name )   X-Ref
Makes private properties un-settable for backward compatibility.

param: string $name Property to unset.

add( $key, $data, $group = 'default', $expire = 0 )   X-Ref
Adds data to the cache if it doesn't already exist.

param: int|string $key    What to call the contents in the cache.
param: mixed      $data   The contents to store in the cache.
param: string     $group  Optional. Where to group the cache contents. Default 'default'.
param: int        $expire Optional. When to expire the cache contents. Default 0 (no expiration).
return: bool True on success, false if cache key and group already exist.

add_global_groups( $groups )   X-Ref
Sets the list of global cache groups.

param: array $groups List of groups that are global.

decr( $key, $offset = 1, $group = 'default' )   X-Ref
Decrements numeric cache item's value.

param: int|string $key    The cache key to decrement.
param: int        $offset Optional. The amount by which to decrement the item's value. Default 1.
param: string     $group  Optional. The group the key is in. Default 'default'.
return: int|false The item's new value on success, false on failure.

delete( $key, $group = 'default', $deprecated = false )   X-Ref
Removes the contents of the cache key in the group.

If the cache key does not exist in the group, then nothing will happen.

param: int|string $key        What the contents in the cache are called.
param: string     $group      Optional. Where the cache contents are grouped. Default 'default'.
param: bool       $deprecated Optional. Unused. Default false.
return: bool False if the contents weren't deleted and true on success.

flush()   X-Ref
Clears the object cache of all data.

return: true Always returns true.

get( $key, $group = 'default', $force = false, &$found = null )   X-Ref
Retrieves the cache contents, if it exists.

The contents will be first attempted to be retrieved by searching by the
key in the cache group. If the cache is hit (success) then the contents
are returned.

On failure, the number of cache misses will be incremented.

param: int|string $key    What the contents in the cache are called.
param: string     $group  Optional. Where the cache contents are grouped. Default 'default'.
param: bool       $force  Optional. Unused. Whether to force a refetch rather than relying on the local
param: bool       $found  Optional. Whether the key was found in the cache (passed by reference).
return: mixed|false The cache contents on success, false on failure to retrieve contents.

incr( $key, $offset = 1, $group = 'default' )   X-Ref
Increments numeric cache item's value.

param: int|string $key    The cache key to increment
param: int        $offset Optional. The amount by which to increment the item's value. Default 1.
param: string     $group  Optional. The group the key is in. Default 'default'.
return: int|false The item's new value on success, false on failure.

replace( $key, $data, $group = 'default', $expire = 0 )   X-Ref
Replaces the contents in the cache, if contents already exist.

param: int|string $key    What to call the contents in the cache.
param: mixed      $data   The contents to store in the cache.
param: string     $group  Optional. Where to group the cache contents. Default 'default'.
param: int        $expire Optional. When to expire the cache contents. Default 0 (no expiration).
return: bool False if not exists, true if contents were replaced.

reset()   X-Ref
Resets cache keys.


set( $key, $data, $group = 'default', $expire = 0 )   X-Ref
Sets the data contents into the cache.

The cache contents are grouped by the $group parameter followed by the
$key. This allows for duplicate ids in unique groups. Therefore, naming of
the group should be used with care and should follow normal function
naming guidelines outside of core WordPress usage.

The $expire parameter is not used, because the cache will automatically
expire for each time a page is accessed and PHP finishes. The method is
more for cache plugins which use files.

param: int|string $key    What to call the contents in the cache.
param: mixed      $data   The contents to store in the cache.
param: string     $group  Optional. Where to group the cache contents. Default 'default'.
param: int        $expire Not Used.
return: true Always returns true.

stats()   X-Ref
Echoes the stats of the caching.

Gives the cache hits, and cache misses. Also prints every cached group,
key and the data.


switch_to_blog( $blog_id )   X-Ref
Switches the internal blog ID.

This changes the blog ID used to create keys in blog specific groups.

param: int $blog_id Blog ID.

_exists( $key, $group )   X-Ref
Serves as a utility function to determine whether a key exists in the cache.

param: int|string $key   Cache key to check for existence.
param: string     $group Cache group for the key existence check.
return: bool Whether the key exists in the cache for the given group.



Generated : Tue Dec 24 08:20:01 2024 Cross-referenced by PHPXref