phar.running(3) php man page | unix.com

PHAR.RUNNING(3) 							 1							   PHAR.RUNNING(3)

Phar::running - Returns the full path on disk or full phar URL to the currently executing Phar archive

SYNOPSIS

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

DESCRIPTION

	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(3) returns "". Simply use __FILE__ to access the current running phar inside a stub.

PARAMETERS

	      o $retphar
		- If FALSE, the full path on disk to the phar archive is returned. If TRUE, a full phar URL is returned.

RETURN VALUES

	Returns the filename if valid, empty string otherwise.

EXAMPLES

       Example #1

	      A Phar.running(3) example

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

	      <?php
	      $a = Phar::running(); // $a is "phar:///path/to/my.phar"
	      $b = Phar::running(false); // $b is "/path/to/my.phar"
	      ?>

PHP Documentation Group 													   PHAR.RUNNING(3)