仕様書

構文

[11] CGI応答は、

• 1つ以上の頭欄
• NL
• 応答本体 (省略可能)

... の3つの部分により構成されます。あるいは CGI応答は次の3種類に分類できます。 >>6

• 文書応答
• 局所リダイレクト応答
• クライアントリダイレクト応答

CGI の頭欄

[304] CGI応答における頭欄は、

• [305] 鯖によって解釈されるCGI欄
• [306] プロトコルに依存する頭欄
  • [307] HTTP頭欄、SIP頭欄など

... の2種類に分けられます。詳しくはCGI欄の項をご覧ください。

      generic-field   = field-name ":" [ field-value ] NL
      field-name      = token
      field-value     = *( field-content | LWSP )
      field-content   = *( token | separator | quoted-string )

文書応答

[12] 文書応答 (document response) は、クライアントに対して文書を返すものです。 >>6

• [13] Content-Type: 欄は必須です
• [14] Status: 欄を指定することができます
• [15] その他の頭欄を指定することができます
• [16] 応答本体を指定することができます

[17] 鯖はCGI応答を適宜変形してクライアントとのプロトコルに適合するようにしなければなりません。 >>6

[324] Apache2 では Content-Type: は省略可能なようです。

局所リダイレクト応答

[19] 局所リダイレクト応答 (local redirect response) は、CGIスクリプトが指定した path に対するアクセスであったものとして再度鯖によって処理しなおすことを指示するものです。 >>6

• [20] Location: 欄は必須であり、 path からはじまる構文でなければなりません
• [21] それ以外の頭欄や応答本体を指定してはなりません

[22] 鯖は

      scheme "://" server-name ":" server-port local-pathquery

... という URL (local-pathquery が Location: 欄で指定された値) に要求があったものとして処理しなおさなければなりません。 >>6

[501] Apache2 では HTTP の頭欄が指定されていると、それがリダイレクト先の HTTP 応答頭欄に加えて応答に含まれます。複数段リダイレクトされているとそれらがすべて順に (後のものほど後に) 付加されていきます。

[328] Apache2 では >>23 は 500 エラーとなります。 >>501 はこのエラーの場合も含めて適用されます。

クライアント・リダイレクト応答

[25] クライアント・リダイレクト応答 (client redirect response) はクライアントに対してリダイレクトを指示するものです。文書付きと文書無しの2種類があります。 それぞれの要件は次の通りです >>6。

• [26] Location: 欄は必須であり、絶対URLでなければなりません
• [27] 文書無しの場合、
  • [28] Status, Content-Type, Location 以外のCGI頭欄を使って構いません
  • [30] CGI頭欄以外の頭欄を使ってはなりません
  • [29] 応答本体を使ってはなりません
• [31] 文書付きの場合
  • [32] Status, Content-Type, Location のすべてを指定しなければなりません
  • [36] Status はクライアントによるリダイレクトを指示するものでなければなりません
  • [33] 他の頭欄を指定して構いません
  • [34] 応答本体を使って構いません

[35] 鯖は文書無しの場合 302 応答を返さなければなりません。 >>6

[303] 鯖は文書付きの場合CGI応答を適宜変形してクライアントとのプロトコルに適合するようにしなければなりません。 >>6

[327] Apache2 では Status: が無く絶対pathであれば >>19 により、それ以外ならこちらにより処理するようです。

[325] Apache2 では (現実の Webブラウザーの実装がそうであるように) Location: の値が相対URLであっても構いません。

[326] Apache2 では Status: が無ければ >>27、あれば >>31 と解釈されるようです。 >>27 の場合 Content-Type: や応答本体があっても無視されます。

処理モデル

[7] CGIスクリプトは常に空でない応答を鯖に送り返さなければなりません。 >>6

[8] CGIスクリプトから鯖にデータを送る方法はシステム定義です。 別途定義がない場合、「標準出力」ファイル記述子によってデータを送ることになります。 >>6

[9] CGIスクリプトは応答を準備するに当たり REQUEST_METHOD をチェックしなければなりません。 >>6

[10] 鯖はタイムアウトを設定して構いません。その場合、タイムアウトになるとスクリプトを終了させて構いません。 >>6

[320] 応答本体 (response-body) は、零個以上の OCTET の列です。これはクライアントへと返されることになります。鯖は CGIスクリプトが提供したデータをすべて、 EOF に到達するまで読まなければなりません。 それをそのまま無変更で送信するべきです。 ただし、 HEAD の場合、転送符号化、内容符号化、 charset の変換が必要な場合を除きます。 >>6

[323] 実装によっては標準誤り出力が標準出力と共にCGI応答に使われてしまうことがあります。

[504] 標準出力を閉じると HTTP応答も終了したものとして扱う実装が一般的ですが、 特にそう規定されているわけではなく、そうなっていない実装もあります。また、 標準出力が閉じられると CGIスクリプトを終了させる実装もあるようです。

HEAD の場合

[1] HEAD メソッドの場合、 CGIスクリプトは応答本体を指定してはなりません。 鯖は指定されても捨てなければなりません。 >>2

NPH スクリプトの場合

[4] NPHスクリプトは完全な HTTP 応答メッセージを返すことが求められています。 詳しくはNPH応答の項を参照してください。

メモ

[502] CGIの動作について ( (2006-12-17 14:21:19 +09:00 版)) <http://chaichan.web.infoseek.co.jp/qa3000/qa3198.htm>

[503] close(STDOUT)するとCGIが終了する。 | OKWave ( (2012-02-25 23:24:56 +09:00 版)) <http://okwave.jp/qa/q6476437.html>