Mercurial > hg > nginx-site
diff xml/ru/docs/http/ngx_http_log_module.xml @ 2540:b686736680e3
Documented escaping rules in log_format.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 12 May 2020 22:06:12 +0100 |
parents | 64004f50b9dd |
children | eeed494bba51 |
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_log_module.xml +++ b/xml/ru/docs/http/ngx_http_log_module.xml @@ -10,7 +10,7 @@ <module name="Модуль ngx_http_log_module" link="/ru/docs/http/ngx_http_log_module.html" lang="ru" - rev="19"> + rev="20"> <section id="summary"> @@ -209,6 +209,31 @@ access_log /path/to/access.log combined экранирование символов. </para> +<para id="log_format_escape_default"> +При использовании <literal>default</literal> +символы “<literal>"</literal>”, “<literal>\</literal>”, +a также символы со значениями меньше 32 (0.7.0) или больше 126 (1.1.6) +экранируются как “<literal>\xXX</literal>”. +Если значение переменной не найдено, +то в качестве значения в лог будет записываться дефис (“<literal>-</literal>”). +</para> + +<para id="log_format_escape_json"> +При использовании <literal>json</literal> +экранируются все символы, недопустимые +в JSON <link url="https://tools.ietf.org/html/rfc8259#section-7">строках</link>: +символы “<literal>"</literal>” и +“<literal>\</literal>” экранируются как +“<literal>\"</literal>” и “<literal>\\</literal>”, +символы со значениями меньше 32 экранируются как +“<literal>\n</literal>”, +“<literal>\r</literal>”, +“<literal>\t</literal>”, +“<literal>\b</literal>”, +“<literal>\f</literal>” или +“<literal>\u00XX</literal>”. +</para> + <para> Кроме общих переменных в формате можно использовать переменные, существующие только на момент записи в лог: