Поиск текста в файлах в Linux: grep, find, ripgrep и примеры для PHP-проекта
Разбираем рабочие приёмы поиска по кодовой базе: от быстрого grep до ripgrep и комбинаций find с фильтрами по времени изменения. Все примеры адаптированы под современную PHP-разработку.
Базовый поиск: grep и его повседневные флаги
Самый частый сценарий — найти вхождения строки внутри всех файлов проекта. Для этого используют grep -r (рекурсивный обход) и -n, чтобы получить номер строки. Команда выглядит так:
grep -rn "declare(strict_types" src/Здесь -r включает рекурсивный проход по каталогу src/, а -n выводит номера строк. Если нужно искать без учёта регистра, добавляют -i:
grep -rni "datetimeinterface" src/Полезно ограничивать поиск только PHP-файлами через маску --include:
grep -rn --include="*.php" "readonly class" .Для бинарных файлов grep обычно выводит только факт совпадения. Флаг -I отключает обработку бинарных данных, а -l показывает только имена файлов, где найдено совпадение:
grep -rIl "enum Status" app/Точный поиск по PHP-сущностям
Когда нужно найти объявление класса, метода или свойства, свободный текстовый поиск даёт лишний шум. Лучше использовать регулярные выражения с границами слов:
grep -rn --include="*.php" "function __construct" src/Для поиска вызовов конкретного метода добавьте границы \b:
grep -rn --include="*.php" "\bisValid\s*\(" src/Если в проекте используется строгая типизация, можно быстро проверить, где именно она объявлена:
grep -rn --include="*.php" "declare(strict_types=1)" .Такая проверка полезна при миграции на PHP 8.4 и 8.5, когда нужно убедиться, что старые модули не остались без строгой типизации.
find + xargs для сложных фильтров
Сам по себе grep не умеет фильтровать файлы по дате изменения. Здесь подключается find. Классическая комбинация:
find . -name "*.php" -mtime -1 -print0 | xargs -0 grep -n "slug"Разберём флаги:
-mtime -1— файлы, изменённые за последние сутки;-print0иxargs -0— безопасная передача имён с пробелами и спецсимволами;-nу grep — показывать номера строк.
Если нужно искать только по .php и .inc:
find src -type f \( -name "*.php" -o -name "*.inc" \) -mtime -7 -print0 | xargs -0 grep -Hn "todo"-H заставляет grep всегда выводить имя файла, даже если передан один файл. Это удобно в связке с xargs.
Фильтры по дате изменения на практике
В PHP-проекте часто нужно найти строку только в файлах, которые менялись после определённого события: merge-request, рефакторинг, обновление библиотеки. Примеры фильтров:
-mtime -1— за последние 24 часа;-mtime -7— за неделю;-mmin -60— за последние 60 минут;-newer file.txt— файлы, изменённые позже, чем указанный.
Поиск недавно добавленных вызовов метода json_validate (актуален для PHP 8.3+):
find app -name "*.php" -mtime -3 -print0 | xargs -0 grep -n "json_validate"Для сравнения с момента конкретного коммита можно зафиксировать точку через -newer:
touch /tmp/start && git pull && find . -name "*.php" -newer /tmp/start -print0 | xargs -0 grep -n "function"ripgrep как замена grep в больших проектах
ripgrep (команда rg) работает быстрее и по умолчанию учитывает .gitignore. Это критично для PHP-проектов с каталогами vendor/ и node_modules/, которые не нужно сканировать.
Простой поиск:
rg "declare(strict_types=1)" app/Поиск только в PHP-файлах:
rg -t php "readonly class" .Ключевые преимущества:
- игнорирует скрытые файлы и бинарники без дополнительных флагов;
- поддерживает регулярные выражения PCRE2;
- выводит контекст до и после совпадения через
-C 2; - работает с файловыми масками через
-g.
Пример с контекстом для поиска метода:
rg -C 3 "function toArray" src/Замена строки в найденных файлах возможна через rg -l и цикл, но для массовых правок лучше использовать инструменты вроде sed с осторожностью.
Комбинированный поиск по PHP-проекту
Соберём типовой сценарий: нужно найти все вызовы устаревшего метода utf8_encode в проекте, исключив каталог vendor, и показать файлы, изменённые за последний месяц. С ripgrep это делается одной командой:
rg -t php -g "!vendor/**" "utf8_encode" -mtime -30Но ripgrep не поддерживает -mtime — это флаг find. Поэтому комбинируем:
find app src -name "*.php" -mtime -30 -print0 | xargs -0 rg "utf8_encode"Или с grep:
find app src -name "*.php" -mtime -30 -print0 | xargs -0 grep -n "utf8_encode"Проверка, что в проекте нет следов удалённых функций вроде create_function:
rg -n "create_function|mysql_query|ereg_replace" app/Если ripgrep не установлен, используйте grep:
grep -rn --include="*.php" -E "create_function|mysql_query|ereg_replace" app/Поиск с учётом структуры классов
Иногда нужно найти не просто текст, а объявление именованной сущности. Регулярки покрывают большинство случаев:
rg -n "class\s+\w*Repository" src/Поиск всех enum, объявленных в проекте:
rg -n "enum\s+\w+" app/Для PHP 8.4 с property hooks:
rg -n "(public|protected|private)\s+\w+\s+\{\s*(get|set)" src/Таблица основных флагов для быстрой сверки:
| Инструмент | Флаг | Назначение |
|---|---|---|
| grep | -r | Рекурсивный обход каталогов |
| grep | -n | Номера строк |
| grep | -i | Без учёта регистра |
| grep | -l | Только имена файлов |
| find | -mtime | Фильтр по дате изменения |
| find | -print0 | Безопасный вывод имён |
| rg | -t php | Только PHP-файлы |
| rg | -C | Контекстные строки |
Практичный чек-лист
- Для быстрого поиска строки в проекте начните с
rg "строка" src/, а не с grep. - Если ripgrep недоступен — используйте
grep -rn --include="*.php". - При поиске по недавно изменённым файлам всегда применяйте
find ... -print0иxargs -0, чтобы не сломать имена с пробелами. - Не забывайте исключать
vendor/иvar/cache/из вывода. - Для поиска объявлений классов и методов используйте регулярки с границами слов.
- Проверяйте старый PHP-код на следы удалённых функций:
mysql_query,ereg_replace,create_function. - При анализе изменений после merge используйте
-newerот временной метки. - Всегда проверяйте результат поиска перед массовыми заменами.
Частые вопросы
Как искать текст только в PHP-файлах?
С помощью grep: grep -rn --include="*.php" "строка" каталог. С ripgrep: rg -t php "строка" каталог.
Как исключить каталог vendor из поиска?
Ripgrep делает это автоматически по .gitignore. Для grep используйте --exclude-dir=vendor: grep -rn --exclude-dir=vendor "строка" .
Можно ли искать только в файлах, изменённых за последние сутки?
Да, комбинируйте find и grep: find . -name "*.php" -mtime -1 -print0 | xargs -0 grep -n "строка".
Чем ripgrep лучше grep для PHP-проектов?
Он быстрее, игнорирует vendor/ по умолчанию, поддерживает PCRE2 и выводит более читаемый контекст вокруг совпадений.