attr

Lee metadatos portátiles y atributos extendidos de archivos; los xattr disponibles también se pueden escribir y eliminar.

ArchivosVersión 1.3.1Estable
lil-terminal

Resumen

attr mantiene útiles los metadatos entre hostings: las etiquetas localizadas siguen siendo legibles, las claves inglesas estables ya se pueden consultar y las claves xattr reales permanecen como dominio escribible separado.

Metadatos que permanecen con el archivo

Para obtener metadatos previsibles entre distintos hostings, empiece por las claves portátiles; use atributos extendidos solo cuando el servidor exponga xattr de verdad.

Sintaxis

lil-terminal
attr [path [key]] [-x|-d|-s <value>]

Referencia

attr

mostrar metadatos portables del directorio actual

attr <path>

mostrar claves extendidas o metadatos portables

attr <path> <key>

mostrar un campo portable o el valor de un atributo extendido

attr <path> <key> : <value>

establecer texto sin procesar en un atributo extendido

-x

mostrar el valor seleccionado en hexadecimal

-s <value>

establecer un valor de texto en un atributo extendido

-d

eliminar un atributo extendido

Campos portables

Las claves estables son path, type, permissions, access, size, mime, dimensions y modified. Son de solo lectura y conservan estos nombres de máquina en inglés en todos los idiomas de la interfaz. size, mime y dimensions aparecen solo cuando corresponden a la ruta seleccionada. Una clave portable tiene prioridad sobre un atributo extendido con el mismo nombre simple; las claves con espacio de nombres, como user.note, siguen siendo inequívocas.

Atributos extendidos

Cuando xattr está disponible, attr <path> enumera las claves reales del sistema de archivos. La lectura, la salida hexadecimal, la escritura y el borrado siguen usando esas claves reales. Los metadatos portables no simulan operaciones de escritura en un hosting sin xattr.

Vista interactiva del sandbox

Ejecuta los ejemplos preparados directamente en la página. Los resultados están predefinidos y se muestran en el navegador; no se ejecuta ningún comando de terminal en el servidor.

Inspeccionar metadatos del archivo

La extensión .xml no cambia las comprobaciones del sistema de archivos; la información MIME solo se añade cuando PHP puede identificarla correctamente.

Instalar y administrar

Instala la versión compatible actual. Elige Base para el conjunto completo de funciones o Minimum para el paquete reducido; usa upgrade para actualizar un módulo ya instalado.

Base y Minimum son dos paquetes de la misma versión actual del módulo.

Paquete Base

Instala el paquete completo con referencia local y todos los modos publicados.

install attr
Paquete Minimum

Instalar el paquete reducido. No incluye la referencia local; help <cmd> -i abre la referencia actual del servidor.

install attr -m
Versión pública exacta

Instalar exactamente esta versión publicada.

install attr -v 1.3.1
Comprobar o actualizar

upgrade comprueba la compatibilidad y sustituye el bloque solo cuando hace falta.

upgrade attr
Eliminar módulo

Elimina el bloque de extensión sin tocar el núcleo ni otros módulos.

install attr -u

Ejemplos

Los ejemplos se pueden copiar, pero el sitio no los ejecuta. Revisa rutas, permisos y opciones destructivas.

Inspeccionar metadatos del archivo
cd \sandbox | attr feed.xml | attr feed.xml permissions
feed.xml
path         feed.xml
type         file
permissions  0644
size         1.3 KB
mime         application/xml

permissions  0644

La extensión .xml no cambia las comprobaciones del sistema de archivos; la información MIME solo se añade cuando PHP puede identificarla correctamente.

Leer un campo de metadatos
attr sandbox/feed.xml permissions
0644

Las imágenes reconocidas añaden sus dimensiones en píxeles a los mismos metadatos portátiles del archivo.

Escribir un campo de metadatos propio
attr sandbox/feed.xml user.note : reviewed
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes

Los directorios conservan su propio tipo de objeto y omiten los campos exclusivos de archivos: tamaño, MIME y datos de imagen.

Leer un campo de metadatos propio
attr sandbox/feed.xml user.note
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes
Guardar metadatos en un archivo
attr sandbox/feed.xml > attr.log
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes
Gestionar una ruta inexistente
attr \sandbox\missing.txt
Ruta no encontrada

Archivo usado en este ejemplo: sandbox/feed.xml

El ejemplo usa un archivo o directorio del espacio protegido de documentación /sandbox/.

<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <title>lil-sandbox</title>
  <entry id="1">Example XML content</entry>
</feed>

Documentación relacionada

¿Cómo se protegen las operaciones del sistema de archivos? →¿Por qué se limitan los archivos grandes y la cantidad de salida? →

Versión pública actual

v1.3.12026-08-14

Sintaxis clara para valores de atributos

La escritura de atributos extendidos usa :, los metadatos portables siguen siendo de solo lectura y > adquiere un único significado en todo el sistema.

# Historial de versiones