`find`

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

ArquivosVersão 1.2.1Estável

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

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> [options]

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

Observações

As opções podem ser combinadas, por exemplo find app -f -e json ou find source -t -e ini -c. Os modos somente arquivos e somente diretórios são mutuamente exclusivos.

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 dentro de arquivos de texto

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.1

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 dentro de arquivos de texto

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

logs/errors.log

Limitar pela extensão; tar.gz é aceito

find app -f -e json -p config

config/app.json

Forma curta de -e php

find Calculator -php -p src

src/Calculator.php

Pesquisar somente diretórios

find data -F -p .

data/

Pesquisar somente no diretório atual

find sample -h -p data

data/.sample-cache

Diferenciar maiúsculas de minúsculas

find ERROR -t -c -p logs

logs/errors.log

Iniciar a pesquisa em outro diretório

find app -p config -f

config/app.ini
config/app.json

Pesquisar uma consulta que começa com -

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

No matches

Iniciar a pesquisa em outro diretório

find missing -p no-such-dir

Diretório não encontrado: no-such-dir

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.12026-08-07

Opções de busca combináveis

Move filtros reutilizáveis para um grupo próprio de opções e tira limites internos da ajuda curta.

# Histórico de versões

find