Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_core_module.xml @ 436:3a9f39341c7c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
- Documented the "from" parameter of the "disable_symlinks" directive, and that read permissions on intermediate directories are no longer required on OSes that support opening directories for searching. - Improved documentation of $document_root and $realpath_root.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 29 Feb 2012 13:25:22 +0000
parents 0412333658fe
children b27974b92a58
comparison
equal deleted inserted replaced
435:338c5aa982f8 436:3a9f39341c7c
452 452
453 </directive> 453 </directive>
454 454
455 455
456 <directive name="disable_symlinks"> 456 <directive name="disable_symlinks">
457 <syntax><literal>off</literal></syntax>
457 <syntax> 458 <syntax>
458 <literal>on</literal> | 459 <literal>on</literal> |
459 <literal>off</literal> | 460 <literal>if_not_owner</literal>
460 <literal>if_not_owner</literal></syntax> 461 [<literal>from</literal>=<value>префикс</value>]</syntax>
461 <default>off</default> 462 <default>off</default>
462 <context>http</context> 463 <context>http</context>
463 <context>server</context> 464 <context>server</context>
464 <context>location</context> 465 <context>location</context>
465 <appeared-in>1.1.15</appeared-in> 466 <appeared-in>1.1.15</appeared-in>
469 при открытии файлов: 470 при открытии файлов:
470 <list type="tag"> 471 <list type="tag">
471 472
472 <tag-name><literal>off</literal></tag-name> 473 <tag-name><literal>off</literal></tag-name>
473 <tag-desc> 474 <tag-desc>
474 Символические ссылки в пути никак специально не обрабатываются. 475 Символические ссылки в пути допускаются и не проверяются.
475 Это стандартное поведение. 476 Это стандартное поведение.
476 </tag-desc> 477 </tag-desc>
477 478
478 <tag-name><literal>on</literal></tag-name> 479 <tag-name><literal>on</literal></tag-name>
479 <tag-desc> 480 <tag-desc>
482 </tag-desc> 483 </tag-desc>
483 484
484 <tag-name><literal>if_not_owner</literal></tag-name> 485 <tag-name><literal>if_not_owner</literal></tag-name>
485 <tag-desc> 486 <tag-desc>
486 Доступ к файлу запрещается, если любой компонент пути 487 Доступ к файлу запрещается, если любой компонент пути
487 является символической ссылкой, и ссылка и объект, на 488 является символической ссылкой, а ссылка и объект, на
488 который она ссылается, имеют разных владельцев. 489 который она ссылается, имеют разных владельцев.
489 </tag-desc> 490 </tag-desc>
490 491
492 <tag-name><literal>from</literal>=<value>префикс</value></tag-name>
493 <tag-desc>
494 При проверке символических ссылок
495 (параметры <literal>on</literal> и <literal>if_not_owner</literal>)
496 обычно проверяется каждый элемент пути.
497 Однако если дополнительно указан параметр
498 <literal>from</literal>=<value>префикс</value>,
499 символические ссылки проверяются лишь начиная с элемента пути,
500 заданного префиксом.
501 В значении префикса можно использовать переменные.
502 Если значение не является префиксом проверяемого пути,
503 путь проверяется целиком, как если бы этот параметр не был указан вовсе.
504 </tag-desc>
505
491 </list> 506 </list>
507 </para>
508
509 <para>
510 Пример:
511 <example>
512 disable_symlinks on from=$document_root;
513 </example>
492 </para> 514 </para>
493 515
494 <para> 516 <para>
495 Эта директива доступна только на системах, в которых есть 517 Эта директива доступна только на системах, в которых есть
496 интерфейсы <c-func>openat</c-func> и <c-func>fstatat</c-func>. 518 интерфейсы <c-func>openat</c-func> и <c-func>fstatat</c-func>.
498 </para> 520 </para>
499 521
500 <para> 522 <para>
501 Параметры <literal>on</literal> и <literal>if_not_owner</literal> 523 Параметры <literal>on</literal> и <literal>if_not_owner</literal>
502 требуют дополнительных затрат на обработку. 524 требуют дополнительных затрат на обработку.
503 Кроме того, 525 <note>
526 На системах, не поддерживающих операцию открытия каталогов только для поиска,
504 использование этих параметров требует, чтобы 527 использование этих параметров требует, чтобы
505 рабочие процессы имели возможность читать все 528 рабочие процессы имели возможность читать все
506 промежуточные каталоги. 529 промежуточные каталоги.
530 </note>
531
507 </para> 532 </para>
508 533
509 </directive> 534 </directive>
510 535
511 536
2550 cookie <value>имя</value> 2575 cookie <value>имя</value>
2551 </tag-desc> 2576 </tag-desc>
2552 2577
2553 <tag-name><var>$document_root</var></tag-name> 2578 <tag-name><var>$document_root</var></tag-name>
2554 <tag-desc> 2579 <tag-desc>
2555 значение директивы <link id="root"/> для текущего запроса 2580 значение директивы <link id="root"/> или <link id="alias"/>
2581 для текущего запроса
2556 </tag-desc> 2582 </tag-desc>
2557 2583
2558 <tag-name><var>$document_uri</var></tag-name> 2584 <tag-name><var>$document_uri</var></tag-name>
2559 <tag-desc> 2585 <tag-desc>
2560 то же, что и <var>$uri</var> 2586 то же, что и <var>$uri</var>
2609 то же, что и <var>$args</var> 2635 то же, что и <var>$args</var>
2610 </tag-desc> 2636 </tag-desc>
2611 2637
2612 <tag-name><var>$realpath_root</var></tag-name> 2638 <tag-name><var>$realpath_root</var></tag-name>
2613 <tag-desc> 2639 <tag-desc>
2614 значение директивы <link id="root"/> для текущего запроса, 2640 абсолютный путь, соответствующий
2615 при этом все символические ссылки преобразованы в реальные путь 2641 значению директивы <link id="root"/> или <link id="alias"/>
2642 для текущего запроса,
2643 в котором все символические ссылки преобразованы в реальные пути
2616 </tag-desc> 2644 </tag-desc>
2617 2645
2618 <tag-name><var>$remote_addr</var></tag-name> 2646 <tag-name><var>$remote_addr</var></tag-name>
2619 <tag-desc> 2647 <tag-desc>
2620 адрес клиента 2648 адрес клиента