Функция apcu-add

apcu_add

(PECL apcu >= 4.0.0)

apcu_add Добавить переменную в кеш

Описание функции

bool apcu_add ( string $key , mixed $var [, int $ttl = 0 ] )
array apcu_add ( array $values [, mixed $unused = NULL [, int $ttl = 0 ]] )

Добавляет переменную в кеш, если ее там еще нет.

Замечание: В отличие от многих других механизмов 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"


Возврат к списку