wincache_ucache_add

(PECL wincache >= 1.1.0)

wincache_ucache_add — Додає змінну в кеш користувача, тільки якщо змінна ще не існує в кеші

Опис

wincache_ucache_add(string $key, mixed $value, int $ttl = 0): bool

wincache_ucache_add(array $values, mixed $unused = NULL, int $ttl = 0): bool

Додає змінну в кеш користувача, тільки якщо ця змінна ще не існує в кеші. Додана змінна залишається в кеші користувача, поки не закінчиться термін її дії або вона не буде видалена за допомогою функцій wincache_ucache_delete() або wincache_ucache_clear()

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

key

Зберігає змінну з використанням цього імені keyЕсли переменная с таким жеkey вже існує, завершиться помилкою та поверне false. . key чутливий до регістру. Щоб перевизначити значення, навіть якщо key вже існує, використовуйте функцію wincache_ucache_set(). . key також може приймати масив пар ім'я => значення, де імена будуть використовуватися як ключі. Це можна використовувати для додавання кількох значень до кешу за одну операцію, що дозволяє уникнути стану гонки.

value

Значення змінної, яку потрібно зберегти . Value підтримує всі типи даних, крім таких ресурсів, як дескриптори файлів. Параметр ігнорується, якщо першим аргументом масив. Загальне керівництво – передати null в якості valueпри использовании массиваkey. Якщо value є об'єктом або масивом, що містить об'єкти, об'єкти будуть серіалізовані. Докладніше про серіалізацію об'єктів дивіться в описі __sleep()

values

Асоціативний масив ключів та значень.

ttl

Час, протягом якого змінна знаходиться у кеші, за секунди. Після того, як значення, вказане в ttl буде передано, збережена змінна буде видалена з кеша. Параметр набуває значення за замовчуванням , что означает, что переменная останется в кеше, пока она не будет явно удалена с помощью функцийwincache_ucache_delete() або wincache_ucache_clear()

Значення, що повертаються

Якщо key є рядком, функція повертає true у разі успішного виконання та **false**в случае возникновения ошибки.

Якщо key є масивом, функція повертає:

Якщо всі пари ім'я => значення масиву можуть бути встановлені, функція повертає порожній масив;
Якщо всі пари ім'я => значення в масиві не можуть бути встановлені, функція повертає false
Якщо деякі з них можуть бути встановлені, а інші - ні, функція повертає масив з парами name => value, які не вдалося додати в кеш користувача.

Приклади

Приклад #1 Приклад використання wincache_ucache_add()сkey у вигляді рядка

Loading...

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

bool(true)
bool(false)
string(3) "BAR"

Приклад #2 Приклад використання wincache_ucache_add()сkey у вигляді масиву

Loading...

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

array(0) { }
array(4) {
  ["green"]=> int(-1)
  ["Blue"]=> int(-1)
  ["yellow"]=> int(-1)
  ["cyan"]=> int(-1)
}
string(1) "6"

Дивіться також

wincache_ucache_set() - Додає змінну в кеш користувача і перезаписує змінну, якщо вона вже існує в кеші
wincache_ucache_get() - Отримує змінну, що зберігається в користувальницькому кеші
wincache_ucache_delete() - Видаляє змінні з користувальницького кешу
wincache_ucache_clear() - Видаляє весь вміст користувальницького кешу
wincache_ucache_exists() - Перевіряє, чи існує змінна в кеші користувача
wincache_ucache_meminfo() - Отримує інформацію про використання пам'яті кешу користувача.
wincache_ucache_info() - Отримує інформацію про дані, що зберігаються в кеші користувача
__sleep()