apcu_add
(PECL apcu >= 4.0.0)
apcu_add — Додати змінну до кешу
Опис
apcu_add(string $key, mixed $var, int $ttl = 0): bool
apcu_add(array $values, mixed $unused = NULL, int $ttl = 0): array
Додає змінну в кеш, якщо її ще немає.
Зауваження: На відміну від багатьох інших механізмів PHP, змінні, збережені apcu_add(), зберігаються між запитами, доки їх не видалять із кеша.
Список параметрів
key
Ім'я, під яким буде збережено змінну. Значення key є унікальним для кешу, так що спроба використати apcu_add() для збереження змінної з ключем, що вже існує, не перезапише запис, а поверне false. (Це єдина різниця між **apcu_add()**иapcu_store()
var
Змінна для збереження
ttl
Время жизни; переменнаяvar буде зберігатися протягом ttl секунд. Як тільки ttlсекунд пройдут, переменная будет удалена из кеша (при следующем запросе). Если параметрttlне задан (илиttlзадан как ), значення буде зберігатися доки не буде видалено явно, або з технічної причини (очищення кешу, перезапуск і т.д.)
values
Імена у ключах, змінні у значеннях.
Значення, що повертаються
Повертає true, якщо вдалося занести значення в кеш, інакше повертає false. Другий тип синтаксису повертає масив із ключами, за якими сталася помилка.
Приклади
Приклад #1 Приклад використання apcu_add()****
Результат виконання наведеного прикладу:
string(3) "BAR"
string(3) "BAR"
Дивіться також
- apcu_store() - Кешує змінну
- apcu_fetch() - Витягує з кеша збережену змінну
- apcu_delete() - Видаляє збережене значення з кешу