WP_Object_Cache::set( int|string $key, mixed $data, string $group = 'default', int $expire )

Sets the data contents into the cache.

Description Description

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.

Top ↑

Parameters Parameters


(int|string) (Required) What to call the contents in the cache.


(mixed) (Required) The contents to store in the cache.


(string) (Optional) Where to group the cache contents.

Default value: 'default'


(int) (Optional) Not Used.

Top ↑

Return Return

(true) Always returns true.

Top ↑

Source Source

File: wp-includes/class-wp-object-cache.php

	public function set( $key, $data, $group = 'default', $expire = 0 ) {
		if ( empty( $group ) ) {
			$group = 'default';

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

		if ( is_object( $data ) ) {
			$data = clone $data;

		$this->cache[ $group ][ $key ] = $data;
		return true;

Top ↑

Changelog Changelog

Version Description
2.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

Top ↑

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