wp cache

Добавляет, удаляет, извлекает и очищает кэш объектов WP.

По умолчанию объектный кэш WP сохраняется в памяти PHP пока страница генерируется, а в конце кэш очищается. Чтобы кэш сохранялся между запросами (генерациями) нужно устанавливать спец. плагин, например, Redis.

Подробнее об объектном кэше читайте в описании функций объектного кэша.

Список команд	Описание
wp cache get	Получает данные из кэша по указанным ключу и группе. Работает на основе функции wp_cache_get().
wp cache add	Добавляет данные в кэш, если кэша с указанным ключом еще нет. Работает на основе функции wp_cache_add().
wp cache set	Добавляет данные в кэш объектов. Перезапишет кэш, если он существует. Работает на основе функции wp_cache_set().
wp cache replace	Устанавливает/заменяет/обновляет данные указанного кэша, только если кэш уже существует, в противном случает ничего не делает. Работает на основе функции wp_cache_replace().
wp cache delete	Удаляет кэш по указанному ключу и группе. Работает на основе функции wp_cache_delete().
wp cache flush	Полностью очищает объектный кэш. Удаляет все элементы объектного кэша.
wp cache incr	Увеличивает числовое значение элемента кэша по указанным ключу и группе. Работает на основе функции wp_cache_decr().
wp cache decr	Уменьшает числовое значение элемента кэша по указанным ключу и группе. Работает на основе функции wp_cache_decr().
wp cache type	Пытается определить, какой тип кэша объектов используется.

Примеры

# Установить кеш.
$ wp cache set my_key my_value my_group 300
Success: Set object 'my_key' in group 'my_group'.

# Получить кеш.
$ wp cache get my_key my_group
my_value

Исходный код команд

wp-cli/cache-command
- Cache_Command.php

wp cache get

Получает данные из кэша по указанным ключу и группе. Работает на основе функции wp_cache_get().

Использование

wp cache get {key} [{group}]

{key}: Ключ кэша, который нужно удалить.
[{group}]: Название группы, в которой нужно искать указанный ключ.
По умолчанию: ''

Примеры

# Получим данные из кеша по ключу my_key из группы my_group.
$ wp cache get my_key my_group

# Варианты ответа
my_value
Error:  Object with key '$key' and group '$group' not found.

wp cache add

Добавляет данные в кэш, если кэша с указанным ключом еще нет. Работает на основе функции wp_cache_add().

Отличается от wp cache set только тем, что в wp cache add проверяется наличие кэша. Если кэша еще нет, то управление передается set, если есть, то команда ничего не делает.

Использование

wp cache add {key} {value} [{group}] [{expiration}]

{key}: Ключ кэша, используемый для обращения к кэшу в дальнейшем.
{value}: Данные, которые нужно добавить в кэш.
[{group}]: Название группы, к которой принадлежит кэш. Группа указывается для удобства, чтобы кэши в одинаковыми ключами можно было различать, по группе в которой он находится.
По умолчанию: 'default'
[{expiration}]: Время жизни кэша (в секундах). Не используется по умолчанию. Предназначен для плагинов объектного кэширования.
По умолчанию: 0

Пример

# Добавляем данные в кеш.
$ wp cache add my_key my_group my_value 300

# Варианты ответа
Success: Added object 'my_key' in group 'my_value'.
Error: Could not add object '$key' in group '$group'. Does it already exist?

wp cache set

Добавляет данные в кэш объектов. Перезапишет кэш, если он существует. Работает на основе функции wp_cache_set().

wp cache set записывает и перезаписывает кэш, в отличии от wp cache add, где только записывается кэш, если его еще нет.

Использование

wp cache set {key} {value} [{group}] [{expiration}]

{key}: Ключ кэша, используемый для получения кэша в дальнейшем.
{value}: Данные, которые нужно добавить в кэш.
[{group}]: Название группы, к которой принадлежит кэш. Группа указывается для удобства, чтобы кэши в одинаковыми ключами можно было различать, по группе в которой он находится.
По умолчанию: 'default'
[{expiration}]: Время жизни кэша (в секундах). Не используется по умолчанию. Предназначен для плагинов объектного кэширования.
По умолчанию: 0

Пример

# Добавляем данные в кеш.
$ wp cache set my_key my_value my_group 300

# Варианты ответа
Success: Set object 'my_key' in group 'my_group'.
Error: Could not add object '$key' in group '$group'

wp cache replace

Устанавливает/заменяет/обновляет данные указанного кэша, только если кэш уже существует, в противном случает ничего не делает. Работает на основе функции wp_cache_replace().

Использование

wp cache replace {key} {value} [{group}] [{expiration}]

{key}: Ключ кэша.
{value}: Данные, которые нужно разместить в указанный кэш.
[{group}]: Группа кэша, в которой искать указанный в key ключ.
По умолчанию: ''
[{expiration}]: Когда кэш будет считаться устаревшим. В WP не работает, а предназначен для плагинов кэширования.

Примеры

# Заменим кеш.
$ wp cache replace my_key new_value my_group

# Варианты ответа
Success: Replaced object 'my_key' in group 'my_group'.
Error: Could not replace object 'my_key' in group 'my_group'. Does it not exist?

wp cache delete

Удаляет кэш по указанному ключу и группе. Работает на основе функции wp_cache_delete().

Использование

wp cache delete {key} [{group}]

{key}: Ключ кэша, который нужно удалить.
[{group}]: Название группы, в которой нужно искать указанный ключ.
По умолчанию: ''

Примеры

# Удалим кеш с ключом my_key из группы my_group.
$ wp cache delete my_key my_group

# Варианты ответа
Success: Object deleted.
Error: The object was not deleted.

wp cache flush

Полностью очищает объектный кэш. Удаляет все элементы объектного кэша.

При использовании объектного кеша в режиме WordPress-мультисайт, его очистка приведет к очистке кэша для всех сайтов сети. Будьте осторожны, это действие может повлиять на производительность.

Использование

wp cache flush

Примеры

# Очистим весь объектный кеш.
$ wp cache flush

# Варианты ответа
Success: The cache was flushed.
Error: The object cache could not be flushed.

wp cache incr

Увеличивает числовое значение элемента кэша по указанным ключу и группе. Работает на основе функции wp_cache_decr().

Использование

wp cache incr {key} [{offset}] [{group}]

{key}: Ключ кэша, значение которого нужно увеличить.
[{offset}]: Число, на которое нужно увеличить текущее значение.
По умолчанию: 1
[{group}]: Название группы, в которой нужно искать указанный ключ.
По умолчанию: ''

Примеры

# Увеличим значение (пусть оно 48) кеша в группе my_group по ключом my_key на 2.
$ wp cache incr my_key 2 my_group

# Варианты ответа
50
Error: The value was not incremented.

wp cache decr

Уменьшает числовое значение элемента кэша по указанным ключу и группе. Работает на основе функции wp_cache_decr().

Использование

wp cache decr {key} [{offset}] [{group}]

{key}: Ключ кэша, значение которого нужно уменьшить.
[{offset}]: Число, на которое нужно увеличить текущее значение.
По умолчанию: 1
[{group}]: Название группы, в которой нужно искать указанный ключ.
По умолчанию: ''

Примеры

# Уменьшим значение (пусть оно 50) кеша в группе my_group по ключом my_key на 2.
$ wp cache decr my_key 2 my_group

# Варианты ответа
48
Error: The value was not decremented.

wp cache type

Пытается определить, какой тип кэша объектов используется.

Обратите внимание, что предположения, сделанные этой командой, основаны на классах WP_Object_Cache, которые определяют стороннее расширение кэша объектов. Изменения в этих классах могут вызвать проблемы со способностью этой команды определять, какой кэш объектов используется.

Использование

wp cache type

Примеры

# Проверим тип кеша.
$ wp cache type

# Варианты ответа
Default
Memcached   // https://github.com/tollmanz/wordpress-memcached-backend
Memcache    // http://wordpress.org/extend/plugins/memcached/
Xcache      // http://plugins.svn.wordpress.org/xcache/trunk/object-cache.php
WinCache    // http://wordpress.org/extend/plugins/wincache-object-cache-backend/
APC         // http://wordpress.org/extend/plugins/apc/
Redis       // https://github.com/alleyinteractive/wp-redis
WP LCache   // https://github.com/lcache/wp-lcache
Unknown
'W3TC ' . $config->get_string( 'objectcache.engine' )