/rar//

rar:// rar:// — RAR

Description ¶ The wrapper takes the url encoded path to the RAR archive (relative or absolute), an optional asterisk (*), an optional number sign (#) and an optional url encoded entry name, as stored in the archive. Specifying an entry name requires the number sign; a leading forward slash in the entry name is optional.

This wrapper can open both files and directories. When opening directories, the asterisk sign forces the directory entries names to be returned unencoded. If it's not specified, they will be returned url encoded – the reason for this is to allow the wrapper to be correctly used with built-in functionality like the RecursiveDirectoryIterator in the presence of file names that seem like url encoded data.

If the pound sign and the entry name part are not included, the root of the archive will be displayed. This differs from regular directories in that the resulting stream will not contain information such as the modification time, as the root directory is not stored in an individual entry in the archive. The usage of the wrapper with RecursiveDirectoryIterator requires the number sign to be included in the URL when accessing the root, so that the URLs of the children may be constructed correctly.

Note: This wrapper is not enabled by default In order to use the rar:// wrapper, the » rar extension available from » PECL must be installed.

rar:// Available since PECL rar 3.0.0

Usage ¶ rar://<url encoded archive name>[*][#[<url encoded entry name>]] Options ¶ Wrapper Summary Attribute Supported Restricted by allow_url_fopen No Restricted by allow_url_include No Allows Reading Yes Allows Writing No Allows Appending No Allows Simultaneous Reading and Writing No Supports stat() Yes Supports unlink() No Supports rename() No Supports mkdir() No Supports rmdir() No Context options Name Usage Default open_password The password used to encrypt the headers of the archive, if any. WinRAR will encrypt all the files with the same password as the headers password when the later is present, so for archives with encrypted headers, file_password will be ignored. file_password The password used to encrypt a file, if any. If the headers are also encrypted, this option will be ignored in favor of open_password. The reason there are two options is to cover the possibility of supporting archives with different headers and file passwords, should those archives arise. Note that if the archive does not have its headers encrypted, open_password will be ignored and this option must be used instead. volume_callback A callback to determine the path of missing volumes. See RarArchive::open() for more information. Examples ¶ Example #1 Traversing a RAR archive

<?php

class MyRecDirIt extends RecursiveDirectoryIterator {

   function current() {
       return rawurldecode($this->getSubPathName()) .
           (is_dir(parent::current())?" [DIR]":"");
   }

}

$f = "rar://" . rawurlencode(dirname(__FILE__)) .

   DIRECTORY_SEPARATOR . 'dirs_and_extra_headers.rar#';

$it = new RecursiveTreeIterator(new MyRecDirIt($f));

foreach ($it as $s) {

   echo $s, "\n";

} ?> The above example will output something similar to:

|-allow_everyone_ni [DIR] |-file1.txt |-file2_אּ.txt |-with_streams.txt \-אּ [DIR]

 |-אּ\%2Fempty%2E [DIR]
 | \-אּ\%2Fempty%2E\file7.txt
 |-אּ\empty [DIR]
 |-אּ\file3.txt
 |-אּ\file4_אּ.txt
 \-אּ\אּ_2 [DIR]
   |-אּ\אּ_2\file5.txt
   \-אּ\אּ_2\file6_אּ.txt

Example #2 Opening an encrypted file (header encryption)

<?php $stream = fopen("rar://" .

   rawurlencode(dirname(__FILE__)) . DIRECTORY_SEPARATOR .
   'encrypted_headers.rar' . '#encfile1.txt', "r", false,
   stream_context_create(
       array(
           'rar' =>
               array(
                   'open_password' => 'samplepassword'
               )
           )
       )
   );

var_dump(stream_get_contents($stream)); /* creation and last access date is opt-in in WinRAR, hence most

* files don't have them */

var_dump(fstat($stream)); ?> The above example will output something similar to:

string(26) "Encrypted file 1 contents." Array (

   [0] => 0
   [1] => 0
   [2] => 33206
   [3] => 1
   [4] => 0
   [5] => 0
   [6] => 0
   [7] => 26
   [8] => 0
   [9] => 1259550052
   [10] => 0
   [11] => -1
   [12] => -1
   [dev] => 0
   [ino] => 0
   [mode] => 33206
   [nlink] => 1
   [uid] => 0
   [gid] => 0
   [rdev] => 0
   [size] => 26
   [atime] => 0
   [mtime] => 1259550052
   [ctime] => 0
   [blksize] => -1
   [blocks] => -1

)

Sidslut

Orginalhemsidan på Engelska :https://www.php.net/manual/en/wrappers.rar.php
PHP
Språkreferens
Stödda Protokoll och Inslagningar

---

Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp som har sponsrat Linux.se med webserver.