1. class
  2. Drupal
  3. \
  4. system
  5. \
  6. Plugin
  7. \
  8. Archiver
  9. \
  10. Tar

Tar

class Tar extends Tar (View source)

Defines an archiver implementation for .tar files.

Properties

protected ArchiveTar $tar

The underlying ArchiveTar instance that does the heavy lifting.

 from  Tar

Methods

__construct(string $file_path)

Constructs a Tar object.

from  Tar
$this
add(string $file_path)

Adds the specified file or directory to the archive.

from  Tar
$this
remove($file_path)

Removes the specified file from the archive.

from  Tar
$this
extract(string $path, array $files = [])

Extracts multiple files in the archive to the specified path.

from  Tar
array
listContents()

Lists all files in the archive.

from  Tar
Archive_Tar
getArchive()

Retrieves the tar engine itself.

from  Tar

Details

in Tar at line 27
__construct(string $file_path)

Constructs a Tar object.

Parameters

string $file_path

The full system path of the archive to manipulate. Only local files are supported. If the file does not yet exist, it will be created if appropriate.

Exceptions

ArchiverException

in Tar at line 34
$this add(string $file_path)

Adds the specified file or directory to the archive.

Parameters

string $file_path

The full system path of the file or directory to add. Only local files and directories are supported.

Return Value

$this

The called object.

in Tar at line 43
$this remove($file_path)

Removes the specified file from the archive.

Parameters

$file_path

Return Value

$this

The called object.

in Tar at line 55
$this extract(string $path, array $files = [])

Extracts multiple files in the archive to the specified path.

Parameters

string $path

A full system path of the directory to which to extract files.
array $files

Optionally specify a list of files to be extracted. Files are relative to the root of the archive. If not specified, all files in the archive will be extracted.

Return Value

$this

The called object.

in Tar at line 69
array listContents()

Lists all files in the archive.

Return Value

array

An array of file names relative to the root of the archive.

in Tar at line 87
Archive_Tar getArchive()

Retrieves the tar engine itself.

In some cases it may be necessary to directly access the underlying Archive_Tar object for implementation-specific logic. This is for advanced use only as it is not shared by other implementations of ArchiveInterface.

Return Value

Archive_Tar

The Archive_Tar object used by this object.