If the file already exists and is writable, it is replaced by the
new tar. It is a create and not an add. If the file exists and is
read-only or is a directory it is not replaced. The method return
false and a PEAR error text.
The $p_filelist parameter can be an array of string, each string
representing a filename or a directory name with their path if
needed. It can also be a single string with names separated by a
single blank.
The path indicated in $p_remove_dir will be removed from the
memorized path of each file / directory listed when this path
exists. By default nothing is removed (empty path '')
The path indicated in $p_add_dir will be added at the beginning of
the memorized path of each file / directory listed. However it can
be set to empty ''. The adding of a path is done after the removing
of path.
The path add/remove ability enables the user to prepare an archive
for extraction in a different path than the origin files are.
See also addModify() method for file adding properties.
public createModify ( array $p_filelist, string $p_add_dir, string $p_remove_dir = '' ) : boolean | ||
$p_filelist | array | An array of filenames and directory names, or a single string with names separated by a single blank space. |
$p_add_dir | string | A string which contains a path to be added to the memorized path of each element in the list. |
$p_remove_dir | string | A string which contains a path to be removed from the memorized path of each element in the list, when relevant. |
return | boolean | true on success, false on error. |