find

Pesquisa arquivos, diretórios e texto por nome, conteúdo, tipo, extensão, profundidade e maiúsculas/minúsculas.

ArquivosVersão 1.2.2Estável
lil-terminal

Visão geral

find combina filtros simples: tipo, extensão, profundidade, caixa, conteúdo e caminho inicial podem formar uma única consulta precisa ao sistema de arquivos.

Restringir uma busca passo a passo

Construa a busca do geral para o específico: primeiro nome ou conteúdo, depois caminho, tipo, extensão, profundidade e diferenciação de maiúsculas/minúsculas.

Sintaxe

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

Referência

find <query>

pesquisar nomes recursivamente no diretório atual

find -q <query>

pesquisar uma consulta que começa com -

-f

pesquisar somente arquivos

-F | -d

pesquisar somente diretórios

-h

pesquisar somente no diretório atual

-t

pesquisar dentro de arquivos de texto

-e <ext>

limitar pela extensão; tar.gz é aceito

-php

forma curta de -e php

-c

diferenciar maiúsculas de minúsculas

-p <path>

iniciar a pesquisa em outro diretório

find -e txt

listar todos os arquivos da extensão sem consulta

find -txt

listar todos os arquivos da extensão sem consulta

Como ler os resultados

find -e txt ou find -txt lista todos os TXT sem termo de pesquisa. find sample -e txt filtra nomes TXT que contenham “sample”. A pesquisa de conteúdo com -t precisa de texto.

Segurança e limites

-p muda o diretório inicial; -h pesquisa apenas nele. -f não pode ser combinado com -F/-d. Os limites de varredura protegem a hospedagem compartilhada; links simbólicos de diretórios não são percorridos recursivamente.

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.

Pesquisar nomes recursivamente no diretório atual

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 find
Pacote Minimum

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

install find -m
Versão pública exata

Instalar exatamente esta versão publicada.

install find -v 1.2.2
Verificar ou atualizar

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

upgrade find
Remover módulo

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

install find -u

Exemplos

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

Pesquisar nomes recursivamente no diretório atual
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
Pesquisar uma consulta que começa com -
find -q "-draft" -p \sandbox\tmp
No matches
Pesquisar somente arquivos
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
Pesquisar somente diretórios
find data -F -p \sandbox
sandbox/data/
Pesquisar somente diretórios
find data -d -p \sandbox
sandbox/data/
Pesquisar somente no diretório atual
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
Pesquisar dentro de arquivos de texto
find "timeout" -t -p \sandbox\logs
sandbox/logs/errors.log
Limitar pela extensão; tar.gz é aceito
find -e txt -p \sandbox\data
sandbox/data/sample.txt
Forma curta de -e php
find Calculator -php -p \sandbox\src
sandbox/src/Calculator.php
Diferenciar maiúsculas de minúsculas
find SAMPLE -c -p \sandbox\data
No matches
Iniciar a pesquisa em outro diretório
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
Listar todos os arquivos da extensão sem consulta
find -e txt -p \sandbox\tmp
sandbox/tmp/README.txt
sandbox/tmp/current.txt
sandbox/tmp/draft.txt
sandbox/tmp/new.txt
Listar todos os arquivos da extensão sem consulta
find -txt -p \sandbox\data
sandbox/data/sample.txt
Find · sample
find sample -e txt -p \sandbox\data
sandbox/data/sample.txt
Limitar pela extensão; tar.gz é aceito
find -e tar.gz -p \sandbox\my
No matches
Pesquisar somente arquivos
find app -f -F -p \sandbox\config
Escolha arquivos ou diretórios, não ambos
Iniciar a pesquisa em outro diretório
find foo -p \sandbox\does-not-exist
Diretório de pesquisa não encontrado

Arquivo usado neste exemplo: sandbox/src/Calculator.php

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

<?php

declare(strict_types=1);

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

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.2.22026-10-31

Extension-only search

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

# Histórico de versões