wp_suspend_cache_addition() WP 3.3.0

Временно приостанавливает добавление объектов в объектный кэш.

Функция позволяет остановить работу объектного кэширования, которое используется в WordPress повсеместно. Но при этом уже имеющиеся данные в кэше не удаляются и их можно получить как обычно.

Может быть полезна при импорте больших массивов данных, чтобы не забивать память при обработке одноразового скрипта.

Остановка кэша работает только для текущего запроса (на время текущей генерации страницы).

Хуков нет.

Возвращает

true|false. Текущий статус остановки кэширования.

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

wp_suspend_cache_addition( $suspend );

$suspend(true/false)

• true — остановит добавление объектов в кэш.
• false — включит кэширование.

По умолчанию: null

Примеры

#1 Демонстрация отключения и включения объектного кэширования

wp_suspend_cache_addition( true ); // отключаем кэширование

// делаем что нибудь

wp_suspend_cache_addition( false ); // включаем кэширование

#2 Временная остановка объектного кэширования

Рассмотрим случай, когда остановка объектного кэширование решает проблему переполнения памяти, а такое при импорте данных в WP встречается очень часто.

Допустим, мы импортируем большой массив данных в WordPress. К примеру, нам нужно заполнить таблицу записей из другой базы данных, или CSV файла, или по API. Для этого у нас есть код, в котором мы используем функцию добавления записей wp_insert_post() или wp_update_post(). Эти функции после добавления записи в БД, добавляет данные в кэш, чтобы потом получить их без дополнительного запроса. Но нам не нужно кэширование при импорте, потому что по умолчанию кэш записывается в оперативную память и в результате импорта её может не хватить.

Поэтому, чтобы импорт работал как нужно, нужно выключить кэш до импорта и включим его после:

// запомним текущее состояние (это пример, что так тоже можно делать)
$was_suspended = wp_suspend_cache_addition();

// отключаем кэширование
wp_suspend_cache_addition( true );

// ТУТ ВАШ КОД ИМПОРТА. Объектное кэширование здесь уже не работает

// вернем прежнее состояние кэша обратно
wp_suspend_cache_addition( $was_suspended );

Ссылки по теме:

• Комментарий к wpdb 1
• Комментарий к wpdb 2
• 500 000 записей
• Очень много данных: удаление всех постов
• Утечка памяти или проблемы с wp_insert_post()

Список изменений

Код wp_suspend_cache_addition() wp suspend cache addition ^{WP 5.8.3}

function wp_suspend_cache_addition( $suspend = null ) {
	static $_suspend = false;

	if ( is_bool( $suspend ) ) {
		$_suspend = $suspend;
	}

	return $_suspend;
}

Cвязанные функции

cache (кэш кеш)