array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'phar.running.php', 1 => 'Phar::running', 2 => 'Retorna o caminho completo no disco ou a URL completa do arquivo Phar em execução no momento', ), 'up' => array ( 0 => 'class.phar.php', 1 => 'Phar', ), 'prev' => array ( 0 => 'phar.offsetunset.php', 1 => 'Phar::offsetUnset', ), 'next' => array ( 0 => 'phar.setalias.php', 1 => 'Phar::setAlias', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/phar/Phar/running.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Phar::running

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

Phar::running — Retorna o caminho completo no disco ou a URL completa do arquivo Phar em execução no momento

Descrição

final public static Phar::running(bool $returnPhar = true): string

Retorna o caminho completo para o arquivo phar em execução. Isso se destina a ser usado de forma muito semelhante à constante mágica __FILE__ e só tem efeito dentro de um arquivo phar em execução.

Dentro do stub de um arquivo, Phar::running() retorna "". Basta usar __FILE__ para acessar o phar em execução dentro de um stub.

Parâmetros

returnPhar

Se false, o caminho completo no disco para o arquivo phar é retornado. Se true, uma URL phar completa é retornada.

Valor Retornado

Retorna o nome do arquivo se válido, string vazia caso contrário.

Exemplos

Exemplo #1 Um exemplo de Phar::running()

Para o exemplo a seguir, suponha que o arquivo phar esteja localizado em /path/to/phar/my.phar.

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