HttpAdditionModuleJa

= 概要 = このモジュールは、現在のロケーションのコンテンツの先頭もしくは末尾に別のロケーションのコンテンツを追加します.

これは、出力フィルタとして実装されており、メインのリクエストと、別のロケーションに対するサブリクエストのコンテンツは一切バッファリングされず、ストリーミング形式でクライアントに送られます. 最終的なレスポンスボディ長が、HTTPヘッダを送信する際に不明であるため、HTTP chunked encodingが常時に用いられます.

インストール
デフォルトでは、このモジュールはビルドされません. このモジュールをビルドで有効にする際には、コンパイル時に次のようにします: ./configure --with-http_addition_module

設定例: location / { add_before_body  /before_action; add_after_body   /after_action; }

制限事項
Note that as of 0.8.17 no contents will be added if the current location is served as a subrequest itself. Consider the following example:

location /foo { add_before_body /bar; }

location /bar { add_before_body /baz; }

Then accessing /foo won't get /baz inserted before the contents of the subrequest /bar.

Also note that at this time, only strings can be used in before/after body locations, not variables. So, location / { set $before_action /before_action; add_before_body $before_action; }

will not work as expected (although the configuration file will still load properly).

= Directives =

add_before_body


uri のコンテンツをレスポンスボディの先頭に追加します. Directive adds content of uri before the response body, issued as a result of the work of the assigned subrequest.

add_after_body


uri のコンテンツをレスポンスボディの末尾に追加します. Directive adds content of uri after the response body, issued as a result of the work of the assigned subrequest.

addition_types


このディレクティブ（0.7.9以降）により、指定した MIME タイプ（デフォルトは "text/html"）のロケーション（コンテンツ）に対してのみ、テキストを追加します.

（0.8.17以前では、このディレクティブのスペルが "addtion_types" と誤っていました. このバグは 0.8.17 で修正されました）

= References = Original Documentation