無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

nsapi_virtual

(PHP 4 >= 4.3.3, PHP 5)

nsapi_virtualNSAPI サブリクエストを発行する

説明

bool nsapi_virtual ( string $uri )

nsapi_virtual() は NSAPI 特有の関数です。 SSI (.shtml ファイル) における <!--#include virtual...--> と等価で、NSAPI サブリクエストを実行します。 CGI スクリプトや .shtmlファイル、 あるいはその他ウェブサーバ上でパースするものを include するのに有用でしょう。

サブリクエストを実行するには、全てのバッファリングを中断し ブラウザにフラッシュする必要があります。 ペンディング状態のヘッダも送出する必要があります。

この関数を使って他の PHP スクリプトに再帰的なリクエストをすることはできません。 PHP スクリプトをインクルードしたい場合には、include() または require() を使用してください。

注意: この関数は、Netscape/iPlanet/Sun ウェブサーバのドキュメント化されていない機構に依存してます。 この関数が有効かどうか確かめるには phpinfo() を使用してください。Unix 環境では常に作動するでしょう。Windows 環境では、 ns-httpdXX.dll ファイルの名称に依存します。
もしこの問題に遭遇した場合には NSAPI セクションのサブリクエスト (UNIXWindows) の項をご覧ください。

パラメータ

uri

スクリプトの URI 。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。