attr

Lit les métadonnées portables et les attributs étendus des fichiers ; les xattr disponibles peuvent aussi être écrits ou supprimés.

FichiersVersion 1.3.1Stable
lil-terminal

Vue d’ensemble

attr garde les métadonnées utiles selon l’hébergement : les libellés localisés restent lisibles, les clés anglaises stables deviennent interrogeables et les vraies clés xattr restent un domaine inscriptible distinct.

Des métadonnées qui restent avec le fichier

Pour des métadonnées prévisibles d’un hébergement à l’autre, commencez par les clés portables ; utilisez les attributs étendus seulement si le serveur expose réellement xattr.

Syntaxe

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

Référence

attr

afficher les métadonnées portables du dossier courant

attr <path>

afficher les clés étendues ou les métadonnées portables

attr <path> <key>

afficher un champ portable ou la valeur d’un attribut étendu

attr <path> <key> : <value>

définir du texte brut pour un attribut étendu

-x

afficher la valeur sélectionnée en hexadécimal

-s <value>

définir une valeur texte pour un attribut étendu

-d

supprimer un attribut étendu

Champs portables

Les clés stables sont path, type, permissions, access, size, mime, dimensions et modified. Elles sont en lecture seule et conservent ces noms machine anglais dans toutes les langues de l’interface. size, mime et dimensions n’apparaissent que lorsqu’ils s’appliquent au chemin choisi. Une clé portable est prioritaire sur un attribut étendu portant le même nom simple ; les clés avec espace de noms, telles que user.note, restent non ambiguës.

Attributs étendus

Lorsque xattr est pris en charge, attr <path> énumère les vraies clés du système de fichiers. Lecture, affichage hexadécimal, écriture et suppression continuent d’utiliser ces clés. Les métadonnées portables ne simulent jamais une écriture sur un hébergement sans xattr.

Aperçu interactif du sandbox

Lancez les exemples préparés directement sur la page. Les résultats sont prédéfinis et affichés dans le navigateur ; aucune commande terminal n’est exécutée sur le serveur.

Inspecter les métadonnées du fichier

L’extension .xml ne modifie pas les contrôles du système de fichiers ; les informations MIME ne sont ajoutées que si PHP peut les identifier correctement.

Installer et gérer

Installez la version compatible actuelle. Choisissez Base pour l’ensemble complet des fonctions ou Minimum pour le paquet réduit ; utilisez upgrade pour mettre à jour un module déjà installé.

Base et Minimum sont deux paquets de la même version actuelle du module.

Paquet Base

Installer le paquet complet avec référence locale et tous les modes publiés.

install attr
Paquet Minimum

Installer le paquet réduit. La référence locale est omise ; help <cmd> -i ouvre la référence serveur actuelle.

install attr -m
Version publique exacte

Installer exactement cette version publiée.

install attr -v 1.3.1
Vérifier ou mettre à jour

upgrade vérifie la compatibilité et remplace le bloc seulement si nécessaire.

upgrade attr
Supprimer le module

Supprimer le bloc d’extension sans toucher au noyau ni aux autres modules.

install attr -u

Exemples

Les exemples sont copiables mais ne sont pas exécutés par le site. Vérifiez chemins, droits et options destructrices.

Inspecter les métadonnées du fichier
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

L’extension .xml ne modifie pas les contrôles du système de fichiers ; les informations MIME ne sont ajoutées que si PHP peut les identifier correctement.

Lire un champ de métadonnées
attr sandbox/feed.xml permissions
0644

Les images reconnues ajoutent leurs dimensions en pixels aux mêmes métadonnées portables du fichier.

Écrire un champ de métadonnées personnalisé
attr sandbox/feed.xml user.note : reviewed
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes

Les répertoires conservent leur propre type d’objet et omettent les champs réservés aux fichiers : taille, MIME et données d’image.

Lire un champ de métadonnées personnalisé
attr sandbox/feed.xml user.note
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes
Enregistrer les métadonnées dans un fichier
attr sandbox/feed.xml > attr.log
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes
Gérer un chemin absent
attr \sandbox\missing.txt
Chemin introuvable

Fichier utilisé dans cet exemple: sandbox/feed.xml

L’exemple utilise un fichier ou un répertoire de l’espace de documentation protégé /sandbox/.

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

Documentation associée

Comment les opérations sur les fichiers sont-elles protégées ? →Pourquoi les gros fichiers et les longues sorties sont-ils limités ? →

Version publique actuelle

v1.3.12026-08-14

Syntaxe claire pour les valeurs d’attribut

L’écriture des attributs étendus utilise :, les métadonnées portables restent en lecture seule et > possède désormais un sens unique dans tout le terminal.

# Historique des versions