Phar::createDefaultStub

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

Phar::createDefaultStubCrear una rutina de interoperabilidad específica del formato de fichero phar

Descripción

final public static Phar::createDefaultStub ([ string $indexfile [, string $webindexfile ]] ) : string

Este método está destinado a la creación de rutinas de interoperabilidad (stubs) específicas del formato de fichero phar, y no está destinado a ustilizarlo con archivo phar basados en tar o zip.

Los archivos Phar contienen una rutina de interoperabilidad cargadora (en inglés stub) escrita en PHP que se ejecuta cuando el archivo es ejecutado en el propio PHP mediante inclusión:

<?php
include 'miphar.phar';
?>
o por simple ejecución:
php miphar.phar
    

Este método proporciona una manera simple y sencilla de crear una rutina de interoperabilidad que ejecutará un fichero inicial desde el archivo phar. Además, se pueden especificar diferentes ficheros para ejecutar el archivo phar desde la línea de comandos o a través de un servidor web. La rutina de interoperabilidad cargadora también llama a Phar::interceptFileFuncs() para permitir empaquetar de manera sencilla una aplicación PHP que accede al sistema de ficheros. Si la extensión phar no está presente, la rutina de interoperabilidad cargadora extraerá el archivo phar en un directorio temporal y después operará sobre los archivos. Una función d cierre borra los ficheros temporales a la salida.

Valores devueltos

Devuelve una cadena que contiene una rutina de interoperabildad personalizada (stub) que permite al archivo Phar creado funcionar con o sin la extensón Phar habilitada.

Errores/Excepciones

Lanza una excepción de tipo UnexpectedValueException si cualquier parámetro es mayor de 400 bytes.

Ejemplos

Ejemplo #1 Un ejemplo de Phar::createDefaultStub()

<?php
try {
    
$phar = new Phar('miphar.phar');
    
$phar->setStub($phar->createDefaultStub('cli.php''web/index.php'));
} catch (
Exception $e) {
    
// manejar errores
}
?>

Ver también

  • Phar::setStub() - Establecer el cargador de PHP o la rutina de interoperabilidad de un archivo Phar
  • Phar::getStub() - Devolver el cargador de PHP o la rutina de interoperabilidad de un archivo Phar