PHPTime

Поиск текста в файлах в Linux: grep, find, ripgrep и примеры для PHP-проекта

Разбираем рабочие приёмы поиска по кодовой базе: от быстрого grep до ripgrep и комбинаций find с фильтрами по времени изменения. Все примеры адаптированы под современную PHP-разработку.

Базовый поиск: grep и его повседневные флаги

Самый частый сценарий — найти вхождения строки внутри всех файлов проекта. Для этого используют grep -r (рекурсивный обход) и -n, чтобы получить номер строки. Команда выглядит так:

Shell
grep -rn "declare(strict_types" src/

Здесь -r включает рекурсивный проход по каталогу src/, а -n выводит номера строк. Если нужно искать без учёта регистра, добавляют -i:

Shell
grep -rni "datetimeinterface" src/

Полезно ограничивать поиск только PHP-файлами через маску --include:

Shell
grep -rn --include="*.php" "readonly class" .

Для бинарных файлов grep обычно выводит только факт совпадения. Флаг -I отключает обработку бинарных данных, а -l показывает только имена файлов, где найдено совпадение:

Shell
grep -rIl "enum Status" app/

Точный поиск по PHP-сущностям

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

Shell
grep -rn --include="*.php" "function __construct" src/

Для поиска вызовов конкретного метода добавьте границы \b:

Shell
grep -rn --include="*.php" "\bisValid\s*\(" src/

Если в проекте используется строгая типизация, можно быстро проверить, где именно она объявлена:

Shell
grep -rn --include="*.php" "declare(strict_types=1)" .

Такая проверка полезна при миграции на PHP 8.4 и 8.5, когда нужно убедиться, что старые модули не остались без строгой типизации.

find + xargs для сложных фильтров

Сам по себе grep не умеет фильтровать файлы по дате изменения. Здесь подключается find. Классическая комбинация:

Shell
find . -name "*.php" -mtime -1 -print0 | xargs -0 grep -n "slug"

Разберём флаги:

  • -mtime -1 — файлы, изменённые за последние сутки;
  • -print0 и xargs -0 — безопасная передача имён с пробелами и спецсимволами;
  • -n у grep — показывать номера строк.

Если нужно искать только по .php и .inc:

Shell
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+):

Shell
find app -name "*.php" -mtime -3 -print0 | xargs -0 grep -n "json_validate"

Для сравнения с момента конкретного коммита можно зафиксировать точку через -newer:

Shell
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/, которые не нужно сканировать.

Простой поиск:

Shell
rg "declare(strict_types=1)" app/

Поиск только в PHP-файлах:

Shell
rg -t php "readonly class" .

Ключевые преимущества:

  • игнорирует скрытые файлы и бинарники без дополнительных флагов;
  • поддерживает регулярные выражения PCRE2;
  • выводит контекст до и после совпадения через -C 2;
  • работает с файловыми масками через -g.

Пример с контекстом для поиска метода:

Shell
rg -C 3 "function toArray" src/

Замена строки в найденных файлах возможна через rg -l и цикл, но для массовых правок лучше использовать инструменты вроде sed с осторожностью.

Комбинированный поиск по PHP-проекту

Соберём типовой сценарий: нужно найти все вызовы устаревшего метода utf8_encode в проекте, исключив каталог vendor, и показать файлы, изменённые за последний месяц. С ripgrep это делается одной командой:

Shell
rg -t php -g "!vendor/**" "utf8_encode" -mtime -30

Но ripgrep не поддерживает -mtime — это флаг find. Поэтому комбинируем:

Shell
find app src -name "*.php" -mtime -30 -print0 | xargs -0 rg "utf8_encode"

Или с grep:

Shell
find app src -name "*.php" -mtime -30 -print0 | xargs -0 grep -n "utf8_encode"

Проверка, что в проекте нет следов удалённых функций вроде create_function:

Shell
rg -n "create_function|mysql_query|ereg_replace" app/

Если ripgrep не установлен, используйте grep:

Shell
grep -rn --include="*.php" -E "create_function|mysql_query|ereg_replace" app/

Поиск с учётом структуры классов

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

Shell
rg -n "class\s+\w*Repository" src/

Поиск всех enum, объявленных в проекте:

Shell
rg -n "enum\s+\w+" app/

Для PHP 8.4 с property hooks:

Shell
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 и выводит более читаемый контекст вокруг совпадений.

Справка по теме

Ещё в разделе «Linux и серверы»

Сайт на PHP недоступен: пошаговый чек-лист диагностики

Пошаговая диагностика недоступного PHP-сайта: проверяем DNS, TLS, веб-сервер, PHP-FPM, базу данных, свободное место и логи, чтобы найти причину сбоя.

8 мин

Google Drive в Linux: rclone, монтирование, синхронизация и бэкапы сайта

Настройка Google Drive в Linux через rclone: подключение, монтирование, синхронизация и автоматические бэкапы сайта. Практическое руководство для разработчиков.

8 мин

PHP-сайт падает под нагрузкой: как найти причину и настроить PHP-FPM

Как найти причину ошибок 502 и 504 под нагрузкой, рассчитать pm.max_children, настроить OPcache и кеш nginx и проверить результат нагрузочным тестом.

8 мин

Авторизация по SSH-ключу с паролем и по логину с паролем: в чём разница

Разбираем разницу между входом по SSH-ключу с парольной фразой и обычной авторизацией по логину и паролю. Защита, сценарии взлома и настройка для PHP-разработчика.

5 мин