PHP Manual
Функции APC
Кешировать переменную в хранилище данных

apc_add

(PECL apc >= 3.0.13)

apc_add — Кешировать переменную в хранилище данных

Описание

apc_add ( string $key , mixed $var [, int $ttl = 0 ] ) : bool

apc_add ( array $values [, mixed $unused = NULL [, int $ttl = 0 ]] ) : array

Кеширует переменную в хранилище данных, только если она ещё не закеширована.

Замечание: В отличие от многих других механизмов в PHP, переменные, сохраненные с использованием apc_add(), будут сохранены между запросами (пока значение не будет удалено из кеша).

Список параметров

key: Сохраняет переменную, используя это имя. Ключи (key) уникальны для кеша, так, попытка использования apc_add() для сохранения данных с ключом, который уже существует, не перезапишет существующие данные, и вместо этого возвратит FALSE. (Это единственное различие между apc_add() и apc_store().)
var: Переменная для хранения
ttl: Время жизни; хранить var в кеше ttl секунд. После истечения ttl, сохраненная переменная будет удалена из кэша (при следующем запросе). Если никакого значения ttl не указано (или если ttl равно 0), то значение хранится, пока оно не будет удалено из кеша вручную, или не сможет существовать в кэше (очистка, перезапуск и т.д.).
values: Имена в ключах, переменные в значениях.

Возвращаемые значения

Возвращает TRUE в случае успешного добавления и FALSE в случае ошибки. Второй синтаксис возвращает массив с ошибочными ключами.

Примеры

Пример #1 Пример использования apc_add()


<?php
$bar = 'BAR';
apc_add('foo', $bar);
var_dump(apc_fetch('foo'));
echo "\n";
$bar = 'NEVER GETS SET';
apc_add('foo', $bar);
var_dump(apc_fetch('foo'));
echo "\n";
?>

Результат выполнения данного примера:

string(3) "BAR"
string(3) "BAR"

Смотрите также

apc_store() - Кешировать переменную в хранилище данных
apc_fetch() - Выбрать сохраненную переменную из кеша
apc_delete() - Удалить сохраненную переменную из кеша