attr

Lê metadados portáteis e atributos estendidos de arquivos; xattrs disponíveis também podem ser gravados ou removidos.

ArquivosVersão 1.3.1Estável
lil-terminal

Visão geral

attr mantém metadados úteis em hospedagens diferentes: rótulos localizados continuam legíveis, chaves inglesas estáveis passam a ser consultáveis e as chaves xattr reais permanecem em um domínio gravável separado.

Metadados que permanecem com o arquivo

Para obter metadados previsíveis em diferentes hospedagens, comece pelas chaves portáveis; use atributos estendidos somente quando o servidor realmente oferecer xattr.

Sintaxe

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

Referência

attr

mostrar metadados portáteis do diretório atual

attr <path>

mostrar chaves estendidas ou metadados portáteis

attr <path> <key>

mostrar um campo portátil ou o valor de um atributo estendido

attr <path> <key> : <value>

definir texto bruto em um atributo estendido

-x

mostrar o valor selecionado em hexadecimal

-s <value>

definir um valor de texto em um atributo estendido

-d

excluir um atributo estendido

Campos portáteis

As chaves estáveis são path, type, permissions, access, size, mime, dimensions e modified. Elas são somente leitura e mantêm esses nomes de máquina em inglês em todos os idiomas da interface. size, mime e dimensions aparecem apenas quando se aplicam ao caminho escolhido. Uma chave portátil tem prioridade sobre um atributo estendido com o mesmo nome simples; chaves xattr com namespace, como user.note, continuam inequívocas.

Atributos estendidos

Quando xattr é suportado, attr <path> lista as chaves reais do sistema de arquivos. Leitura, saída hexadecimal, gravação e exclusão continuam usando essas chaves. Metadados portáteis não fingem que existe gravação em uma hospedagem sem xattr.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Inspecionar metadados do arquivo

A extensão .xml não altera as verificações do sistema de arquivos; informações MIME só são adicionadas quando o PHP consegue identificá-las corretamente.

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install attr
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install attr -m
Versão pública exata

Instalar exatamente esta versão publicada.

install attr -v 1.3.1
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade attr
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install attr -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Inspecionar metadados do arquivo
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

A extensão .xml não altera as verificações do sistema de arquivos; informações MIME só são adicionadas quando o PHP consegue identificá-las corretamente.

Ler um campo de metadados
attr sandbox/feed.xml permissions
0644

Imagens reconhecidas acrescentam dimensões em pixels aos mesmos metadados portáteis do arquivo.

Gravar um campo de metadados personalizado
attr sandbox/feed.xml user.note : reviewed
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes

Diretórios mantêm seu próprio tipo de objeto e omitem campos exclusivos de arquivos: tamanho, MIME e dados de imagem.

Ler um campo de metadados personalizado
attr sandbox/feed.xml user.note
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes
Salvar metadados em um arquivo
attr sandbox/feed.xml > attr.log
path         sandbox/data/sample.txt
type         file
permissions  0644
readable     yes
writable     yes
Tratar um caminho inexistente
attr \sandbox\missing.txt
Caminho não encontrado

Arquivo usado neste exemplo: sandbox/feed.xml

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /sandbox/.

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

Documentação relacionada

Como as operações no sistema de arquivos são protegidas? →Por que arquivos grandes e saídas extensas são limitados? →

Versão pública atual

v1.3.12026-08-14

Sintaxe clara para valores de atributos

A gravação de atributos estendidos usa :, os metadados portáveis continuam somente leitura e > passa a ter um único significado em todo o sistema.

# Histórico de versões