Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 417:cbc2d1b51cb6

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the proxy_cookie_domain and proxy_cookie_path directives.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 15 Feb 2012 21:44:31 +0000
parents 781b23ba3b0a
children 695f83494c19
comparison
equal deleted inserted replaced
416:c9c0550465c9 417:cbc2d1b51cb6
372 </para> 372 </para>
373 373
374 </directive> 374 </directive>
375 375
376 376
377 <directive name="proxy_cookie_domain">
378 <syntax><literal>off</literal></syntax>
379 <syntax><value>домен</value> <value>замена</value></syntax>
380 <default>off</default>
381 <context>http</context>
382 <context>server</context>
383 <context>location</context>
384 <appeared-in>1.1.15</appeared-in>
385
386 <para>
387 Задаёт текст, который нужно изменить в атрибуте <literal>domain</literal>
388 полей <header>Set-Cookie</header> заголовка ответа проксируемого сервера.
389 Предположим, проксируемый сервер вернул поле заголовка
390 <header>Set-Cookie</header> с атрибутом
391 “<literal>domain=localhost</literal>”.
392 Директива
393 <example>
394 proxy_cookie_domain localhost example.org;
395 </example>
396 перепишет данный атрибут в виде
397 “<literal>domain=example.org</literal>”.
398 </para>
399
400 <para>
401 Точка в начале строк <value>домен</value> и <value>замена</value>,
402 а равно как и в атрибуте <literal>domain</literal> игнорируется.
403 Регистр значения не имеет.
404 </para>
405
406 <para>
407 В строках <value>домен</value> и <value>замена</value> можно использовать
408 переменные:
409 <example>
410 proxy_cookie_domain www.$host $host;
411 </example>
412 </para>
413
414 <para>
415 Директиву также можно задать при помощи регулярных выражений.
416 При этом <value>домен</value> должен начинаться с символа
417 “<literal>~</literal>”.
418 Регулярное выражение может содержать именованные и позиционные выделения,
419 а <value>замена</value> ссылаться на них:
420 <example>
421 proxy_cookie_domain ~\.(?P&lt;sl_domain&gt;[-0-9a-z]+\.[a-z]+)$ $sl_domain;
422 </example>
423 </para>
424
425 <para>
426 Директив <literal>proxy_cookie_domain</literal> может быть несколько:
427 <example>
428 proxy_cookie_domain localhost example.org;
429 proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1;
430 </example>
431 </para>
432
433 <para>
434 Параметр <literal>off</literal> запрещает все директивы
435 <literal>proxy_cookie_domain</literal>
436 на данном уровне:
437 <example>
438 proxy_cookie_domain off;
439 proxy_cookie_domain localhost example.org;
440 proxy_cookie_domain www.example.org example.org;
441 </example>
442 </para>
443
444 </directive>
445
446
447 <directive name="proxy_cookie_path">
448 <syntax><literal>off</literal></syntax>
449 <syntax><value>путь</value> <value>замена</value></syntax>
450 <default>off</default>
451 <context>http</context>
452 <context>server</context>
453 <context>location</context>
454 <appeared-in>1.1.15</appeared-in>
455
456 <para>
457 Задаёт текст, который нужно изменить в атрибуте <literal>path</literal>
458 полей <header>Set-Cookie</header> заголовка ответа проксируемого сервера.
459 Предположим, проксируемый сервер вернул поле заголовка
460 <header>Set-Cookie</header> с атрибутом
461 “<literal>path=/two/some/uri/</literal>”.
462 Директива
463 <example>
464 proxy_cookie_path /two/ /;
465 </example>
466 перепишет данный атрибут в виде
467 “<literal>path=/some/uri/</literal>”.
468 </para>
469
470 <para>
471 В строках <value>путь</value> и <value>замена</value> можно использовать
472 переменные:
473 <example>
474 proxy_cookie_path $uri /some$uri;
475 </example>
476 </para>
477
478 <para>
479 Директиву также можно задать при помощи регулярных выражений.
480 При этом <value>путь</value> должен начинаться либо с символа
481 “<literal>~</literal>”, если при сравнении следует учитывать регистр символов,
482 либо с символов “<literal>~*</literal>”, если регистр символов учитывать
483 не нужно.
484 Регулярное выражение может содержать именованные и позиционные выделения,
485 а <value>замена</value> ссылаться на них:
486 <example>
487 proxy_cookie_path ~*^/user/([^/]+) /u/$1;
488 </example>
489 </para>
490
491 <para>
492 Директив <literal>proxy_cookie_path</literal> может быть несколько:
493 <example>
494 proxy_cookie_path /one/ /;
495 proxy_cookie_path / /two/;
496 </example>
497 </para>
498
499 <para>
500 Параметр <literal>off</literal> запрещает все директивы
501 <literal>proxy_cookie_path</literal>
502 на данном уровне:
503 <example>
504 proxy_cookie_path off;
505 proxy_cookie_path /two/ /;
506 proxy_cookie_path ~*^/user/([^/]+) /u/$1;
507 </example>
508 </para>
509
510 </directive>
511
512
377 <directive name="proxy_hide_header"> 513 <directive name="proxy_hide_header">
378 <syntax><value>поле</value></syntax> 514 <syntax><value>поле</value></syntax>
379 <default/> 515 <default/>
380 <context>http</context> 516 <context>http</context>
381 <context>server</context> 517 <context>server</context>