Функции могут быть вызваны как 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' | Сериализуемые данные флага. |
|