Возвращает либо значение из кэша по указанному ключу, либо false
, если значения не существует или время действия кэша истекло.
get_transient( $transient )
Параметры функции get_transient()
- $transient
- Ключ. По длине должен быть 175 символов или меньше, так как WordPress добавляет ещё префиксы
_transient_
и_transient_timeout_
при сохранении их в таблицу опций в базе данных. Более длинные ключи будут фейлиться без каких-либо уведомлений или ошибок.
Пример
// получаем данные из транзитного кэша if ( false === ( $true_query = get_transient( 'true_query_cache' ) ) ) { $true_query = new WP_Query( 'параметры какого-то тяжёлого запроса' ); set_transient( 'true_query_cache', $true_query ); // сохраняем в транзит } // дальше делаем всё, как обычно
Значение из транзитного кэша нужно проверять оператором ===
, потому что вероятно, что 0 или пустые строки вы можете захотеть закэшировать иногда.
pre_transient_{$transient}
Позволяет перезаписать значение транзита ещё до его получения из кэша. Например давайте для ключа my-custom-cache
всегда возвращать привет
.
add_filter( 'pre_transient_my-custom-cache', function( $value, $key ){ return 'привет'; }, 25, 2 );
transient_{$transient}
Позволяет перезаписать или изменить значение транзита уже после получения его из кэша.
Обратите внимание, что если вы уже перезаписали его значение хуком pre_transient_{$transient}
, то этот хук выполняться не будет!
add_filter( 'transient_my-name', function( $value, $key ){ return 'Привет, ' . $value; }, 25, 2 );