Apache サブリクエストを実行する

説明

bool virtual ( string $filename )

virtual() は、mod_include の  と似ている Apache 用関数です。この関数は、Apache サブリクエストを実行します。 CGI スクリプトまたは .shtml ファイル、Apache を通して解釈を行う他のものがある場合にこの関数は有用です。 CGI スクリプトの場合、そのスクリプトは、有効な CGI ヘッダを生成する必要があることに注意してください。最低でも、Content-type ヘッダを生成する必要があります。

サブリクエストを実行するには、全てのバッファを終了、ブラウザへフラッシュし、待機状態のヘッダも送信しておきます。

この関数は、 PHP が apache モジュールとしてインストールされた場合のみサポートされます。

パラメータ

filename: virtual コマンドが実行されるファイル

返り値

成功時は virtual コマンドの実行、失敗時は FALSE を返します。

変更履歴

バージョン	説明
4.0.6	この関数を PHP ファイルに使用することができます。しかし、他の PHP ファイルをインクルードする必要があるのなら、 include() または require() を使用するほうがベターです。

例

apache_note() の例を参照ください。

注意

警告

クエリ文字列をインクルードされるファイルに渡す事ができますが、 $_GET は親スクリプトからコピーされ、 $_SERVER['QUERY_STRING'] は渡されたクエリ文字列になります。クエリ文字列は、Apache 2 を使用している場合の見渡されます。要求されたファイルは Apache アクセスログに出力されません。

注意: 要求されたファイルの中で設定された環境変数は、呼び出し元のスクリプトからは見えません。

注意: PHP 4.3.3 以降、 Netscape/iPlanet/SunONE Web サーバの NSAPI サーバモジュールでもこの関数を使用できます。

参考

apache_note()