find

名前、内容、種類、拡張子、深さ、大文字小文字を組み合わせてファイル、ディレクトリ、テキストを検索します。

ファイルバージョン 1.2.2安定版
lil-terminal

概要

find は単純な条件を組み合わせます。種類、拡張子、深さ、大文字小文字、内容検索、開始パスを1つの正確なファイル検索にまとめられます。

検索条件を段階的に絞り込む

検索は広い条件から狭めます。まず名前か内容を選び、その後でパス、種類、拡張子、深さ、大文字小文字を追加します。

構文

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 [query] [-f|-F|-d] [-h|-t] [-e <ext>] [-c] [-p <path>]

結果の読み方

find -e txt または find -txt は検索語なしで TXT ファイルを一覧表示します。find sample -e txt は名前に「sample」を含む TXT のみを表示します。-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

Extension-only search

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

# バージョン履歴