log

log находит или открывает журнал, читает ограниченное начало или конец файла и фильтрует строки, не загружая растущий лог целиком в память.

ДиагностикаВерсия 1.3.1Стабильная
lil-terminal

Обзор

Используйте log для точечной диагностики: найдите нужный файл, выберите первые или последние строки и при необходимости отфильтруйте буквальный текст. Команда журнал не изменяет.

Сначала сузить журнал

Рабочие журналы постоянно растут и обычно содержат гораздо больше данных, чем нужно для одной диагностики. log удерживает задачу небольшой: найти файл, взять ограниченный фрагмент и применить фильтр. На виртуальном хостинге это быстрее и безопаснее, чем открывать большой журнал в редакторе.

Синтаксис

lil-terminal
log [<file>|<dir>] [-h] [-n <lines>] [-g <text>] [-i] [-l] [-r]

Справочник

log

показать самый новый найденный журнал

log <file>

прочитать выбранный файл журнала

log <dir>

найти журнал в указанном каталоге

log -l

показать найденные журналы

log <dir> -l

показать журналы внутри каталога

-h

читать с начала файла

-n <lines>

вывести от 1 до 50000 физических строк

-g <text>

оставить строки с буквальным фрагментом текста

-i

игнорировать регистр при использовании с -g

-r

показать исходные строки без группировки

Интерактивный пример из `/sandbox/`

Запускайте подготовленные примеры прямо на странице. Результат заранее сформирован и показывается в браузере; команды терминала на сервере не выполняются.

Найти журналы и прочитать короткий хвост

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Пакет Base

Установить полный пакет с локальной справкой и всеми опубликованными режимами.

install log
Пакет Minimum

Установить сокращённый пакет без локальной справки; help <cmd> -i открывает актуальную серверную справку.

install log -m
Точная публичная версия

Установить именно эту опубликованную версию.

install log -v 1.3.1
Проверить или обновить

Поручить upgrade проверить совместимость и заменить установленный блок только при необходимости.

upgrade log
Удалить модуль

Удалить блок расширения, не затрагивая ядро и остальные модули.

install log -u

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

Найти журналы и прочитать короткий хвост
log sandbox/logs/review.log
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log

[20-Oct-2026 08:00:00 UTC]
PHP Notice: request started in /sandbox/src/start.php on line 12

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Stack trace:
#0 /sandbox/src/index.php(20): loadSettings()

[20-Oct-2026 08:00:02 UTC]
PHP Debug: using fallback configuration

[20-Oct-2026 08:00:03 UTC]
PHP Fatal error: unable to initialize test connection in /sandbox/src/db.php on line 41
Stack trace:
#0 /sandbox/src/index.php(31): connect()
Читать с начала файла
log sandbox/logs/review.log -h
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log

[20-Oct-2026 08:00:00 UTC]
PHP Notice: request started in /sandbox/src/start.php on line 12

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Stack trace:
#0 /sandbox/src/index.php(20): loadSettings()

[20-Oct-2026 08:00:02 UTC]
PHP Debug: using fallback configuration

[20-Oct-2026 08:00:03 UTC]
PHP Fatal error: unable to initialize test connection in /sandbox/src/db.php on line 41
Stack trace:
#0 /sandbox/src/index.php(31): connect()
Прочитать выбранный файл журнала
log sandbox/logs/review.log -t
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log

[20-Oct-2026 08:00:00 UTC]
PHP Notice: request started in /sandbox/src/start.php on line 12

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Stack trace:
#0 /sandbox/src/index.php(20): loadSettings()

[20-Oct-2026 08:00:02 UTC]
PHP Debug: using fallback configuration

[20-Oct-2026 08:00:03 UTC]
PHP Fatal error: unable to initialize test connection in /sandbox/src/db.php on line 41
Stack trace:
#0 /sandbox/src/index.php(31): connect()
Вывести от 1 до 50000 физических строк
log sandbox/logs/review.log -n 2
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log

Stack trace:
#0 /sandbox/src/index.php(31): connect()
Вывести от 1 до 50000 физических строк
log sandbox/logs/review.log -h -n 2
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log

[20-Oct-2026 08:00:00 UTC]
PHP Notice: request started in /sandbox/src/start.php on line 12

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Оставить строки с буквальным фрагментом текста
log sandbox/logs/review.log -g Warning
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log
Filter: Warning

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Игнорировать регистр при использовании с -g
log sandbox/logs/review.log -g warning -i
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log
Filter: warning

[20-Oct-2026 08:00:01 UTC]
PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Обработать отсутствующий журнал
log sandbox/logs/review.log -g DEBUG
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log
Filter: DEBUG

[no matching lines]
Показать исходные строки без группировки
log sandbox/logs/review.log -g error -i -r
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log
Filter: error

[20-Oct-2026 08:00:03 UTC] PHP Fatal error: unable to initialize test connection in /sandbox/src/db.php on line 41
Показать исходные строки без группировки
log sandbox/logs/review.log -r
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log

[20-Oct-2026 08:00:00 UTC] PHP Notice: request started in /sandbox/src/start.php on line 12
[20-Oct-2026 08:00:01 UTC] PHP Warning: missing configuration in /sandbox/src/config.php on line 18
Stack trace:
#0 /sandbox/src/index.php(20): loadSettings()
[20-Oct-2026 08:00:02 UTC] PHP Debug: using fallback configuration
[20-Oct-2026 08:00:03 UTC] PHP Fatal error: unable to initialize test connection in /sandbox/src/db.php on line 41
Stack trace:
#0 /sandbox/src/index.php(31): connect()
Показать найденные журналы
log -l
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
2026-11-01 12:00:00	96 B	sandbox/logs/app.log
2026-11-01 12:00:00	219 B	sandbox/logs/errors.log
2026-10-20 08:00:00	487 B	sandbox/logs/review.log
Показать журналы внутри каталога
log sandbox -l
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
2026-11-01 12:00:00	96 B	sandbox/logs/app.log
2026-11-01 12:00:00	219 B	sandbox/logs/errors.log
2026-10-20 08:00:00	487 B	sandbox/logs/review.log
Найти журнал в указанном каталоге
log sandbox
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/app.log

2026-01-01T00:00:00Z INFO sandbox initialized

2026-01-01T00:00:01Z DEBUG sample event completed
Оставить строки с буквальным фрагментом текста
log sandbox/logs/review.log -g no-such-event
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
File: sandbox/logs/review.log
Filter: no-such-event

[no matching lines]
Прочитать выбранный файл журнала
log sandbox/logs/missing.log
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
Log file not found
Вывести от 1 до 50000 физических строк
log sandbox/logs/review.log -n 0
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
Line count must be between 1 and 50000
Вывести от 1 до 50000 физических строк
log sandbox/logs/review.log -n 50001
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
Line count must be between 1 and 50000
Вывести от 1 до 50000 физических строк
log sandbox/logs/review.log -n abc
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
Invalid line count
Игнорировать регистр при использовании с -g
log sandbox/logs/review.log -i
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
Option -i requires -g <text>
Оставить строки с буквальным фрагментом текста
log sandbox/logs/review.log -g
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
Search text is required
Прочитать выбранный файл журнала
log sandbox/logs/review.log -z
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
Unknown option: -z
Прочитать выбранный файл журнала
log sandbox/logs/review.log -l
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
List mode accepts a directory, not a file
Оставить строки с буквальным фрагментом текста
log sandbox -l -g error
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
List mode does not accept a search filter
Прочитать выбранный файл журнала
log sandbox/logs/review.log sandbox/logs/review.log
Учебный пример — окружение PHP, сервер и ответы репозитория смоделированы
Too many paths

Файл из примера: sandbox/logs/app.log

Пример использует файл или каталог из защищённой учебной папки /sandbox/.

2026-01-01T00:00:00Z INFO sandbox initialized
2026-01-01T00:00:01Z DEBUG sample event completed

Связанная документация

Какие требования к серверу? →Почему ограничены большие файлы и объём вывода? →

Текущая публичная версия

v1.3.12026-10-31

Производственная доработка

Актуальная стабильная версия log. log находит или открывает журнал, читает ограниченное начало или конец файла и фильтрует строки, не загружая растущий лог целиком в память.

# История версий