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

# virtual

(PHP 4, PHP 5, PHP 7)

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

### 説明

virtual ( string `$filename` ) : bool

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

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

この関数は、 PHP が apache モジュールあるいは Netscape/iPlanet/SunONE ウェブサーバーの NSAPI サーバーモジュール としてインストールされた場合のみサポートされます。

### パラメータ

`filename`

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

### 返り値

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

### 例

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

### 注意

警告

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

> 注意:

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

> 注意:

> この関数を PHP ファイルに対して使ってもかまいません。 しかし、一般的に、PHP ファイルに対しては include あるいは require を使うほうがいいでしょう。

### 参考

- apache_note() - Apacheリクエスト記号(note)を取得/設定する