Mercurial > hg > nginx-site
changeset 2441:080581ce888d
Added note to r.headersIn in njs Reference.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Mon, 07 Oct 2019 14:41:16 +0300 |
parents | 7a353370ffcd |
children | 437350febcb7 |
files | xml/en/docs/njs/reference.xml xml/ru/docs/njs/reference.xml |
diffstat | 2 files changed, 23 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/njs/reference.xml +++ b/xml/en/docs/njs/reference.xml @@ -9,7 +9,7 @@ <article name="Reference" link="/en/docs/njs/reference.html" lang="en" - rev="30"> + rev="31"> <section id="summary"> @@ -56,6 +56,17 @@ incoming headers object, read-only. For example, the <literal>Foo</literal> header can be accessed with the syntax <literal>headersIn.foo</literal> or <literal>headersIn['Foo']</literal> +<note> +For headers that can appear multiple times such as +<header>Cookie</header> or <header>X-Forwarded-For</header>, +only the first value will be returned. +To get all cookies, +<literal>r.variables.http_cookie</literal> +should be used. +To get the <literal>name</literal> cookie, +<literal>r.variables["cookie_<value>name</value>"]</literal> +should be used. +</note> </para> </tag-desc>
--- a/xml/ru/docs/njs/reference.xml +++ b/xml/ru/docs/njs/reference.xml @@ -57,6 +57,17 @@ Например, доступ к заголовку <literal>Foo</literal> можно получить при помощи синтаксиса <literal>headersIn.foo</literal> или <literal>headersIn['Foo']</literal> +<note> +Если заголовок может быть указан несколько раз, например +<header>Cookie</header> или <header>X-Forwarded-For</header>, +будет возвращено только первое значение. +Чтобы получить все cookie +необходимо использовать +<literal>r.variables.http_cookie</literal>. +Чтобы получить <literal>имя</literal> cookie +необходимо использовать +<literal>r.variables["cookie_<value>имя</value>"]</literal>. +</note> </para> </tag-desc>