PEAR Manual
Prev |  | Next

# Archive_Tar::add()

Archive_Tar::add() -- add files or directories

## Synopsis

    require_once 'Archive/Tar.php';

``boolean add` (mixed $filelist)`

## Description

This method adds files and directories to an existing archive. If the archive does not exist, it attempts to create it. The files and directories listed are added at the end of the archive, even if a file with the same name is already archived.

## 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

Table 38-1. 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

Example 38-1. Add files to a compressed archive
    $tar_object = new Archive_Tar("tarname.tar.gz", true);
    $v_list[0]="dev/file.txt";
    $v_list[1]="dev/data/";
    $v_list[2]="log/file.log";
    $tar_object->add($v_list);

Prev | Home | Next
Archive_Tar::Archive_Tar() | Up | Archive_Tar::addModify()