nsapi_virtual

(PHP 4 >= 4.3.3, PHP 5, PHP 7)

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

説明

nsapi_virtual ( string $uri ) : bool

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 を返します。