array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'phar.running.php', 1 => 'Phar::running', 2 => 'Devuelve la ruta completa en el disco o la URL phar completa del archivo phar actualmente ejecutado', ), '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' => 'es', '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 — Devuelve la ruta completa en el disco o la URL phar completa del archivo phar actualmente ejecutado

Descripción

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

Devuelve la ruta completa del archivo phar ejecutado. Esto es utilizado de manera similar a la constante mágica __FILE__ y tiene efectos únicamente dentro de un archivo phar que está siendo ejecutado.

Dentro de un contenedor de carga de un archivo, Phar::running() devuelve "". Utilice simplemente __FILE__ para acceder al phar actual dentro de un contenedor de carga.

Parámetros

returnPhar

Si false, se devuelve la ruta completa en el disco hacia el phar. Si true, se devuelve una URL phar completa.

Valores devueltos

Devuelve la ruta del fichero si es válida, de lo contrario una cadena vacía.

Ejemplos

Ejemplo #1 Un ejemplo con Phar::running()

Para el ejemplo siguiente, se asume que el archivo phar es /ruta/al/archivo.phar.

<?php
$a = Phar::running(); // $a vale "phar:///ruta/al/archivo.phar"
$b = Phar::running(false); // $b vale "/ruta/al/archivo.phar"
?>