Phar::setStub
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)
Phar::setStub — Встановити завантажувач або завантажувальну заглушку в Phar-архів
Опис
public Phar::setStub(resource|string $stub, int $length = -1): bool
Зауваження :
Для коректної роботи з об'єктами Phar цьому методу необхідне встановлення значення php.ini
phar.readonlyв . В іншому випадку, буде викинуто виняток PharException
Цей метод використовується для додавання початкової завантажувальної заглушки PHP (PHP bootstrap loader stub) до нового Phar-архіву або для заміни вже існуючого завантажувальної заглушки.
Завантажувач заглушки використовується при підключенні Phar-архіву за допомогою included:
Завантажувач недоступний, коли архів вмикається з використанням обгортки phar, як у прикладі нижче:
Список параметрів
stub
Рядок, або відкритий ресурс потоку.
length
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
Помилки
Викидається виняток UnexpectedValueException, якщо phar.readonly дозволено у php.ini. У разі проблем із записом на диск буде викинуто виняток PharException
список змін
| Версия | Опис |
|---|---|
| 8.3.0 | Виклик методу Phar::setStub() з ресурсом (resource) та параметром length тепер є застарілим. Такі дзвінки повинні бути замінені на: $phar->setStub(stream_get_contents($resource)); |
Приклади
Приклад #1 Приклад використання Phar::setStub()****
Результат виконання наведеного прикладу:
string(5) "Hello"
string(82) "<?php var_dump("First"); Phar::mapPhar("brandnewphar.phar"); __HALT_COMPILER(); ?>"
string(5) "World"
string(83) "<?php var_dump("Second"); Phar::mapPhar("brandnewphar.phar"); __HALT_COMPILER(); ?>"
Дивіться також
- Phar::getStub() - Отримати завантажувач PHP або завантажувач заглушки Phar-архіву
- Phar::createDefaultStub() - Створити заглушку у форматі phar-архіву