comparison xml/ru/docs/njs/reference.xml @ 2543:f39c4724c0f8

Described multi-value headers in r.headersIn.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 19 May 2020 15:05:49 +0100
parents d6bbfd20c82f
children 33347df1da9c
comparison
equal deleted inserted replaced
2542:bde7cd9a1173 2543:f39c4724c0f8
52 52
53 <tag-name id="r_headers_in"><literal>r.headersIn{}</literal></tag-name> 53 <tag-name id="r_headers_in"><literal>r.headersIn{}</literal></tag-name>
54 <tag-desc> 54 <tag-desc>
55 объект входящих заголовков, только чтение. 55 объект входящих заголовков, только чтение.
56 <para> 56 <para>
57 Например, доступ к заголовку <literal>Foo</literal> 57 Доступ к заголовку запроса <literal>Foo</literal>
58 можно получить при помощи синтаксиса <literal>headersIn.foo</literal> 58 можно получить при помощи синтаксиса:
59 или <literal>headersIn['Foo']</literal> 59 <literal>headersIn.foo</literal> или <literal>headersIn['Foo']</literal>.
60 <note> 60 </para>
61 До версии <link doc="changes.xml" id="njs0.3.6">0.3.6</link> 61
62 если заголовок был указан несколько раз, например 62 <para>
63 <header>Cookie</header> или <header>X-Forwarded-For</header>, 63 Заголовки запроса
64 то возвращалось только первое значение. 64 <header>Authorization</header>,
65 Чтобы получить все cookie 65 <header>Content-Length</header>,
66 необходимо использовать 66 <header>Content-Range</header>,
67 <literal>r.variables.http_cookie</literal>. 67 <header>Content-Type</header>,
68 Чтобы получить <literal>имя</literal> cookie 68 <header>ETag</header>,
69 необходимо использовать 69 <header>Expect</header>,
70 <literal>r.variables["cookie_<value>имя</value>"]</literal>. 70 <header>From</header>,
71 </note> 71 <header>Host</header>,
72 <header>If-Match</header>,
73 <header>If-Modified-Since</header>,
74 <header>If-None-Match</header>,
75 <header>If-Range</header>,
76 <header>If-Unmodified-Since</header>,
77 <header>Max-Forwards</header>,
78 <header>Proxy-Authorization</header>,
79 <header>Referer</header>,
80 <header>Transfer-Encoding</header> и
81 <header>User-Agent</header>
82 могут иметь только одно значение поля
83 (<link doc="changes.xml" id="njs0.4.1">0.4.1</link>).
84 Дубликаты значений поля в заголовке запроса <header>Cookie</header>
85 разделяются точкой с запятой (<literal>;</literal>).
86 Дубликаты значений поля во всех остальных заголовках запроса
87 разделяются запятой.
72 </para> 88 </para>
73 </tag-desc> 89 </tag-desc>
74 90
75 <tag-name id="r_headers_out"><literal>r.headersOut{}</literal></tag-name> 91 <tag-name id="r_headers_out"><literal>r.headersOut{}</literal></tag-name>
76 <tag-desc> 92 <tag-desc>