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.
Table 44-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|
Example 44-1. Creating an archive
Example 44-2. Creating a compressed archive, use a string as create() argument