Skip to content

Latest commit

 

History

History
42 lines (23 loc) · 1.94 KB

print.md

File metadata and controls

42 lines (23 loc) · 1.94 KB

print

语法: print(...)

环境: init_by_lua*, init_worker_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua, log_by_lua*, ngx.timer.*

将参数值以 ngx.NOTICE 日志级别写入 nginx 的 error.log 文件。 Writes argument values into the nginx error.log file with the ngx.NOTICE log level.

等同于

 ngx.log(ngx.NOTICE, ...)

Lua 的 nil 值输出 "nil" 字符串,Lua 的布尔值输出 "true""false" 字符串。ngx.null 常量输出为 "null" 字符串。

在 Nginx 内核中硬编码限制了单条错误信息最长为 2048 字节。这个长度包含了最后的换行符和开始的时间戳。如果信息长度超过这个限制,Nginx 将把信息文本截断。这个限制可以通过修改 Nginx 源码中 src/core/ngx_log.h 文件中的 NGX_MAX_ERROR_STR 宏定义调整。

English Source

syntax: print(...)

context: init_by_lua*, init_worker_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua, log_by_lua*, ngx.timer.*

Writes argument values into the nginx error.log file with the ngx.NOTICE log level.

It is equivalent to

 ngx.log(ngx.NOTICE, ...)

Lua nil arguments are accepted and result in literal "nil" strings while Lua booleans result in literal "true" or "false" strings. And the ngx.null constant will yield the "null" string output.

There is a hard coded 2048 byte limitation on error message lengths in the Nginx core. This limit includes trailing newlines and leading time stamps. If the message size exceeds this limit, Nginx will truncate the message text accordingly. This limit can be manually modified by editing the NGX_MAX_ERROR_STR macro definition in the src/core/ngx_log.h file in the Nginx source tree.

返回目录