Docs For Class File_Archive

void close(
)

Put back the reader in the state it was before the first call

to next()

Overridden in child classes as:

File_Archive_Reader_Memory::close()

File_Archive_Reader_File::close()

File_Archive_Reader_Concat::close()

File_Archive_Reader_Archive::close(): Close the source if it was given closed in the constructor

File_Archive_Reader_Gzip::close()

File_Archive_Reader_Tar::close()

File_Archive_Reader_Bzip2::close()

File_Archive_Reader_Zip::close()

File_Archive_Reader_Ar::close()

File_Archive_Reader_Relay::close()

File_Archive_Reader_Uncompress::close()

File_Archive_Reader_Multi::close()

File_Archive_Reader_Directory::close()

[ Top ]

void extract(

&$writer, [bool
$autoClose = true], [int
$bufferSize = 102400], File_Archive_Writer
$writer)

Sends the whole reader to $writer and close the reader

Parameters:

File_Archive_Writer	`$writer`	—	Where to write the files of the reader
bool	`$autoClose`	—	If true, close $writer at the end of the function. Default value is true
int	`$bufferSize`	—	Size of the chunks that will be sent to the writer Default value is 100kB
	`&$writer`	—

[ Top ]

void extractFile(
string
$filename, 
&$writer, [bool
$autoClose = true], [int
$bufferSize = 8192], File_Archive_Writer
$writer)

Extract only one file (given by the URL)

Parameters:

string	`$filename`	—	URL of the file to extract from this
File_Archive_Writer	`$writer`	—	Where to write the file
bool	`$autoClose`	—	If true, close $writer at the end of the function Default value is true
int	`$bufferSize`	—	Size of the chunks that will be sent to the writer Default value is 100kB
	`&$writer`	—

[ Top ]

void getData(
[
$length = -1])

Reads some data from the current file

If the end of the file is reached, returns null If $length is not specified, reads up to the end of the file If $length is specified reads up to $length

Overridden in child classes as:

File_Archive_Reader_Memory::getData()

File_Archive_Reader_File::getData()

File_Archive_Reader_Concat::getData()

File_Archive_Reader_Gzip::getData()

File_Archive_Reader_Tar::getData()

File_Archive_Reader_Bzip2::getData()

File_Archive_Reader_Zip::getData()

File_Archive_Reader_Ar::getData()

File_Archive_Reader_Relay::getData()

Parameters:

$length —

[ Top ]

the getDataFilename(
)

If the current file of the archive is a physical file,

Return:
name of the physical file containing the data or null if no such file exists
The data filename may not be the same as the filename.

Overridden in child classes as:

File_Archive_Reader_File::getDataFilename()

File_Archive_Reader_Relay::getDataFilename()

[ Top ]

array getFileList(
)

Returns the list of filenames from the current pos to the end of the source The source will be closed after having called this function This function goes through the whole archive (which may be slow).

If you intend to work on the reader, doing it in one pass would be faster

Return: filenames from the current pos to the end of the source

Overridden in child classes as:

File_Archive_Reader_AddBaseName::getFileList()

File_Archive_Reader_ChangeBaseName::getFileList()

[ Top ]

string getFilename(
)

Returns the name of the file currently read by the reader

Warning: undefined behaviour if no call to next have been done or if last call to next has returned false

Return: Name of the current file

Overridden in child classes as:

File_Archive_Reader_Memory::getFilename()

File_Archive_Reader_File::getFilename()

File_Archive_Reader_Concat::getFilename()

File_Archive_Reader_Gzip::getFilename(): Return the name of the single file contained in the archive deduced from the name of the archive (the extension is removed)

File_Archive_Reader_Tar::getFilename()

File_Archive_Reader_Bzip2::getFilename(): Return the name of the single file contained in the archive deduced from the name of the archive (the extension is removed)

File_Archive_Reader_Zip::getFilename()

File_Archive_Reader_Ar::getFilename()

File_Archive_Reader_Relay::getFilename()

File_Archive_Reader_AddBaseName::getFilename()

File_Archive_Reader_ChangeBaseName::getFilename()

File_Archive_Reader_Directory::getFilename()

[ Top ]

void getMime(
)

Returns the MIME associated with the current file

The default function does that by looking at the extension of the file

Overridden in child classes as:

File_Archive_Reader_Memory::getMime()

File_Archive_Reader_File::getMime()

File_Archive_Reader_Concat::getMime()

File_Archive_Reader_Relay::getMime()

[ Top ]

void getStandardURL(
string
$path)

Returns the standard path

Changes \ to / Removes the .. and . from the URL

Parameters:

string $path — a valid URL that may contain . or .. and \

[ Top ]

void getStat(
)

Returns an array of statistics about the file (see the PHP stat function for more information)

The returned array may be empty, even if readers should try their best to return as many data as possible

Overridden in child classes as:

File_Archive_Reader_Memory::getStat()

File_Archive_Reader_File::getStat()

File_Archive_Reader_Concat::getStat()

File_Archive_Reader_Tar::getStat()

File_Archive_Reader_Zip::getStat()

File_Archive_Reader_Ar::getStat()

File_Archive_Reader_Relay::getStat()

[ Top ]

a makeAppendWriter(
)

Return a writer that allows appending files to the archive After having called makeAppendWriter, $this is closed and should not be used until the returned writer is closed.

Return: writer that will allow to append files to an existing archive
See: makeWriter

Overridden in child classes as:

File_Archive_Reader_Memory::makeAppendWriter()

File_Archive_Reader_File::makeAppendWriter()

File_Archive_Reader_Gzip::makeAppendWriter()

File_Archive_Reader_Tar::makeAppendWriter()

File_Archive_Reader_Bzip2::makeAppendWriter()

File_Archive_Reader_Zip::makeAppendWriter()

File_Archive_Reader_Ar::makeAppendWriter()

File_Archive_Reader_Relay::makeAppendWriter()

File_Archive_Reader_Uncompress::makeAppendWriter()

File_Archive_Reader_Directory::makeAppendWriter()

[ Top ]

void makeWriterRemove(
)

Returns a writer that removes the current file

This is a syntaxic sugar for makeWriterRemoveFiles(new File_Archive_Predicate_Current());

[ Top ]

void makeWriterRemoveBlocks(
array
$blocks, [int
$seek = 0])

Return a writer that has the same properties as the one returned by makeWriter, but after having removed a block of data from the current file. The writer will append data to the current file no data (other than the block) will be removed

Overridden in child classes as:

File_Archive_Reader_Memory::makeWriterRemoveBlocks()

File_Archive_Reader_File::makeWriterRemoveBlocks()

File_Archive_Reader_Gzip::makeWriterRemoveBlocks()

File_Archive_Reader_Tar::makeWriterRemoveBlocks()

File_Archive_Reader_Bzip2::makeWriterRemoveBlocks()

File_Archive_Reader_Zip::makeWriterRemoveBlocks()

File_Archive_Reader_Ar::makeWriterRemoveBlocks()

File_Archive_Reader_Relay::makeWriterRemoveBlocks()

File_Archive_Reader_Directory::makeWriterRemoveBlocks()

Parameters:

int	`$seek`	—	relative pos of the block
array	`$blocks`	—	Lengths of the blocks. The first one will be discarded, the second one kept, the third one discarded... If the sum of the blocks is less than the size of the file, the comportment is the same as if a last block was set in the array to reach the size of the file if $length is -1, the file is truncated from the specified pos It is possible to specify blocks of size 0

[ Top ]

File_Archive_Writer makeWriterRemoveFiles(
File_Archive_Predicate
$pred)

Return a writer that has the same properties as the one returned by makeAppendWriter, but after having removed all the files that follow a given predicate.

After a call to makeWriterRemoveFiles, $this is closed and should not be used until the returned writer is closed

Return: that allows to append files to the archive

Overridden in child classes as:

File_Archive_Reader_Memory::makeWriterRemoveFiles()

File_Archive_Reader_File::makeWriterRemoveFiles()

File_Archive_Reader_Gzip::makeWriterRemoveFiles()

File_Archive_Reader_Tar::makeWriterRemoveFiles()

File_Archive_Reader_Bzip2::makeWriterRemoveFiles()

File_Archive_Reader_Zip::makeWriterRemoveFiles()

File_Archive_Reader_Ar::makeWriterRemoveFiles()

File_Archive_Reader_Relay::makeWriterRemoveFiles()

File_Archive_Reader_Uncompress::makeWriterRemoveFiles()

File_Archive_Reader_Directory::makeWriterRemoveFiles()

Parameters:

File_Archive_Predicate $pred — the predicate verified by removed files

[ Top ]

bool next(
)

Move to the next file in the reader

Return: false iif no more files are available

Overridden in child classes as:

File_Archive_Reader_Memory::next(): The subclass should overwrite this function to change the filename, stat

File_Archive_Reader_File::next()

File_Archive_Reader_Concat::next()

File_Archive_Reader_Archive::next()

File_Archive_Reader_Gzip::next()

File_Archive_Reader_Tar::next()

File_Archive_Reader_Bzip2::next()

File_Archive_Reader_Zip::next(): Go to next file entry in ZIP archive

File_Archive_Reader_Ar::next()

File_Archive_Reader_Relay::next()

File_Archive_Reader_Select::next()

File_Archive_Reader_Uncompress::next()

File_Archive_Reader_Multi::next()

File_Archive_Reader_Filter::next()

File_Archive_Reader_Directory::next()

[ Top ]

void remove(
)

Removes the current file from the reader

[ Top ]

the rewind(
[int
$length = -1])

Move the current position back of a given amount of bytes.

Not all readers may implement this function (a PEAR error will be returned if the reader can't rewind)

Return: number of bytes really rewinded (which may be less than $length if the current pos is less than $length

Overridden in child classes as:

File_Archive_Reader_Memory::rewind()

File_Archive_Reader_File::rewind()

File_Archive_Reader_Concat::rewind()

File_Archive_Reader_Gzip::rewind()

File_Archive_Reader_Tar::rewind()

File_Archive_Reader_Bzip2::rewind()

File_Archive_Reader_Zip::rewind()

File_Archive_Reader_Ar::rewind()

File_Archive_Reader_Relay::rewind()

Parameters:

int $length — number of bytes to seek before the current pos or -1 to move back to the begining of the current file

[ Top ]

bool select(
string
$filename, [bool
$close = true])

Move to the next file whose name is in directory $filename or is exactly $filename

Return: whether the file was found in the archive or not

Overridden in child classes as:

File_Archive_Reader_Uncompress::select()

Parameters:

string	`$filename`	—	Name of the file to find in the archive
bool	`$close`	—	If true, close the reader and search from the first file

[ Top ]

void sendData(

&$writer, [
$bufferSize = 102400])

Sends the current file to the Writer $writer

The data will be sent by chunks of at most $bufferSize bytes

Parameters:

	`&$writer`	—
	`$bufferSize`	—

[ Top ]

void skip(
[
$length = -1])

Skip some data and returns how many bytes have been skipped

This is strictly equivalent to return strlen(getData($length)) But could be far more efficient

Overridden in child classes as:

File_Archive_Reader_Memory::skip()

File_Archive_Reader_File::skip()

File_Archive_Reader_Concat::skip()

File_Archive_Reader_Gzip::skip()

File_Archive_Reader_Tar::skip()

File_Archive_Reader_Zip::skip()

File_Archive_Reader_Ar::skip()

File_Archive_Reader_Relay::skip()

Parameters:

$length —

[ Top ]

Class: File_Archive_Reader

Class Overview

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Method Detail

close [line 220]

extract [line 262]

Parameters:

extractFile [line 307]

Parameters:

getData [line 180]

Parameters:

getDataFilename [line 172]

getFileList [line 131]

getFilename [line 118]

getMime [line 158]

getStandardURL [line 95]

Parameters:

getStat [line 152]

makeAppendWriter [line 341]

makeWriterRemove [line 366]

makeWriterRemoveBlocks [line 396]

Parameters:

makeWriterRemoveFiles [line 357]

Parameters:

next [line 48]

remove [line 375]

rewind [line 211]

Parameters:

select [line 61]

Parameters:

sendData [line 228]

Parameters:

skip [line 191]

Parameters: