comparison xml/ru/docs/http/ngx_http_core_module.xml @ 438:b27974b92a58

- corrected the description of the from= parameter of the disable_symlinks directive, added a note about modules that do not currently respect this directive - mentioned that ngx_http_addition_module's directives also make internal requests
author Ruslan Ermilov <ru@nginx.com>
date Thu, 01 Mar 2012 16:46:47 +0000
parents 3a9f39341c7c
children b423d725a932
comparison
equal deleted inserted replaced
437:fd183bec1830 438:b27974b92a58
456 <directive name="disable_symlinks"> 456 <directive name="disable_symlinks">
457 <syntax><literal>off</literal></syntax> 457 <syntax><literal>off</literal></syntax>
458 <syntax> 458 <syntax>
459 <literal>on</literal> | 459 <literal>on</literal> |
460 <literal>if_not_owner</literal> 460 <literal>if_not_owner</literal>
461 [<literal>from</literal>=<value>префикс</value>]</syntax> 461 [<literal>from</literal>=<value>часть</value>]</syntax>
462 <default>off</default> 462 <default>off</default>
463 <context>http</context> 463 <context>http</context>
464 <context>server</context> 464 <context>server</context>
465 <context>location</context> 465 <context>location</context>
466 <appeared-in>1.1.15</appeared-in> 466 <appeared-in>1.1.15</appeared-in>
487 Доступ к файлу запрещается, если любой компонент пути 487 Доступ к файлу запрещается, если любой компонент пути
488 является символической ссылкой, а ссылка и объект, на 488 является символической ссылкой, а ссылка и объект, на
489 который она ссылается, имеют разных владельцев. 489 который она ссылается, имеют разных владельцев.
490 </tag-desc> 490 </tag-desc>
491 491
492 <tag-name><literal>from</literal>=<value>префикс</value></tag-name> 492 <tag-name><literal>from</literal>=<value>часть</value></tag-name>
493 <tag-desc> 493 <tag-desc>
494 При проверке символических ссылок 494 При проверке символических ссылок
495 (параметры <literal>on</literal> и <literal>if_not_owner</literal>) 495 (параметры <literal>on</literal> и <literal>if_not_owner</literal>)
496 обычно проверяется каждый элемент пути. 496 обычно проверяются все компоненты пути.
497 Однако если дополнительно указан параметр 497 Можно не проверять символические ссылки в начальной части пути,
498 <literal>from</literal>=<value>префикс</value>, 498 указав дополнительно параметр
499 символические ссылки проверяются лишь начиная с элемента пути, 499 <literal>from</literal>=<value>часть</value>.
500 заданного префиксом. 500 В этом случае символические ссылки проверяются лишь начиная
501 В значении префикса можно использовать переменные. 501 с компонента пути, который следует за заданной начальной частью.
502 Если значение не является префиксом проверяемого пути, 502 Если значение не является начальной частью проверяемого пути,
503 путь проверяется целиком, как если бы этот параметр не был указан вовсе. 503 путь проверяется целиком, как если бы этот параметр не был указан вовсе.
504 Если значение целиком совпадает с именем файла,
505 символические ссылки не проверяются.
506 В значении параметра можно использовать переменные.
504 </tag-desc> 507 </tag-desc>
505 508
506 </list> 509 </list>
507 </para> 510 </para>
508 511
522 <para> 525 <para>
523 Параметры <literal>on</literal> и <literal>if_not_owner</literal> 526 Параметры <literal>on</literal> и <literal>if_not_owner</literal>
524 требуют дополнительных затрат на обработку. 527 требуют дополнительных затрат на обработку.
525 <note> 528 <note>
526 На системах, не поддерживающих операцию открытия каталогов только для поиска, 529 На системах, не поддерживающих операцию открытия каталогов только для поиска,
527 использование этих параметров требует, чтобы 530 использование этих параметров требует, чтобы рабочие процессы
528 рабочие процессы имели возможность читать все 531 имели право читать все проверяемые каталоги.
529 промежуточные каталоги.
530 </note> 532 </note>
531 533 </para>
534
535 <para>
536 <note>
537 Модули
538 <link doc="ngx_http_autoindex_module.xml">ngx_http_autoindex_module</link>,
539 <link doc="ngx_http_random_index_module.xml">ngx_http_random_index_module</link>
540 и <link doc="ngx_http_dav_module.xml">ngx_http_dav_module.xml</link>
541 в настоящий момент игнорируют эту директиву.
542 </note>
532 </para> 543 </para>
533 544
534 </directive> 545 </directive>
535 546
536 547
688 699
689 <listitem> 700 <listitem>
690 подзапросы, формируемые командой 701 подзапросы, формируемые командой
691 “<command>include virtual</command>” 702 “<command>include virtual</command>”
692 модуля 703 модуля
693 <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>; 704 <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>
705 и директивами модуля
706 <link doc="ngx_http_addition_module.xml">ngx_http_addition_module</link>;
694 </listitem> 707 </listitem>
695 708
696 <listitem> 709 <listitem>
697 запросы, изменённые директивой 710 запросы, изменённые директивой
698 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>. 711 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/>.