Documentación offline PHP master

Phar::setDefaultStub

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Phar::setDefaultStub

Utilizado para establecer el cargador PHP o el contenedor de carga de un archivo Phar como cargador por defecto

Descripción#

public Phar::setDefaultStub([string $index], [string $webIndex]): true
```php

> [!NOTE]
> Este método requiere que la variable de configuración INI `phar.readonly` esté definida a `0` para funcionar con los objetos `Phar` . De lo contrario, se lanzará una excepción `PharException`.

Este método es un atajo que combina las funcionalidades de `Phar::createDefaultStub` y `Phar::setStub`.

## Parámetros

`index`  
Ruta relativa dentro del archivo phar a ejecutar si se lanza desde la línea de comandos

`webIndex`  
Ruta relativa dentro del archivo phar a ejecutar si se lanza desde un navegador

## Valores devueltos

Retorna siempre `true`.

## Errores/Excepciones

Se lanza una excepción `UnexpectedValueException` si [phar.readonly](#ini.phar.readonly) está activada en el php.ini. Se lanza una excepción `PharException` si se encuentran problemas al escribir los cambios en el disco.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.4.0 | Phar::setDefaultStub ahora tiene un tipo de retorno provisional de `true`. |
| 8.0.0 | `webIndex` ahora es nullable. |

## Ejemplos

Un ejemplo con `Phar::setDefaultStub`
setDefaultStub('cli.php', 'web/index.php'); // es equivalente a: // $phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php')); } catch (Exception $e) { // manejo de errores } ?>

```php

Véase también#

Phar::setStub, Phar::createDefaultStub