Home/ Manual/ phar / Phar/ Phar::setDefaultStub

Phar::setDefaultStub

PHP function Edit on GitHub ✎

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

Used to set the PHP loader or bootstrap stub of a Phar archive to the default loader

Description

Phar::setDefaultStub(string|null $index = null, string|null $webIndex = null): true

Write

This method is a convenience method that combines the functionality of Phar::createDefaultStub() and Phar::setStub().

Parameters

index: Relative path within the phar archive to run if accessed on the command-line
webIndex: Relative path within the phar archive to run if accessed through a web browser

Return Values

Always

Errors/Exceptions

UnexpectedValueException is thrown if phar.readonly is enabled in php.ini. PharException is thrown if any problems are encountered flushing changes to disk.

Changelog

Version	Description
8.4.0	`Phar::setDefaultStub` now has a tentative return of `true`.
8.0.0	`webIndex` is nullable now.

Examples

A Phar::setDefaultStub() example

php

<?php
try {
    $phar = new Phar('myphar.phar');
    $phar->setDefaultStub('cli.php', 'web/index.php');
    // this is the same as:
    // $phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php'));
} catch (Exception $e) {
    // handle errors
}
?>