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 可以发现或打开日志文件，读取受限的开头或结尾，并在不把持续增长的日志全部载入内存的情况下过滤行。

# 版本历史