PYTHON Phar::running

Python replacement for PHP's Phar::running [ edit ]

Do you know a Python replacement for PHP's Phar::running ? Write it!

PHP Phar::running

PHP original manual for Phar::running [ show | ]


(PHP >= 5.3.0, PECL phar >= 2.0.0)

Phar::runningReturns the full path on disk or full phar URL to the currently executing Phar archive


string Phar::running ([ bool $retphar= true ] )

Returns the full path to the running phar archive. This is intended for use much like the __FILE__ magic constant, and only has effect inside an executing phar archive.

Inside the stub of an archive, Phar::running() returns "". Simply use __FILE__ to access the current running phar inside a stub.



TRUE by default. If FALSE, the full path on disk to the phar archive is returned. If TRUE (default value), a full phar URL is returned.

Return Values

Returns the filename if valid, empty string otherwise.


Example #1 A Phar::running() example

For the following example, assume the file is within phar archive /path/to/phar/my.phar and the file is located at path my/file.txt within the phar archive.

Phar::running(); // $a is "phar:///path/to/my.phar"
$b Phar::running(false); // $b is "/path/to/my.phar"