wincache_ucache_set

(PECL wincache >= 1.1.0)

wincache_ucache_set — Додає змінну в кеш користувача і перезаписує змінну, якщо вона вже існує в кеші

Опис

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

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

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

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

key

Зберігає змінну з використанням цього імені keyЕсли переменная с таким жеkey вже існує, функція перезапише попереднє значення новим . keyчувствителен к регистру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_set()сkey у вигляді рядка

Loading...

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

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

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

Loading...

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

array(0) {}
array(0) {}
string(1) "6"

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

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