Phar::mungServer
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::mungServer — Defines a list of up to 4 $_SERVER variables that should be modified for execution
Description
$variables): voidPhar::mungServer() should only be called within the stub of a phar archive.
Defines a list of up to 4 $_SERVER variables that should be
modified for execution.
Variables that can be modified to remove traces of phar execution are
REQUEST_URI, PHP_SELF,
SCRIPT_NAME and SCRIPT_FILENAME.
On its own, this method does nothing. Only when combined with
Phar::webPhar() does it take effect, and only when the requested
file is a PHP file to be parsed. Note that the
PATH_INFO and PATH_TRANSLATED variables
are always modified.
The original values of variables that are modified are stored in the SERVER
array with PHAR_ prepended, so for instance
SCRIPT_NAME would be saved as PHAR_SCRIPT_NAME.
Parameters
-
variables -
an array containing as string indices any of
REQUEST_URI,PHP_SELF,SCRIPT_NAMEandSCRIPT_FILENAME. Other values trigger an exception, and Phar::mungServer() is case-sensitive.
Return Values
No return.
Errors/Exceptions
Throws UnexpectedValueException if any problems are found with the passed in data.
Examples
Example #1 A Phar::mungServer() example
<?php
// example stub
Phar::mungServer(array('REQUEST_URI'));
Phar::webPhar();
__HALT_COMPILER();
?>
See Also
- Phar::webPhar() - Routes a request from a web browser to an internal file within the phar archive
- Phar::setStub() - Used to set the PHP loader or bootstrap stub of a Phar archive
