Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 417:cbc2d1b51cb6
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<sl_domain>[-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> |