comparison xml/en/docs/http/ngx_http_core_module.xml @ 68:9de85defbcf8

- "optimize_server_names" is deprecated in favour of "server_name_in_redirects" - "resolver" can take hostname as an argument
author Ruslan Ermilov <ru@nginx.com>
date Sun, 09 Oct 2011 17:51:27 +0000
parents d98323a15ba4
children 935beaa561b3
comparison
equal deleted inserted replaced
67:d98323a15ba4 68:9de85defbcf8
1149 so it gets converted to <dq><code>/scripts/one.php</code></dq>. 1149 so it gets converted to <dq><code>/scripts/one.php</code></dq>.
1150 </para> 1150 </para>
1151 1151
1152 <para> 1152 <para>
1153 Turning the compression <value>off</value> can become necessary if a URI 1153 Turning the compression <value>off</value> can become necessary if a URI
1154 contains base64-encoded names, since base64 uses the "/" character internally. 1154 contains base64-encoded names, since base64 uses the “/” character internally.
1155 However, for security considerations, it is better to avoid turning off 1155 However, for security considerations, it is better to avoid turning off
1156 the compression. 1156 the compression.
1157 </para> 1157 </para>
1158 1158
1159 <para> 1159 <para>
1194 1194
1195 </directive> 1195 </directive>
1196 1196
1197 1197
1198 <directive name="open_file_cache"> 1198 <directive name="open_file_cache">
1199 <syntax>open_file_cache <value>off</value></syntax>
1199 <syntax>open_file_cache 1200 <syntax>open_file_cache
1200 <parameter>max</parameter>=<argument>N</argument> 1201 <parameter>max</parameter>=<argument>N</argument>
1201 [<parameter>inactive</parameter>=<argument>time</argument>] | 1202 [<parameter>inactive</parameter>=<argument>time</argument>]
1202 <value>off</value>
1203 </syntax> 1203 </syntax>
1204 <default>open_file_cache off</default> 1204 <default>open_file_cache off</default>
1205 <context>http</context> 1205 <context>http</context>
1206 <context>server</context> 1206 <context>server</context>
1207 <context>location</context> 1207 <context>location</context>
1217 <listitem> 1217 <listitem>
1218 directory lookups; 1218 directory lookups;
1219 </listitem> 1219 </listitem>
1220 1220
1221 <listitem> 1221 <listitem>
1222 file lookup errors, such as "file not found", "no read permission", 1222 file lookup errors, such as “file not found”, “no read permission”,
1223 and so on. 1223 and so on.
1224 Caching of errors should be enabled separately by the 1224 Caching of errors should be enabled separately by the
1225 <link id="open_file_cache_errors">open_file_cache_errors</link> 1225 <link id="open_file_cache_errors">open_file_cache_errors</link>
1226 directive. 1226 directive.
1227 </listitem> 1227 </listitem>
1243 1243
1244 <tag-name> 1244 <tag-name>
1245 <parameter>inactive</parameter> 1245 <parameter>inactive</parameter>
1246 </tag-name> 1246 </tag-name>
1247 <tag-desc> 1247 <tag-desc>
1248 defines a time, after which the element gets removed from the cache 1248 defines a time, after which an element gets removed from the cache
1249 if there were no accesses to it during this time; 1249 if there were no accesses to it during this time;
1250 by default, it is 60 seconds; 1250 by default, it is 60 seconds;
1251 </tag-desc> 1251 </tag-desc>
1252 1252
1253 <tag-name> 1253 <tag-name>
1282 <context>http</context> 1282 <context>http</context>
1283 <context>server</context> 1283 <context>server</context>
1284 <context>location</context> 1284 <context>location</context>
1285 1285
1286 <para> 1286 <para>
1287 Enables or disables caching of file lookup errors by the 1287 Enables or disables caching of file lookup errors by
1288 <link id="open_file_cache">open_file_cache</link>. 1288 <link id="open_file_cache">open_file_cache</link>.
1289 </para> 1289 </para>
1290 1290
1291 </directive> 1291 </directive>
1292 1292
1335 </directive> 1335 </directive>
1336 1336
1337 1337
1338 <directive name="open_file_cache_valid"> 1338 <directive name="open_file_cache_valid">
1339 <syntax>open_file_cache_valid <argument>time</argument></syntax> 1339 <syntax>open_file_cache_valid <argument>time</argument></syntax>
1340 <default>open_file_cache_valid 60</default> 1340 <default>open_file_cache_valid 60s</default>
1341 <context>http</context> 1341 <context>http</context>
1342 <context>server</context> 1342 <context>server</context>
1343 <context>location</context> 1343 <context>location</context>
1344 1344
1345 <para> 1345 <para>
1362 <default>optimize_server_names off</default> 1362 <default>optimize_server_names off</default>
1363 <context>http</context> 1363 <context>http</context>
1364 <context>server</context> 1364 <context>server</context>
1365 1365
1366 <para> 1366 <para>
1367 This directive is obsolete. 1367 This directive is made obsolete by the
1368 </para> 1368 <link id="server_name_in_redirect">server_name_in_redirect</link> directive.
1369 1369 </para>
1370
1371 <!--
1370 <para> 1372 <para>
1371 Enables or disables optimization of hostname checking in name-based 1373 Enables or disables optimization of hostname checking in name-based
1372 virtual servers. 1374 virtual servers.
1373 In particular, the checking affects hostnames used in redirects. 1375 In particular, the checking affects hostnames used in redirects.
1374 If optimization is enabled, and all name-based servers listening on 1376 If optimization is enabled, and all name-based servers listening on
1376 names are not checked during request processing, and the first 1378 names are not checked during request processing, and the first
1377 server name is used in redirects. 1379 server name is used in redirects.
1378 In case redirects should use hostnames sent by clients, 1380 In case redirects should use hostnames sent by clients,
1379 optimization needs to be disabled. 1381 optimization needs to be disabled.
1380 </para> 1382 </para>
1383 -->
1381 1384
1382 </directive> 1385 </directive>
1383 1386
1384 1387
1385 <directive name="port_in_redirect"> 1388 <directive name="port_in_redirect">
1477 <para> 1480 <para>
1478 Sets the <argument>address</argument> of a name server, for example: 1481 Sets the <argument>address</argument> of a name server, for example:
1479 <example> 1482 <example>
1480 resolver 127.0.0.1; 1483 resolver 127.0.0.1;
1481 </example> 1484 </example>
1485 An <argument>address</argument> may also be a hostname, in which case
1486 the first resolved address is used.
1482 </para> 1487 </para>
1483 1488
1484 </directive> 1489 </directive>
1485 1490
1486 1491
1574 </directive> 1579 </directive>
1575 1580
1576 1581
1577 <directive name="send_timeout"> 1582 <directive name="send_timeout">
1578 <syntax>send_timeout <argument>time</argument></syntax> 1583 <syntax>send_timeout <argument>time</argument></syntax>
1579 <default>send_timeout 60</default> 1584 <default>send_timeout 60s</default>
1580 <context>http</context> 1585 <context>http</context>
1581 <context>server</context> 1586 <context>server</context>
1582 <context>location</context> 1587 <context>location</context>
1583 1588
1584 <para> 1589 <para>