PHP マニュアル: 最大 4 つまでの $_SERVER 変数を実行時に変更させる

final public static void Phar::mungServer(array $variables)

Phar::mungServer は、 phar アーカイブのスタブ内でのみ使用します。

最大 4 つまでの $_SERVER 変数を指定し、実行時に変更させます。phar の実行時に変更できる変数は REQUEST_URI、PHP_SELF、 SCRIPT_NAME そして SCRIPT_FILENAME です。

このメソッド自身は何も行いません。これが効力を発揮するのは Phar::webPhar と組み合わせた場合で PHP ファイルがリクエストされた場合のみです。 PATH_INFO と PATH_TRANSLATED は常に変更されていることに注意しましょう。

変更前の元の値は、SERVER 配列の中で PHAR_ をつけた名前で保持されます。たとえば SCRIPT_NAME の場合は変更前の値は PHAR_SCRIPT_NAME となります。

variables: REQUEST_URI、PHP_SELF、 SCRIPT_NAME および SCRIPT_FILENAME を含む、文字列の配列。その他の値を指定した場合は例外が発生します。また Phar::mungServer は大文字小文字を区別します。

値を返しません。

渡したデータに何らかの問題があった場合は UnexpectedValueException をスローします。

例1 Phar::mungServer の例

<?php
// スタブのサンプル
Phar::mungServer(array('REQUEST_URI'));
Phar::webPhar();
__HALT_COMPILER();
?>