find

Ищет файлы, каталоги и текст по имени, содержимому, типу, расширению, глубине и регистру.

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

Обзор

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

Поиск от общего к точному

Стройте поиск от общего к точному: сначала имя или содержимое, затем добавляйте путь, тип, расширение, глубину и учёт регистра.

Синтаксис

lil-terminal
find [query] [-f|-F|-d] [-h|-t] [-e <ext>] [-c] [-p <path>]

Справочник

find <query>

рекурсивно искать имена в текущем каталоге

find -q <query>

искать запрос, начинающийся с -

-f

искать только файлы

-F | -d

искать только каталоги

-h

искать только в текущем каталоге

-t

искать внутри текстовых файлов

-e <ext>

ограничить поиск расширением; поддерживается tar.gz

-php

краткая форма для -e php

-c

учитывать регистр

-p <path>

начать поиск в другом каталоге

find -e txt

показать все файлы указанного расширения (без обязательного запроса)

find -txt

показать все файлы указанного расширения (без обязательного запроса)

Как читать результат

find -e txt или find -txt покажет все TXT-файлы без отдельного слова для поиска. find sample -e txt найдёт TXT-файлы, в названии которых есть «sample». Для поиска внутри файлов через -t текст обязателен.

Безопасность и ограничения

-p задаёт начальную папку, -h запрещает обход её подпапок. -f несовместим с -F/-d. Лимиты защищают хостинг от слишком больших поисков; ссылки на каталоги рекурсивно не обходятся.

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

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

Рекурсивно искать имена в текущем каталоге

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

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

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

Пакет Base

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

install find
Пакет Minimum

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

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

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

install find -v 1.2.2
Проверить или обновить

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

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

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

install find -u

Примеры

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

Рекурсивно искать имена в текущем каталоге
find app -p \sandbox\config
sandbox/config/app.conf
sandbox/config/app.ini
sandbox/config/app.ini.enc
sandbox/config/app.json
sandbox/config/app.properties
sandbox/config/app.toml
sandbox/config/app.xml
sandbox/config/app.yml
Искать запрос, начинающийся с -
find -q "-draft" -p \sandbox\tmp
No matches
Искать только файлы
find app -f -p \sandbox\config
sandbox/config/app.conf
sandbox/config/app.ini
sandbox/config/app.ini.enc
sandbox/config/app.json
sandbox/config/app.properties
sandbox/config/app.toml
sandbox/config/app.xml
sandbox/config/app.yml
Искать только каталоги
find data -F -p \sandbox
sandbox/data/
Искать только каталоги
find data -d -p \sandbox
sandbox/data/
Искать только в текущем каталоге
find app -h -p \sandbox\config
sandbox/config/app.conf
sandbox/config/app.ini
sandbox/config/app.ini.enc
sandbox/config/app.json
sandbox/config/app.properties
sandbox/config/app.toml
sandbox/config/app.xml
sandbox/config/app.yml
Искать внутри текстовых файлов
find "timeout" -t -p \sandbox\logs
sandbox/logs/errors.log
Ограничить поиск расширением; поддерживается tar.gz
find -e txt -p \sandbox\data
sandbox/data/sample.txt
Краткая форма для -e php
find Calculator -php -p \sandbox\src
sandbox/src/Calculator.php
Учитывать регистр
find SAMPLE -c -p \sandbox\data
No matches
Начать поиск в другом каталоге
find app -p \sandbox\config -f
sandbox/config/app.conf
sandbox/config/app.ini
sandbox/config/app.ini.enc
sandbox/config/app.json
sandbox/config/app.properties
sandbox/config/app.toml
sandbox/config/app.xml
sandbox/config/app.yml
Показать все файлы указанного расширения (без обязательного запроса)
find -e txt -p \sandbox\tmp
sandbox/tmp/README.txt
sandbox/tmp/current.txt
sandbox/tmp/draft.txt
sandbox/tmp/new.txt
Показать все файлы указанного расширения (без обязательного запроса)
find -txt -p \sandbox\data
sandbox/data/sample.txt
Find · sample
find sample -e txt -p \sandbox\data
sandbox/data/sample.txt
Ограничить поиск расширением; поддерживается tar.gz
find -e tar.gz -p \sandbox\my
No matches
Искать только файлы
find app -f -F -p \sandbox\config
Выберите файлы или каталоги
Начать поиск в другом каталоге
find foo -p \sandbox\does-not-exist
Каталог поиска не найден

Файл из примера: sandbox/src/Calculator.php

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

<?php

declare(strict_types=1);

final class Calculator
{
    public static function add(int $left, int $right): int
    {
        return $left + $right;
    }
}

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

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

v1.2.22026-10-31

Поиск файлов по расширению

find -e txt and find -txt list matching extensions without requiring a separate name query.