attr

показывает свойства файла или папки

ФайлыВерсия 1.3.2Стабильная
lil-terminal

Обзор

attr показывает свойства файла или папки. Без аргументов — свойства текущего каталога; с путём — свойства выбранного объекта. На хостинге без поддержки xattr команда читает переносимые поля: path, type, permissions, access, size, mime, dimensions, modified. Поля можно запросить по отдельности, например attr feed.xml MIME.

Как прочитать MIME и права

Попробуйте attr feed.xml MIME, затем attr feed.xml permissions -x. Последняя команда кодирует текстовое значение прав в HEX; она не меняет сами права.

Синтаксис

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

Справочник

attr

показать переносимые метаданные текущего каталога

attr <path>

показать расширенные ключи или переносимые метаданные

attr <path> <key>

показать переносимое поле или значение расширенного атрибута

attr <path> <key> : <value>

задать необработанный текст расширенного атрибута

-x

показать выбранное значение в шестнадцатеричном виде

-s <value>

задать текстовое значение расширенного атрибута

-d

удалить расширенный атрибут

Примечания

Названия переносимых полей не зависят от регистра: MIME, Mime и mime одинаковы. Но имена настоящих расширенных атрибутов xattr чувствительны к регистру и сохраняют точное написание. -x выводит значение в HEX, -s и форма : записывают текст, -d удаляет выбранный xattr. Эти действия доступны только при поддержке xattr; переносимые поля изменять нельзя.

Безопасность

attr не заменяет mod: права меняют через mod, а здесь лишь читают. Для независимой от сервера диагностики используйте attr file.txt permissions или stat file.txt. В демонстрации показана среда без xattr, поэтому запись и удаление завершаются понятным сообщением, а не имитацией успеха.

Интерактивный пример из `/sandbox/`

Запускайте подготовленные примеры прямо на странице. Результат заранее сформирован и показывается в браузере; команды терминала на сервере не выполняются.

Проверить метаданные файла

Расширение .xml не меняет проверку файловой системы: MIME-тип добавляется только тогда, когда PHP может определить его корректно.

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Пакет Base

Установить полный пакет с локальной справкой и всеми опубликованными режимами.

install attr
Пакет Minimum

Установить сокращённый пакет без локальной справки; help <cmd> -i открывает актуальную серверную справку.

install attr -m
Точная публичная версия

Установить именно эту опубликованную версию.

install attr -v 1.3.2
Проверить или обновить

Поручить upgrade проверить совместимость и заменить установленный блок только при необходимости.

upgrade attr
Удалить модуль

Удалить блок расширения, не затрагивая ядро и остальные модули.

install attr -u

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

Проверить метаданные файла
attr
Path [path]                sandbox
Type [type]                directory
Permissions [permissions]  0755
Access [access]            rwx
Modified [modified]        2026-08-11 18:40:00

Расширение .xml не меняет проверку файловой системы: MIME-тип добавляется только тогда, когда PHP может определить его корректно.

Прочитать одно поле метаданных
attr \sandbox\feed.xml
Путь [path]          sandbox/feed.xml
Тип [type]           file
Права [permissions]  0644
Доступ [access]      rw-
Размер [size]        127 B
MIME [mime]          application/xml
Изменён [modified]   2026-08-11 18:40:00

Для распознанного изображения к тем же переносимым метаданным добавляются размеры в пикселях.

Записать пользовательское поле
attr \sandbox\feed.xml MIME
text/xml

Каталог сохраняет собственный тип объекта; поля размера файла, MIME-типа и параметров изображения для него не выводятся.

Прочитать пользовательское поле
attr \sandbox\feed.xml permissions -x
30363434
Сохранить метаданные в файл
attr \sandbox\feed.xml permissions -s 0600
Переносимые атрибуты доступны только для чтения
Обработать отсутствующий путь
attr \sandbox\feed.xml user.note : reviewed
Расширенные атрибуты недоступны; переносимые атрибуты доступны только для чтения
Задать текстовое значение расширенного атрибута
attr \sandbox\feed.xml user.note -s reviewed
Расширенные атрибуты недоступны; переносимые атрибуты доступны только для чтения
Удалить расширенный атрибут
attr \sandbox\feed.xml user.note -d
Расширенные атрибуты недоступны; переносимые атрибуты доступны только для чтения
Показать выбранное значение в шестнадцатеричном виде
attr \sandbox\feed.xml user.note -x
Расширенные атрибуты недоступны; переносимые атрибуты доступны только для чтения
Удалить расширенный атрибут
attr \sandbox\feed.xml permissions -d
Переносимые атрибуты доступны только для чтения
Показать переносимое поле или значение расширенного атрибута
attr \sandbox\images\icon.svg dimensions
Attribute not found
Показать расширенные ключи или переносимые метаданные
attr \sandbox\missing.txt
Путь не найден

Файл из примера: sandbox/feed.xml

Пример использует файл или каталог из защищённой учебной папки /sandbox/.

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

Связанная документация

Как защищены файловые операции? →Почему ограничены большие файлы и объём вывода? →

Текущая публичная версия

v1.3.22026-10-31

Переносимые поля без учёта регистра

MIME, Type и другие переносимые поля теперь принимают любой регистр. Реальные имена расширенных атрибутов остаются чувствительными к регистру.

# История версий