Changeset 2118:0b3103eabdf1 in nginx_org


Ignore:
Timestamp:
03/20/18 18:03:28 (2 years ago)
Author:
Yaroslav Zhuravlev <yar@…>
Branch:
default
Phase:
public
Message:

Documented the "subrequest_output_buffer_size" directive.

Location:
xml
Files:
4 edited

Legend:

Unmodified
Added
Removed
  • xml/en/docs/http/ngx_http_core_module.xml

    r2039 r2118  
    1111        link="/en/docs/http/ngx_http_core_module.html"
    1212        lang="en"
    13         rev="74">
     13        rev="75">
    1414
    1515<section id="directives" name="Directives">
     
    25712571
    25722572
     2573<directive name="subrequest_output_buffer_size">
     2574<syntax><value>size</value></syntax>
     2575<default>4k|8k</default>
     2576<context>http</context>
     2577<context>server</context>
     2578<context>location</context>
     2579<appeared-in>1.13.10</appeared-in>
     2580
     2581<para>
     2582Sets the <value>size</value> of the buffer used for
     2583storing the response body of a subrequest.
     2584By default, the buffer size is equal to one memory page.
     2585This is either 4K or 8K, depending on a platform.
     2586It can be made smaller, however.
     2587</para>
     2588
     2589<para>
     2590The directive is applicable only for subrequests
     2591with response bodies saved into memory.
     2592For example, such subrequests are created by
     2593<link doc="ngx_http_ssi_module.xml" id="ssi_include_set">SSI</link>.
     2594</para>
     2595
     2596</directive>
     2597
     2598
    25732599<directive name="tcp_nodelay">
    25742600<syntax><literal>on</literal> | <literal>off</literal></syntax>
  • xml/en/docs/http/ngx_http_ssi_module.xml

    r1875 r2118  
    1111        link="/en/docs/http/ngx_http_ssi_module.html"
    1212        lang="en"
    13         rev="8">
     13        rev="9">
    1414
    1515<section id="summary">
     
    359359</tag-desc>
    360360
    361 <tag-name><literal>set</literal></tag-name>
     361<tag-name id="ssi_include_set"><literal>set</literal></tag-name>
    362362<tag-desc>
    363363a non-standard parameter that instructs to write a successful result
     
    367367&lt;!--# include virtual="/remote/body.php?argument=value" set="one" --&gt;
    368368</example>
    369 It should be noted that only the results of responses obtained using the
     369The maximum size of the response is set by the
     370<link doc="ngx_http_core_module.xml" id="subrequest_output_buffer_size"/>
     371value in the target location (1.13.10).
     372<para>
     373Prior to version 1.13.10, only the results of responses obtained using the
    370374<link doc="ngx_http_proxy_module.xml">ngx_http_proxy_module</link>,
    371375<link doc="ngx_http_memcached_module.xml">ngx_http_memcached_module</link>,
     
    373377<link doc="ngx_http_uwsgi_module.xml">ngx_http_uwsgi_module</link> (1.5.6),
    374378and <link doc="ngx_http_scgi_module.xml">ngx_http_scgi_module</link> (1.5.6)
    375 modules can be written into variables.
     379modules could be written into variables.
     380The maximum size of the response was set with the
     381<link doc="ngx_http_proxy_module.xml" id="proxy_buffer_size"/>,
     382<link doc="ngx_http_memcached_module.xml" id="memcached_buffer_size"/>,
     383<link doc="ngx_http_fastcgi_module.xml" id="fastcgi_buffer_size"/>,
     384<link doc="ngx_http_uwsgi_module.xml" id="uwsgi_buffer_size"/>,
     385and <link doc="ngx_http_scgi_module.xml" id="scgi_buffer_size"/>
     386directives.
     387</para>
    376388</tag-desc>
    377389
  • xml/ru/docs/http/ngx_http_core_module.xml

    r2039 r2118  
    1111        link="/ru/docs/http/ngx_http_core_module.html"
    1212        lang="ru"
    13         rev="74">
     13        rev="75">
    1414
    1515<section id="directives" name="Директивы">
     
    25742574
    25752575
     2576<directive name="subrequest_output_buffer_size">
     2577<syntax><value>размер</value></syntax>
     2578<default>4k|8k</default>
     2579<context>http</context>
     2580<context>server</context>
     2581<context>location</context>
     2582<appeared-in>1.13.10</appeared-in>
     2583
     2584<para>
     2585Задаёт <value>размер</value> буфера, используемого для
     2586хранения тела ответа подзапроса.
     2587По умолчанию размер одного буфера равен размеру страницы памяти.
     2588В зависимости от платформы это или 4K, или 8K,
     2589однако его можно сделать меньше.
     2590</para>
     2591
     2592<para>
     2593Директива применима только для подзапросов,
     2594тело ответа которых сохраняется в памяти.
     2595Например, подобные подзапросы создаются при помощи
     2596<link doc="ngx_http_ssi_module.xml" id="ssi_include_set">SSI</link>.
     2597</para>
     2598
     2599</directive>
     2600
     2601
    25762602<directive name="tcp_nodelay">
    25772603<syntax><literal>on</literal> | <literal>off</literal></syntax>
  • xml/ru/docs/http/ngx_http_ssi_module.xml

    r1875 r2118  
    1111        link="/ru/docs/http/ngx_http_ssi_module.html"
    1212        lang="ru"
    13         rev="8">
     13        rev="9">
    1414
    1515<section id="summary">
     
    363363</tag-desc>
    364364
    365 <tag-name><literal>set</literal></tag-name>
     365<tag-name id="ssi_include_set"><literal>set</literal></tag-name>
    366366<tag-desc>
    367367нестандартный параметр, указывающий, что удачный
     
    371371&lt;!--# include virtual="/remote/body.php?argument=value" set="one" --&gt;
    372372</example>
    373 Необходимо учитывать, что в переменные можно записать только результаты
     373Максимальный размер ответа задаётся значением
     374<link doc="ngx_http_core_module.xml" id="subrequest_output_buffer_size"/>
     375в целевом location (1.13.10).
     376<para>
     377До версии 1.13.10 в переменные можно было записать только результаты
    374378ответов, полученные через модули
    375379<link doc="ngx_http_proxy_module.xml">ngx_http_proxy_module</link>,
     
    378382<link doc="ngx_http_uwsgi_module.xml">ngx_http_uwsgi_module</link> (1.5.6)
    379383и <link doc="ngx_http_scgi_module.xml">ngx_http_scgi_module</link> (1.5.6).
     384Максимальный размер ответа задавался при помощи директив
     385<link doc="ngx_http_proxy_module.xml" id="proxy_buffer_size"/>,
     386<link doc="ngx_http_memcached_module.xml" id="memcached_buffer_size"/>,
     387<link doc="ngx_http_fastcgi_module.xml" id="fastcgi_buffer_size"/>,
     388<link doc="ngx_http_uwsgi_module.xml" id="uwsgi_buffer_size"/>
     389и <link doc="ngx_http_scgi_module.xml" id="scgi_buffer_size"/>.
     390</para>
    380391</tag-desc>
    381392
Note: See TracChangeset for help on using the changeset viewer.