Archive_Tar::create()

Archive_Tar::create() – create archive file

Synopsis

require_once 'Archive/Tar.php';

boolean create ( mixed $filelist )

Description

This method creates the archive file and adds the listed files or directories.

If a file with the same tar name exists and is writable, it is replaced by the new tar archive (it is not an 'add', but a 'create'). If a file exists and is write-protected or is a folder, the method raises a PEAR_Error.

Parameter

  • mixed $filelist - an array of filenames and directory names, or a single string with names separated by a single blank space. For each directory added in the archive, the files and sub-directories are also added.

Return value

boolean - Returns TRUE on success, FALSE on failure.

Throws

Possible PEAR_Error values
Error code Error message Reason Solution
NULL "Invalid file list" The argument for the function is not correct formatted or build. Check for typing mistakes in the argument

Note

This function can not be called statically.

Example

Creating an archive

<?php
$tar_object 
= new Archive_Tar("myArchive.tar");

// print errors
$tar_object->setErrorHandling(PEAR_ERROR_PRINT);  

// Archive content
$v_list[0]="file.txt";
// the slash is optional
$v_list[1]="data/"
$v_list[2]="file.log";

// create the archive
$tar_object->create($v_list);
?>

Creating a compressed archive, use a string as create() argument

<?php
$tar_object 
= new Archive_Tar("tarname.tgz"true);
$tar_object->setErrorHandling(PEAR_ERROR_PRINT);
$tar_object->create("file.txt data/ file.log");
?>