(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"