User variable

14.12.2017

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

  1. Всі змінні зберігаються в окремій таблиці бази даних і витягуються вони при запиті. Стандартні змінні в varible_set () / variable_get () витягуються всі при завантаженні Друпал і постійно знаходяться в пам'яті, цим накладається обмеження на кількості змінних і їх об'єму.
  2. Змінні можуть бути прив'язані до користувачів, тобто в базу також зберігається uid користувача якщо необхідно, тому кожен користувач може мати своє значення кожної з змінних.
  3. Змінні можуть залежати від сесії.
  4. Змінні можуть бути тимчасовими і віддалятися по Cron.
  5. Змінна може бути глобальною (доступною всім користувачам і постійною)

User variable
Це допоміжний модуль для роботи з іншими модулями, яким він надає API:
Встановити чи оновити змінну
user_variable_set($name, $value, $common = FALSE, $uid = 0, $expired = 0, $session = FALSE)

  • $name — ім'я змінної
  • $value — значення
  • $common — якщо TRUE то змінна буде загальною
  • $uid — UID користувача
  • $expired — час у секундах, через яке віддалиться змінна по КРОН
  • $session — ідентифікатор сесії для змінної

Функція повертає значення змінної
user_variable_get($name, $default, $common = FALSE, $uid = 0, $session = '')

  • $name — ім'я змінної
  • $default — значення за замовчуванням
  • $common — якщо TRUE то необхідно повернути значення загальної змінної
  • $uid — UID користувача
  • $session — ідентифікатор сесії для змінної

Функція аналогічна user_variable_get() за винятком того, що якщо не змінної не має, то функція поверне FALSE
user_variable_check($name, $common = FALSE, $uid = 0, $session = '')

Функція віддаляє зміну з бази
user_variable_del($name, $common = FALSE, $uid = 0, $session = '')

  • $name — ім'я змінної
  • $common — якщо TRUE то необхідно повернути значення загальної змінної
  • $uid — UID користувача
  • $session — ідентифікатор сесії для змінної