PHP 8.4.0 RC2 available for testing

RarEntry::getStream

(PECL rar >= 2.0.0)

RarEntry::getStreamObté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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top