apcu_add
(PECL apcu >= 4.0.0)
apcu_add — Добавить переменную в кеш
Описание
Добавляет переменную в кеш, если ее там еще нет.
Замечание: В отличие от многих других механизмов PHP, переменные, сохраненные apcu_add(), сохраняются между запросами, пока их не удалят из кеша.
Список параметров
-
key
-
Имя, под которым будет сохранена переменная. Значение
key
является уникальным для кеша, так что попытка использовать apcu_add() для сохранения переменной с ключем, который уже существует, не перезапишет запись, а вернетFALSE
. (Это единственное различие между apcu_add() и apcu_store().) -
var
-
Переменная для сохранения
-
ttl
-
Время жизни; переменная
var
будет храниться в теченииttl
секунд. Как толькоttl
секунд пройдут, переменная будет удалена из кеша (при следующем запросе). Если параметрttl
не задан (илиttl
задан как 0), значение будет храниться пока не будет удалено явно, либо по технической причине (очистка кеша, перезапуск и т.д.) -
values
-
Имена в ключах, переменные в значениях.
Возвращаемые значения
Возвращает TRUE
если удалось занести значение в кеш и FALSE
в обратном случае.
Второй тип синтаксиса возвращает массив с ключами, по которым произошла ошибка.
Примеры
Пример #1 Пример использования apcu_add()
<?php
$bar = 'BAR';
apcu_add('foo', $bar);
var_dump(apcu_fetch('foo'));
echo "\n";
$bar = 'NEVER GETS SET';
apcu_add('foo', $bar);
var_dump(apcu_fetch('foo'));
echo "\n";
?>
Результат выполнения данного примера:
string(3) "BAR" string(3) "BAR"
Смотрите также
- apcu_store() - Кеширует переменную
- apcu_fetch() - Извлекает из кеша сохраненную переменную
- apcu_delete() - Удаляет сохраненное значение из кеша