bitrix-storage
Installation
SKILL.md
Storage Boundaries: Option / Persistent / Cache
Decision guide
| Need | Use |
|---|---|
| Deploy-time / secrets / env | .settings.php / .settings_extra.php / env (bitrix-settings) |
| Permanent module/portal setting (admin-editable, no TTL) | Bitrix\Main\Config\Option + default_option.php |
| Guaranteed TTL server-side state between hits | PersistentStorageInterface (Since main 25.1100) |
| Many writes per hit; loss OK on crash | DeferredStorageDecorator over persistent storage |
| Derived data that may be evicted anytime | Cache / ManagedCache / TaggedCache (bitrix-caching) |
| Per-user interactive session | Application::getSession() (bitrix-sessions) |
| Large blobs | Files in /upload/ |
Do not use Option as chatty operational storage (progress, checkpoints, one-time tokens). Do not use cache when the value must survive eviction. Do not put secrets in Persistent Storage — use crypto / env.