array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'phar.setstub.php', 1 => 'Phar::setStub', 2 => 'Usado para definir o carregador PHP ou o stub de inicialização de um arquivo Phar', ), 'up' => array ( 0 => 'class.phar.php', 1 => 'Phar', ), 'prev' => array ( 0 => 'phar.setsignaturealgorithm.php', 1 => 'Phar::setSignatureAlgorithm', ), 'next' => array ( 0 => 'phar.startbuffering.php', 1 => 'Phar::startBuffering', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/phar/Phar/setStub.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Phar::setStub

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

Phar::setStub — Usado para definir o carregador PHP ou o stub de inicialização de um arquivo Phar

Descrição

public Phar::setStub(resource|string $stub, int $length = -1): bool

Nota:

Este método requer que a configuração phar.readonly do php.ini seja definida como 0 para funcionar com objetos Phar. Caso contrário, uma exceção PharException será lançada.

Este método é usado para adicionar um stub de carregador de inicialização PHP a um novo arquivo Phar, ou para substituir o stub de carregador em um arquivo Phar existente.

O stub do carregador para um arquivo Phar é usado sempre que um arquivo é incluído diretamente como neste exemplo:

<?php
include 'meuphar.phar';
?>

O carregador não é acessado ao incluir um arquivo por meio do empacotador de fluxo phar como a seguir:

<?php
include 'phar://meuphar.phar/algumarquivo.php';
?>

Parâmetros

stub

Uma string ou um identificador de fluxo aberto para usar como stub executável para este arquivo phar.

length

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

UnexpectedValueException é lançada se phar.readonly estiver habilitado no php.ini. PharException é lançada se algum problema for encontrado ao liberar alterações no disco.

Registro de Alterações

Versão Descrição
8.3.0 Chamar Phar::setStub() com um resource e um length foi descontinuado. Tais chamadas devem ser substituídas por: $phar->setStub(stream_get_contents($resource));

Exemplos

Exemplo #1 Um exemplo de Phar::setStub()

<?php
try {
$p = new Phar(dirname(__FILE__) . '/novophar.phar', 0, 'novophar.phar');
$p['a.php'] = '<?php var_dump("Olá");';
$p->setStub('<?php var_dump("Primeiro"); Phar::mapPhar("novophar.phar"); __HALT_COMPILER(); ?>');
include 'phar://novophar.phar/a.php';
var_dump($p->getStub());
$p['b.php'] = '<?php var_dump("Mundo");';
$p->setStub('<?php var_dump("Segundo"); Phar::mapPhar("novophar.phar"); __HALT_COMPILER(); ?>');
include 'phar://novophar.phar/b.php';
var_dump($p->getStub());
} catch (Exception $e) {
echo 'As operações de gravação falharam em novophar.phar: ', $e;
}
?>

O exemplo acima produzirá:

string(5) "Olá"
string(82) "<?php var_dump("Primeiro"); Phar::mapPhar("novophar.phar"); __HALT_COMPILER(); ?>"
string(5) "Mundo"
string(83) "<?php var_dump("Segundo"); Phar::mapPhar("novophar.phar"); __HALT_COMPILER(); ?>"

Veja Também