boolean create (
mixed $filelist
)
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.
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.
boolean
- Returns TRUE on success, FALSE on failure.
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 |
This function can not be called statically.
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");
?>