FastCGI SAF パラメータ

FastCGI プラグインの SAF「auth-fastcgi」、「responder-fastcgi」、および「filter-fastcgi」はすべて、特に明記されていないかぎり、次のパラメータを受け付けます。

• bind-path - (省略可能) UNIX ドメインソケット名、名前付きパイプ、形式「host:port」のいずれかになります。「app-path」パラメータの説明のなかで、「bind-path」パラメータの使用方法が説明されています。

• app-path - (省略可能) 要求を処理する FastCGI アプリケーションのパス。その機能は次のように、bind-path パラメータの値に依存します。

  1. app-path のみが指定された場合、プラグインは、プラグインによって作成された UNIX ドメインソケットまたは名前付きパイプを待機する FastCGI アプリケーションを作成します。

  2. app-path と bind-path がどちらも指定された場合、プラグインは、指定された FastCGI アプリケーションのプロセスを起動し、それを指定された bind-path にバインドします。

  3. bind-path のみが指定された場合、FastCGI アプリケーションはリモートで実行されているものとみなされます。このため、プラグインは、FastCGI アプリケーションのプロセスを起動しません。

  4. 「app-path」、「 bind-path」がどちらも指定されなかった場合、プラグインはログにエラーメッセージを記録します。

• app-args — (省略可能) FastCGI アプリケーションプロセスへの引数として渡される値。app-args パラメータは複数指定できます。app-args パラメータを複数指定する場合の形式は、app-args="value" app-args="value" ... です

• app-env - (省略可能) FastCGI アプリケーションプロセスに環境変数として渡される値ペア。「app-env」パラメータは複数指定できます。app-env パラメータを複数指定する場合の形式は、app-env="name=value" app-env="name=value" です。既存の Web Server 環境変数は、FastCGI プログラムには渡されません。このため、app-env を使用して、FastCGI プログラムの環境変数を明示的に設定してください。

  PHP プログラムをコンパイルする場合は、ライブラリファイルが正しく構成されていることを確認してください。

  たとえば、FastCGI アプリケーションとしてコンパイルした PHP バイナリを読み込む場合は、依存関係のあるすべてのライブラリファイル /usr/local/lib および /usr/local/mysql/lib が LD_LIBRARY_PATH にエクスポートされていることを確認する必要があります。

  app-env="LD_LIBRARY_PATH=/usr/local/lib:/usr/local/mysql/lib"

  Windows の場合は、app-env="Path=c:/php/lib:c:/mysql/lib" になります。

  app-env を使用して、ほかの環境変数を PHP アプリケーションにエクスポートすることもできます。 php.ini ファイルの場所は、app-env="PHPRC=<directory path>" のように指定できます。

  PHP を使用する場合は、PHP_FCGI_CHILDREN および PHP_FCGI_MAX_REQUESTS により大きな値を指定して、FastCGI に対する PHP の構成時により高い優先順位を PHP に与える必要があります。

• min-procs - (省略可能) 作成すべき FastCGI アプリケーションプロセスの最小数を指定する整数。デフォルトは 1 です。

• max-procs - (省略可能) 同時に作成可能な FastCGI アプリケーションプロセスの最大数を指定する整数。この整数値は、min-procs と等しいかそれより大きくなければいけません。デフォルトは 1 です。

  ---

  注 –

  現在のところ、デフォルト値はパラメータとして使用できません。この問題については詳しくは、『Sun Java System Web Server 7.0 Update 3 リリースノート』の「FastCGI 」を参照してください。

  ---

• reuse-connection - (省略可能) FastCGI アプリケーションへの接続が再利用されるかどうかを決定するブール値。False (0、false、no) は、要求が終了するたびに FastCGI アプリケーションへの接続が閉じられることを示します。True (1、true、yes) は、既存の接続が新しい要求で再利用されることを示します。デフォルトは false です。connection-timeout も参照してください。

• connection-timeout - (省略可能) 「reuse-connection」が True に設定されている場合に、この値はプール内の接続のタイムアウト値を秒単位で指定します。この指定された期間の間、ある接続がアイドル状態になっていると、プラグインはその接続を閉じます。このパラメータのデフォルト値は 5 秒です。reuse-connection も参照してください。

• resp-timeout - (省略可能) FastCGI サーバー応答タイムアウトを秒単位で表す整数。指定された期間の間、FastCGI アプリケーションから応答がなかった場合、その要求は破棄されます。このパラメータのデフォルト値は 5 分です。

• restart-interval - (省略可能) FastCGI アプリケーションが次に再起動されるまでの時間間隔 (分) を表す整数。このパラメータのデフォルト値は 60 分 (1 時間) です。このパラメータの値をゼロに設定すると、FastCGI アプリケーションが強制的に再起動されることがなくなります。

• req-retry - (省略可能) FastCGI アプリケーションが要求を拒否した場合にプラグインが要求を再送信すべき回数を表す整数。このパラメータのデフォルト値はゼロです。

• listen-queue - (省略可能) ソケットの待機キューサイズを指定する整数。このパラメータのデフォルト値は 256 です。

• rlimit_cpu — FastCGI プログラムの使用する CPU の最大時間 (秒) を指定します。指定できるのは、現在の (弱い) 制限値だけです。このパラメータに対して最大の (強い) 制限値は適用されずに、無視されます。

パラメータ chroot、user、group、nice 、chdir、rlimit_as、rlimit_core 、および rlimit_nofile は UNIX プラットフォームのみに適用されます。Windows プラットフォームでは、それらのパラメータは無視されます。

• chroot - (省略可能、UNIX のみ) FastCGI サーバーアプリケーションプロセスの chroot を実行するときのルートディレクトリを設定するために使用されます。

• user - (省略可能、UNIX のみ) FastCGI アプリケーション実行時に使用するユーザー ID を指定します。デフォルトは、Web Server のユーザー ID になります。

• group - (省略可能、UNIX のみ) 指定されたグループの下で FastCGI アプリケーションが実行されます。デフォルトは、Web Server のグループになります。

• nice - (省略可能、UNIX のみ) FastCGI アプリケーションプロセスの nice/priority 値を指定します。

• chdir - (省略可能、UNIX のみ) 実行開始前に、chroot し chdir で移動するディレクトリを指定します。

• rlimit_as - (省略可能、UNIX のみ) CGI プログラムのアドレス空間の最大値 (バイト) を指定します。現在の (弱い) 制限値と最大の (強い) 制限値の両方を、コンマで区切って指定できます。弱い制限値を最初に指定してください。制限値が 1 つだけ指定された場合は、両方の制限値がこの値に設定されます。

• rlimit_core - (省略可能、UNIX のみ) CGI プログラムのコアファイルサイズの最大値を指定します。値 0 を指定すると、書き込みコアが無効になります。 現在の (弱い) 制限値と最大の (強い) 制限値の両方を、コンマで区切って指定できます。弱い制限値を最初に指定してください。制限値が 1 つだけ指定された場合は、両方の制限値がこの値に設定されます。

• rlimit_nofile - (省略可能、UNIX のみ) CGI プログラムのファイル記述子の最大数を指定します。現在の (弱い) 制限値と最大の (強い) 制限値の両方を、コンマで区切って指定できます。弱い制限値を最初に指定してください。制限値が 1 つだけ指定された場合は、両方の制限値がこの値に設定されます。

error-fastcgi サーバーアプリケーション関数 (SAF) は次のパラメータを受け付けます。

• error-url - 障害またはエラーが発生したときに表示するページの URI または URL を指定します。このパラメータの値は、絶対パス、ドキュメントルートからの相対パス、URL、URI のいずれかになります。

• error-reason - (省略可能) FastCGI プロトコルのエラーを表す文字列。この文字列は、プラグインエラー発生時に表示するエラー URL を区別するために使用されます。