Функции модуля (__call)


НАЧАЛО >> Оглавление >> Сервер приложений ИРБИС 64/128 >> Описание модулей системы >> Flags - Подсистема флагов >> Функции модуля (__call)📄 Скачать в DOCX


Функции могут быть вызваны как UseModule("Flags")->function(parameter1,parameter2,...);

Имя функцииОписаниеПараметры
GetFlagDataЧтение файлового флага
Подробнее... 
Возвращает сериализованные данные старого файлового флага. Если флаг отсутствует, возвращается null.
ТипПараметрПо умолчаниюОписание
string$nameОбязательныйИмя файла флага без пути.
string$dir''Подкаталог внутри каталога Flags.
GetSystemFlagDefinitionsЧтение системных feature flags
Подробнее... 
Читает системный JSON-контракт модуля Flags и возвращает нормализованные справочники scope, rollout strategies, override levels и определения feature flags.
ТипПараметрПо умолчаниюОписание
array$options'array()'Параметры чтения. raw=true добавляет исходный JSON в результат.
HealthCheckFeatureFlagsDefinitionДиагностика feature flags
Подробнее... 
Выполняет локальную диагностику JSON-контракта feature flags: проверяет наличие файла, валидность JSON, уникальность ключей, owner module, purpose, scopes, rollout strategies, review и expiry dates.
ТипПараметрПо умолчаниюОписание
array$options'array()'Параметры диагностики. strict=true переводит предупреждения о неполных описаниях в ошибки.
IsExistsПроверка наличия файлового флага
Подробнее... 
Проверяет существование старого файлового флага в каталоге данных модуля Flags.
ТипПараметрПо умолчаниюОписание
string$nameОбязательныйИмя файла флага без пути.
string$dir''Подкаталог внутри каталога Flags.
IsNewerСравнение времени файловых флагов
Подробнее... 
Проверяет, что первый файловый флаг существует и был изменен позже второго файлового флага. Используется старыми кешами модулей.
ТипПараметрПо умолчаниюОписание
string$name1ОбязательныйИмя первого флага.
string$dir1ОбязательныйКаталог первого флага внутри Flags.
string$name2ОбязательныйИмя второго флага.
string$dir2ОбязательныйКаталог второго флага внутри Flags.
KillFlagУдаление файлового флага
Подробнее... 
Удаляет старый файловый флаг из каталога данных модуля Flags. Отсутствующий флаг не считается ошибкой.
ТипПараметрПо умолчаниюОписание
string$nameОбязательныйИмя файла флага без пути.
string$dir''Подкаталог внутри каталога Flags.
NormalizeFlagContextНормализация контекста feature flag
Подробнее... 
Приводит runtime-контекст проверки feature flag к единому виду: host, module, project, user, roles, environment, canary group и stable bucket для процентного rollout.
ТипПараметрПо умолчаниюОписание
array$context'array()'Контекст вызывающего модуля или страницы.
NormalizeFlagDefinitionНормализация определения feature flag
Подробнее... 
Приводит описание feature flag из JSON или внешнего контракта модуля к единой структуре Flags: key, owner, default state, scope, rollout, overrides, review и diagnostics.
ТипПараметрПо умолчаниюОписание
array$definitionОбязательныйИсходное описание feature flag.
PlanFlagChangeПланирование изменения feature flag
Подробнее... 
Выполняет dry-run изменения feature flag: проверяет, существует ли флаг, допустим ли scope override, как изменится effective value и какой audit envelope должен быть создан при реальном применении.
ТипПараметрПо умолчаниюОписание
string$flagKeyОбязательныйКлюч feature flag.
array$change'array()'Планируемое изменение: scope, scopeValue, enabled, reason, actor.
array$context'array()'Runtime-контекст для оценки before/after.
array$options'array()'Текущие overrides, killSwitches и dependencyDecisions.
ResolveFeatureFlagОпределение значения feature flag
Подробнее... 
Вычисляет effective value feature flag для переданного runtime-контекста с учетом default state, rollout strategy, kill switch, dependencies и переданных overrides. Функция не меняет состояние системы.
ТипПараметрПо умолчаниюОписание
string$flagKeyОбязательныйКлюч feature flag.
array$context'array()'Runtime-контекст: host, module, project, user, roles, environment, canaryGroup.
array$options'array()'Overrides, killSwitches, dependencyDecisions и explain.
SetFlagЗапись файлового флага
Подробнее... 
Создает или обновляет старый файловый флаг в каталоге данных модуля Flags. Функция сохранена для совместимости существующих кешей и фоновых задач.
ТипПараметрПо умолчаниюОписание
string$nameОбязательныйИмя файла флага без пути.
string$dir''Подкаталог внутри каталога Flags. Для старых вызовов может начинаться с символа /.
mixed$data'1'Сериализуемые данные флага.