Phar
PHP Manual

Phar::createDefaultStub

(Unknown)

Phar::createDefaultStubСоздать загрузчик в формате phar-архива

Описание

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

Этот метод создает код загрузчика (stub) в специфичном для phar-архива формате и не предназначеный для использования с файловыми архивами на основе tar или zip.

Phar-архивы содержат загрузчик (stub), написанный на PHP, который запускается при запуске архива, когда его подключают через include:

<?php
include 'myphar.phar';
?>
или просто запускают:
php myphar.phar
    

Этот метод предоставляет простой способ для создания загрузчика, который будет отрабатывать при запуске phar-архива. Кроме того, можно указывать разные файлы для запуска phar-архива через веб-сервер и через командрую строку. Загрузчик также вызывает Phar::interceptFileFuncs() для простого создания приложений PHP с доступом к файловой системе. Если расширение phar отсутствует, то загрузчик распакует phar-архив во временную директорию и запустит приложение оттуда. Функция завершения работы удалит все временные файлы.

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

Возвращает текст с кодом загрузчика (stub), который позволит Phar-архиву запускаться независимо от того, подключено ли расширение Phar или нет.

Ошибки

Бросит исключение UnexpectedValueException, если любой из параметров будет длинее 400 байт.

Примеры

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

<?php
try {
    
$phar = new Phar('myphar.phar');
    
$phar->setStub($phar->createDefaultStub('cli.php''web/index.php'));
} catch (
Exception $e) {
    
// обрабатываем ошибки
}
?>

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


Phar
PHP Manual