Sistema de Archivos

Sistema de Archivos

Acceso a directorio y sistema de archivos embebido.

Tipos de Entrada

Tipo	Descripción
fs.directory	Sistema de archivos basado en directorio
fs.embed	Sistema de archivos embebido de solo lectura

Sistema de Archivos de Directorio

- name: uploads
  kind: fs.directory
  directory: "/var/data/uploads"
  auto_init: true
  mode: "0755"

Campo	Tipo	Por Defecto	Descripción
directory	string	requerido	Ruta raíz
auto_init	bool	false	Crear directorio si no existe
mode	string	0755	Modo de permisos Unix (octal)

El modo restringe todas las operaciones de archivo. Los bits de ejecución se agregan automáticamente cuando los bits de lectura están presentes.

Las rutas se normalizan y validan. No es posible acceder a archivos fuera del directorio raíz configurado.

Sistema de Archivos Embebido

- name: static
  kind: fs.embed

Los sistemas de archivos embebidos cargan desde recursos del pack usando el ID de entrada. Son de solo lectura.

Los sistemas de archivos embebidos son un mecanismo interno. La configuración manual típicamente no es requerida.

Operaciones

Ambos tipos de sistema de archivos implementan:

Operación	Directorio	Embebido
Open/Read	Sí	Sí
Stat	Sí	Sí
ReadDir	Sí	Sí
OpenFile (escribir)	Sí	No
Remove	Sí	No
Mkdir	Sí	No

Las operaciones de escritura en sistemas de archivos embebidos retornan un error.

API Lua

Ver Módulo Filesystem para operaciones de archivo.

Ver También

• Módulo Filesystem - Referencia de la API Lua
• Cloud Storage - Almacenamiento de objetos compatible con S3
• Template - Plantillas cargadas desde sistemas de archivos