Установить загрузчик PHP или начальную заглушку Phar-архива в загрузчик по умолчанию

# Phar::setDefaultStub

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

Phar::setDefaultStub — Установить загрузчик PHP или начальную заглушку Phar-архива в загрузчик по умолчанию

### Описание

public function Phar::setDefaultStub(?string `$index` = `null`, ?string `$webIndex` = `null`): true

> Замечание: Для корректной работы метода с объектами Phar потребуется установить для директивы `phar.readonly` в файле php.ini значение `0`, иначе метод выбросит исключение PharException.

Этот метод комбинирует функциональность двух других методов, Phar::createDefaultStub() и Phar::setStub().

### Список параметров

`index`

  Относительный путь в phar-архиве для запуска при доступе из командной строки

`webIndex`

  Относительный путь в phar-архиве для запуска при доступе из веб-браузера

### Возвращаемые значения

Функция возвращает логическое значение `true`.

### Ошибки

Будет выброшено исключение UnexpectedValueException, если phar.readonly разрешено в php.ini. В случае проблем с записью на диск будет выброшено исключение PharException.

### Список изменений

Версия | Описание
--- | ---
8.4.0 | Метод Phar::setDefaultStub() теперь возвращает предварительное значение true.
8.0.0 | `webIndex` теперь допускает значение null.

### Примеры

Пример #1 Пример использования Phar::setDefaultStub()

    <?php
    try {
        $phar = new Phar('myphar.phar');
        $phar->setDefaultStub('cli.php', 'web/index.php');
        // это аналогично такому коду:
        // $phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php'));
    } catch (Exception $e) {
        // обработка ошибок
    }
    ?>

### Смотрите также

- Phar::setStub() - Устанавливает в Phar-архив заглушку, которая играет роль начального загрузчика PHP
- Phar::createDefaultStub() - Создать заглушку в формате phar-архива

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open