Функция добавляет или обновляет уже существующее значение в транзитном кэше. Возвращает true
, если значение было сохранено, false
– если нет.
В случае, если транзит с указанным ключом уже существует, то будет обновлено его время жизни.
set_transient( $transient, $value, $expiration )
Параметры функции set_transient()
- $transient
- (строка) Ключ. По длине должен быть 172 символов или меньше, так как WordPress добавляет ещё префиксы
_transient_
или_transient_timeout_
при сохранении их в таблицу опций в базе данных. Более длинные ключи будут фейлиться без каких-либо уведомлений или ошибок. - $value
- (строка) Значение, которое нужно поместить в кэш. Можете не беспокоиться о сериализации и об SQL-очистке, функция об этом позаботится сама.
- $expiration
- (целое число) Время жизни кэша в секундах. Можно использовать константы времени WordPress. Если ничего не указать, то время действия кэша будет неограниченным (0).
Пример
Например вы можете сохранить в кэш что-либо на 12 часов вот так:
set_transient( 'true_cache_key', $true_results, 60 * 60 * 12 );
Или же вот так при помощи константы времени:
set_transient( 'true_cache_key', $true_results, 12 * HOUR_IN_SECONDS );