Mercurial > hg > nginx-site

comparison xml/en/docs/njs/reference.xml @ 2340:537130c40c1f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated r.subrequest desctiption in njs.
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 27 Feb 2019 20:25:42 +0300
parents 39ac205f90b7
children ea8ccaac18b4
comparison
equal deleted inserted replaced
2339:a72bd8324c0b 2340:537130c40c1f
7 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd"> 7 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd">
8 8
9 <article name="Reference" 9 <article name="Reference"
10 link="/en/docs/njs/reference.html" 10 link="/en/docs/njs/reference.html"
11 lang="en" 11 lang="en"
12 rev="22"> 12 rev="23">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 <link doc="index.xml">njs</link> provides objects, methods and properties 17 <link doc="index.xml">njs</link> provides objects, methods and properties
168 <value>options</value>[, <value>callback</value>]])</literal></tag-name> 168 <value>options</value>[, <value>callback</value>]])</literal></tag-name>
169 <tag-desc> 169 <tag-desc>
170 creates a subrequest with the given <literal>uri</literal> and 170 creates a subrequest with the given <literal>uri</literal> and
171 <literal>options</literal>, and installs 171 <literal>options</literal>, and installs
172 an optional completion <literal>callback</literal>. 172 an optional completion <literal>callback</literal>.
173
174 <para>
175 A
176 <link doc="../dev/development_guide.xml.xml" id="http_subrequests">subrequest</link>
177 shares its input headers with the client request.
178 To send headers different from original headers to a proxied server, the
179 <link doc="../http/ngx_http_proxy_module.xml" id="proxy_set_header"/>
180 directive can be used.
181 To send a completely new set of headers to a proxied server, the
182 <link doc="../http/ngx_http_proxy_module.xml" id="proxy_pass_request_headers"/>
183 directive can be used.
184 </para>
173 185
174 <para> 186 <para>
175 If <literal>options</literal> is a string, then it 187 If <literal>options</literal> is a string, then it
176 holds the subrequest arguments string. 188 holds the subrequest arguments string.
177 Otherwise, <literal>options</literal> is expected to be 189 Otherwise, <literal>options</literal> is expected to be