(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::setStub — Utilizado para especificar el cargador PHP o el contenedor de carga de un archivo Phar
Nota:
Este método requiere que la opción de php.ini
phar.readonly
esté establecida a0
para que trabaje con objetos Phar. De otra manera, se lanzará una excepción de tipo PharException.
Este método se utiliza para añadir un cargador PHP a un nuevo archivo Phar, o para reemplazar el contenedor de carga de un archivo Phar existente.
El contenedor de carga de un archivo Phar se utiliza cuando un archivo es incluido directamente como en este ejemplo:
<?php
include 'monphar.phar';
?>
El cargador no se utiliza cuando un fichero es incluido a través del flujo phar
como esto:
<?php
include 'phar://monphar.phar/unfchier.php';
?>
stub
Una cadena o un recurso de flujo abierto a utilizar como contenedor ejecutable para este archivo phar.
length
Una excepción UnexpectedValueException es lanzada si phar.readonly está activado en el php.ini. Una excepción PharException es lanzada si se encuentran problemas al escribir los cambios en el disco.
Versión | Descripción |
---|---|
8.3.0 |
Llamar a Phar::setStub() con una
resource y una length
ahora está obsoleto. Tales llamadas deberían ser reemplazadas por:
$phar->setStub(stream_get_contents($resource));
|
Ejemplo #1 Un ejemplo con Phar::setStub()
<?php
try {
$p = new Phar(dirname(__FILE__) . '/nouveau.phar', 0, 'nouveau.phar');
$p['a.php'] = '<?php var_dump("Salut");';
$p->setStub('<?php var_dump("Premier"); Phar::mapPhar("nouveau.phar"); __HALT_COMPILER(); ?>');
include 'phar://nouveau.phar/a.php';
var_dump($p->getStub());
$p['b.php'] = '<?php var_dump("Tout le monde");';
$p->setStub('<?php var_dump("Second"); Phar::mapPhar("nouveau.phar"); __HALT_COMPILER(); ?>');
include 'phar://nouveau.phar/b.php';
var_dump($p->getStub());
} catch (Exception $e) {
echo 'Error al escribir nuevo.phar: ', $e;
}
?>
El resultado del ejemplo sería:
string(5) "Salut" string(79) "<?php var_dump("Premier"); Phar::mapPhar("nouveau.phar"); __HALT_COMPILER(); ?>" string(13) "Tout le monde" string(78) "<?php var_dump("Second"); Phar::mapPhar("nouveau.phar"); __HALT_COMPILER(); ?>"