Return-Path: 
 <cvs-return-13600-apmail-httpd-cvs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org
Received: (qmail 76596 invoked by uid 500); 15 Oct 2002 11:18:53 -0000
Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
list-help: <mailto:cvs-help@httpd.apache.org>
list-unsubscribe: <mailto:cvs-unsubscribe@httpd.apache.org>
list-post: <mailto:cvs@httpd.apache.org>
Delivered-To: mailing list cvs@httpd.apache.org
Received: (qmail 76585 invoked by uid 500); 15 Oct 2002 11:18:53 -0000
Delivered-To: apmail-httpd-2.0-cvs@apache.org
Date: 15 Oct 2002 11:18:53 -0000
Message-ID: <20021015111853.84212.qmail@icarus.apache.org>
From: yoshiki@apache.org
To: httpd-2.0-cvs@apache.org
Subject: cvs commit: httpd-2.0/docs/manual cgi_path.xml.ja
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

yoshiki     2002/10/15 04:18:53

  Added:       docs/manual cgi_path.xml.ja
  Log:
  New XML.
  
  Revision  Changes    Path
  1.1                  httpd-2.0/docs/manual/cgi_path.xml.ja
  
  Index: cgi_path.xml.ja
  ===================================================================
  <?xml version="1.0" encoding="iso-2022-jp"?>
  <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
  <?xml-stylesheet type="text/xsl" href="./style/manual.ja.xsl"?>
  <!-- English revision: 1.1 -->
  
  <manualpage>
    <relativepath href="."/>
  
    <title>CGI 環境での PATH_INFO の変更</title>
  
    <summary>
      <p>Apache 1.1.1 およびそれ以前のバージョンで実装されていた
      CGI 環境で PATH_INFO を作成する方法は直観的でなく、
      場合によってはクラッシュすることもありました。
      Apache 1.2 及びそれ以降において、この動作が変更されました。
      このことにより特定の古い CGI アプリケーションにおいていくつか
      互換性の問題が生じることがありますが、それでも Apache 1.2 の動作は
      CGI/1.1 仕様と互換があり、CGI スクリプトは容易に修正できます(<a
      href="#compat">以下参照</a>)。</p>
    </summary>
  
      <section id="prob"><title>問題</title>
  
      <p>Apache 1.1.1 およびそれ以前では、URL ではなくファイル名を参照して
      PATH_INFO と SCRIPT_NAME 環境変数を設定していました。
      多くの場合はこれが正しい結果を返しますが、パス情報を含むように
      filesystem パスがオーバーロードされた場合は、
      誤った結果を返す場合がありました。
      たとえば、設定ファイルに以下がある場合</p>
  
      <example>
        Alias /cgi-ralph /usr/local/httpd/cgi-bin/user.cgi/ralph
      </example>    
  
      <p>この場合、<code>user.cgi</code> は CGI スクリプトであり、
      &quot;/ralph&quot; は、CGI に渡される情報です。もし上の設定がなされていて、
      &quot;<code>/cgi-ralph/script/</code>&quot; へのリクエストが来れば、
      PATH_INFO には &quot;<code>/ralph/script/</code>&quot; が、
      SCRIPT_NAME には &quot;<code>/cgi-</code>&quot; が設定されます。
      明らかに、後者は間違っています。特定の場合には、これにより
      サーバがクラッシュすることさえありました。</p>
    </section>
  
    <section id="solution"><title>解決</title>
      <p>Apache 1.2 以降では SCRIPT_NAME と PATH_INFO の決定には URL
      を直接参照して、URL
      のどれだけの部分がクライアントが変更可能なのかを確定させた上で
      PATH_INFO を設定するようになりました。上の例では、PATH_INFO には
      &quot;<code>/script</code>&quot; が、SCRIPT_NAME には
      &quot;<code>/cgi-ralph</code>&quot; が設定されます。
      これは正しく、さらに、サーバの動作に問題を起こすこともありません。また、
      &quot;<code>http://$SERVER_NAME:$SERVER_PORT$SCRIPT_NAME$PATH_INFO</code>&quot;
      が、常に最新のスクリプトを指す、アクセス可能な URL であることを
      保証します。これは、以前のバージョンの Apache
      では必ずしもそうとは限らなかったことです。
      </p>
  
      <p>しかし <code>Alias</code> ディレクティブからの
      &quot;<code>/ralph</code>&quot; 情報は失われます。
      これは残念ですが、filesystem を通してこの種類の情報を
      渡すのは薦められた方法ではなく、
      またそれを使ったスクリプトは動作しなくても当然だと考えます。
      ただし、Apache 1.2b3 以降では<a
      href="#compat">代替手段</a>を用意しています。</p>
    </section>
  
    <section id="compat">
      <title>以前のサーバとの互換性</title>
  
      <p>以前のバージョンの Apache や他のサーバ向けに設計された
      スクリプトには古い PATH_INFO 変数により提供される情報が
      必要であるかもしれません。
      この目的のために、
      Apache 1.2 (1.2b3 以降) では追加の変数、FILEPATH_INFO
      を設定します。この環境変数には、Apache 1.1.1 で
      PATH_INFO であったであろう値が設定されます。</p>
  
      <p>Apache 1.2 およびそれ以前のバージョンの両方で動作させたいスクリプトは、
      FILEPATH_INFO の存在を単に調べて、それがあれば
      使う、ということができます。そうでなければ、PATH_INFO
      を使うことができます。たとえば、Perl では次のものを使うことができます</p>
  
      <example>
        $path_info = $ENV{'FILEPATH_INFO'} || $ENV{'PATH_INFO'};
      </example>
  
      <p>これにより、スクリプトはすべてのバージョンの Apache を含む、
      CGI/1.1 をサポートするすべてのサーバで動作することができます。
      </p>
    </section>
  </manualpage>