Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_core_module.xml @ 436:3a9f39341c7c
- 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 адрес клиента |