`find`

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

ФайлыВерсия 1.2.1Стабильная

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/find data -F -p .data/find app -p config -fconfig/app.ini config/app.jsonfind sample -h -p datadata/.sample-cache

Обзор

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

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

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

Синтаксис

lil-terminal

find <query> [options]

Справочник

find <query>

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

find -q <query>

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

-f

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

-F | -d

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

-h

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

-t

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

-e <ext>

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

-php

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

-c

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

-p <path>

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

Примечания

Флаги можно комбинировать: например, find app -f -e json или find source -t -e ini -c. Режимы «только файлы» и «только каталоги» взаимоисключающие.

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

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

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

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

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

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

Пакет Base

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

install find

Пакет Minimum

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

install find -m

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

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

install find -v 1.2.1

Проверить или обновить

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

upgrade find

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

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

install find -u

Примеры

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

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

cd \sandbox | find "error" -t -p logs

logs/errors.log

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

find app -f -e json -p config

config/app.json

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

find Calculator -php -p src

src/Calculator.php

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

find data -F -p .

data/

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

find sample -h -p data

data/.sample-cache

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

find ERROR -t -c -p logs

logs/errors.log

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

find app -p config -f

config/app.ini
config/app.json

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

find -q "-draft" -f -p tmp

No matches

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

find missing -p no-such-dir

Каталог не найден: no-such-dir

Файл из примера: `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.12026-08-07

Комбинируемые параметры поиска

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

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

find