virtual
Apache サブリクエストを実行する
&reftitle.description;
boolvirtual
stringuri
virtual は、mod_include の
<!--#include virtual...--> と似ている
Apache 用関数です。
この関数は、Apache サブリクエストを実行します。
CGI スクリプトまたは .shtml ファイル、Apache を通して解釈を行う
他のものがある場合にこの関数は有用です。
CGI スクリプトの場合、そのスクリプトは、有効な CGI ヘッダを生成する
必要があることに注意してください。
最低でも、Content-Type ヘッダを生成する必要があります。
サブリクエストを実行するには、全てのバッファを終了、ブラウザへフラッシュし、
待機状態のヘッダも送信しておきます。
&apache.req.module;
&reftitle.parameters;
uri
virtual コマンドが実行されるファイル
&reftitle.returnvalues;
成功時は virtual コマンドの実行、失敗時は &false; を返します。
&reftitle.examples;
apache_note の例を参照ください。
&reftitle.notes;
クエリ文字列をインクルードされるファイルに渡す事ができますが、
$_GET は親スクリプトからコピーされ、
$_SERVER['QUERY_STRING'] は渡されたクエリ文字列に
なります。クエリ文字列は、Apache 2 を使用している場合の見渡されます。
要求されたファイルは Apache アクセスログに出力されません。
要求されたファイルの中で設定された環境変数は、呼び出し元の
スクリプトからは見えません。
この関数を PHP ファイルに対して使ってもかまいません。
しかし、一般的に、PHP ファイルに対しては
include あるいは require
を使うほうがいいでしょう。
&reftitle.seealso;
apache_note