略微加速

PHP官方手册 - 互联网笔记

PHP - Manual: RarEntry::getStream

2024-12-20

RarEntry::getStream

(PECL rar >= 2.0.0)

RarEntry::getStreamGet file handler for entry

说明

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

Returns a file handler that supports read operations. This handler provides on-the-fly decompression for this entry.

The handler is not invalidated by calling rar_close().

警告

The resulting stream has no integrity verification. In particular, file corruption and decryption with a wrong a key will not be detected. It is the programmer's responsability to use the entry's CRC to check for integrity, if he so wishes.

参数

password

The password used to encrypt this entry. If the entry is not encrypted, this value will not be used and can be omitted. If this parameter is omitted and the entry is encrypted, the password given to rar_open(), if any, will be used. If a wrong password is given, either explicitly or implicitly via rar_open(), this method's resulting stream will produce wrong output. If no password is given and one is required, this method will fail and return false. You can check whether an entry is encrypted with RarEntry::isEncrypted().

返回值

The file handler 或者在失败时返回 false.

更新日志

版本 说明
PECL rar 3.0.0 Support for RAR archives with repeated entry names is no longer defective.

范例

示例 #1 RarEntry::getStream() example

<?php

$rar_file 
rar_open('example.rar');
if (
$rar_file === false)
    die(
"Failed to open Rar archive");

$entry rar_entry_get($rar_file'Dir/file.txt');
if (
$entry === false)
    die(
"Failed to find such entry");

$stream $entry->getStream();
if (
$stream === false)
    die(
"Failed to obtain stream.");

rar_close($rar_file); //stream is independent from file

while (!feof($stream)) {
    
$buff fread($stream8192);
    if (
$buff !== false)
        echo 
$buff;
    else
        break; 
//fread error
}

fclose($stream);

?>

参见

add a noteadd a note

User Contributed Notes

There are no user contributed notes for this page.

官方地址:https://www.php.net/manual/en/rarentry.getstream.php

北京半月雨文化科技有限公司.版权所有 京ICP备12026184号-3