Перейти к содержимому

Файловая система

Доступ к директориям и встроенным файловым системам.

ТипОписание
fs.directoryФайловая система на основе директории
fs.embedВстроенная файловая система (только чтение)
- name: uploads
kind: fs.directory
directory: "/var/data/uploads"
auto_init: true
mode: "0755"
ПолеТипПо умолчаниюОписание
directorystringобязательноКорневой путь
auto_initboolfalseСоздать директорию, если не существует
modestring0755Unix-права (восьмеричное число)

Права ограничивают все файловые операции. Биты выполнения добавляются автоматически при наличии битов чтения.

Пути нормализуются и проверяются. Доступ к файлам за пределами настроенной корневой директории невозможен.
- name: static
kind: fs.embed

Встроенные файловые системы загружаются из ресурсов пакета по ID записи. Они доступны только для чтения.

Встроенные файловые системы — внутренний механизм. Ручная настройка обычно не требуется.

Оба типа файловых систем реализуют:

ОперацияDirectoryEmbed
Open/ReadДаДа
StatДаДа
ReadDirДаДа
OpenFile (запись)ДаНет
RemoveДаНет
MkdirДаНет

Операции записи во встроенных файловых системах возвращают ошибку.

См. Модуль Filesystem для файловых операций.

  • Модуль Filesystem — справочник Lua API
  • Cloud Storage — S3-совместимое объектное хранилище
  • Template — шаблоны, загружаемые из файловых систем