Archive_Tar::create() (Previous) (Next) Archive_Tar::extract()
View this page in Last updated: Mon, 02 Jul 2007
English | Dutch | French | German | Hungarian | Japanese | Polish | Russian | Spanish | Plain HTML

Archive_Tar::createModify()

Archive_Tar::createModify() -- create a new archive

Synopsis

require_once 'Archive/Tar.php';

boolean createModify (array $filelist, string $add_dir [, string $remove_dir = ''])

Описание

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

If the file already exists and is writable, it is replaced by the new tar. It is a 'create' and not a 'add'. If the file exists and is read-only or is a directory, it is not replaced.

Параметр

  • mixed $filelist - an array of filenames and directory names, or a single string with names separated by a single blank space.

  • string $add_dir - contains a path to be added to the memorized path of each element in the list.

  • string $remove_dir - contains a path to be removed from the memorized path of each element in the list, when relevant. Default is an empty string.

Возвращаемое значение

boolean - Возвращает TRUE в случае успеха и FALSE при неудаче.

Throws

Таблица 40-1. Возможные значения PEAR_Error

Error codeError messageReasonSolution
NULL"Invalid file list"The argument for the function is not correctly formatted or build. Check for typing mistakes in the argument

Заметка

Эта функция не должна вызываться статически.

Пример

Пример 40-1. Create a new compressed archive in a new directory


<?php
$tar_object = new Archive_Tar("tarname.tgz", true);
$tar_object->setErrorHandling(PEAR_ERROR_PRINT);
$v_list[0]="dev/file.txt";
$v_list[1]="dev/data/";
$v_list[2]="log/file.log";
$tar_object->createModify($v_list, "install", "dev");
// files are stored in the archive as :
//   install/file.txt
//   install/data
//   install/data/file1.txt
//   install/data/... all the files and sub-dirs of data/
//   install/log/file.log
?>

Пример 40-2. Create a new compressed archive in a new directory (especially for Windows) 


<?php
$tar_object = new Archive_Tar("tarname.tgz", true);
$tar_object->setErrorHandling(PEAR_ERROR_PRINT);
$v_list[0]="c:\\dev\\file.txt";
$v_list[1]="c:\\dev\\data\\";
$v_list[2]="c:\\log\\file.log";
$tar_object->createModify($v_list, "install/temp", "c:\\dev");
// files are stored in the archive as :
//   install/temp/file.txt
//   install/temp/data
//   install/temp/data/file1.txt
//   install/temp/data/... all the files and sub-dirs of data/
//   install/temp/log/file.log
?>
Archive_Tar::create() (Previous) (Next) Archive_Tar::extract()
Download Documentation Last updated: Mon, 02 Jul 2007
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
There are no user contributed notes for this page.