array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'rarentry.getstream.php', 1 => 'RarEntry::getStream', 2 => 'Obtém manipulador de arquivo para entrada', ), 'up' => array ( 0 => 'class.rarentry.php', 1 => 'RarEntry', ), 'prev' => array ( 0 => 'rarentry.getpackedsize.php', 1 => 'RarEntry::getPackedSize', ), 'next' => array ( 0 => 'rarentry.getunpackedsize.php', 1 => 'RarEntry::getUnpackedSize', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/rar/rarentry/getstream.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

RarEntry::getStream

(PECL rar >= 2.0.0)

RarEntry::getStream — Obtém manipulador de arquivo para entrada

Descrição

public RarEntry::getStream(string $password = ?): resource|false

Retorna um manipulador de arquivos que oferece suporte a operações de leitura. Este manipulador fornece descompressão instantânea para esta entrada.

manipulador não é invalidado chamando rar_close().

Aviso

O fluxo resultante não possui verificação de integridade. Em particular, a corrupção e a descriptografia de arquivos com uma chave errada não serão detectadas. É responsabilidade do programador usar o CRC da entrada para verificar a integridade, se assim desejar.

Parâmetros

password
A senha usada para criptografar esta entrada. Se a entrada não estiver criptografada, este valor não será usado e poderá ser omitido. Se este parâmetro for omitido e a entrada for criptografada, será usada a senha fornecida para rar_open(), se houver. Se uma senha errada for fornecida, explícita ou implicitamente via rar_open(), o fluxo resultante deste método produzirá uma saída errada. Se nenhuma senha for fornecida e uma for necessária, este método falhará e retornará false. Você pode verificar se uma entrada está criptografada com RarEntry::isEncrypted().

Valor Retornado

O manipulador de arquivo ou false em caso de falha.

Registro de Alterações

Versão Descrição
PECL rar 3.0.0 O suporte para arquivos RAR com nomes de entrada repetidos não apresenta mais defeitos.

Exemplos

Exemplo #1 Exemplo de RarEntry::getStream()

<?php

$rar_file = rar_open('exemplo.rar');
if ($rar_file === false)
die("Falha ao abrir arquivo Rar");

$entry = rar_entry_get($rar_file, 'Dir/arquivo.txt');
if ($entry === false)
die("Falha ao pesquisar tal entrada");

$stream = $entry->getStream();
if ($stream === false)
die("Falha ao obter fluxo.");

rar_close($rar_file); // fluxo é independente do arquivo

while (!feof($stream)) {
$buff = fread($stream, 8192);
if ($buff !== false)
echo $buff;
else
break; // erro em fread
}

fclose($stream);

?>

Veja Também