Настройки File Inspector

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

[Скриншот 1: общая страница Настройки File Inspector]

Разрешённые корни

Корень по умолчанию

Выбирает корень, который открывается при входе в Инспектор. По умолчанию используется ключ site.

Список корней

Каждый корень состоит из короткого ключа и абсолютного пути. Например, ключ site может указывать на документный корень сайта, а ключ local — на отдельный каталог /.../local.

Добавлять корень выше каталога сайта следует только при реальной необходимости. Корень фактически определяет максимальную область, внутри которой File Inspector разрешает операции.

Режим и лимиты

default_mode

Определяет стартовое представление. В интерфейсе настроек версии 0.8.6 доступны значения tree и code. При первоначальной конфигурации внутреннее значение может быть explorer, что соответствует обычному комбинированному представлению. После сохранения через текущую форму будет выбран один из предлагаемых режимов.

default_depth

Начальная глубина загрузки дерева. Значение по умолчанию — 5. Большое значение делает первое открытие тяжелее, особенно на сайтах с большим количеством вложенных каталогов.

max_depth

Максимальная глубина, используемая поиском и рядом операций обхода. Значение по умолчанию — 10. Если нужные файлы находятся глубже, поиск может до них не дойти.

max_tree_nodes

Ограничивает количество узлов при обходе. По умолчанию — 5000. Это защита от слишком большого рекурсивного прохода.

max_files

Базовый лимит количества файлов для операций, где используется общий файловый предел. Значение по умолчанию — 200.

max_bytes_per_file

Максимальный объём текстового файла, читаемый в обычном просмотре. По умолчанию — 524288 байт (512 КБ). Если файл больше, содержимое обрезается.

show_hidden

Разрешает показывать имена, начинающиеся с точки. Включайте только при необходимости. Даже при включённом show_hidden отдельный файл или папка всё равно может быть скрыт списком исключений.

allow_config_write

Поле присутствует в интерфейсе настроек версии 0.8.6. При этом основная конфигурация модуля фактически хранится в настройках Битрикс через Option. На стандартные файловые операции этот переключатель не даёт отдельного уровня доступа администратора, поэтому не следует воспринимать его как общий переключатель «разрешить запись файлов».

allowed_extensions

Список расширений, которые File Inspector показывает и обрабатывает как рабочие файлы. Начальный набор: php, js, css, html, txt, json, xml.

Расширение вводится без точки. Например, чтобы работать с TypeScript, добавьте ts. Добавление расширения увеличивает область поиска и список доступных файлов.

[Скриншот 2: блок allowed_extensions и добавление нового расширения]

Исключения

exclude_dir_names

Имена каталогов, которые полностью исключаются из дерева и обхода. Начальный набор: .git, .idea, vendor, node_modules. Это полезно для больших каталогов зависимостей и служебных данных.

exclude_file_names

Точные имена файлов, которые не показываются. По умолчанию: .env и .htaccess.

exclude_globs

Маски имён. По умолчанию: *.log и *.tmp. Можно добавить, например, *.map.

Настройки, которые есть в конфигурации, но не выведены отдельными полями формы

Внутренняя конфигурация версии 0.8.6 также содержит параметры автоматических бэкапов и поиска, включая enable_backups, backup_limit, max_files_search и max_bytes_per_file_search. В стандартной форме «Настройки» отдельные элементы управления для них не представлены. По умолчанию автоматические версии включены, лимит — 10 копий на файл.

После изменения настроек

Нажмите «Сохранить», затем обновите проводник. Если вы изменили корни или исключения, ранее открытый путь может стать недоступен — это нормальное поведение.

[Скриншот 3: блок исключений exclude_dir_names, exclude_file_names и exclude_globs]