Archive_Tar::addModify()

Archive_Tar::addModify() – Ajout des fichiers ou des dossiers

Synopsis

require_once 'Archive/Tar.php';

boolean addModify ( mixed $filelist , string $add_dir , string $remove_dir = '' )

Description

Cette méthode ajoute des fichiers et des dossiers listés dans le paramètres filelist à la fin de l'archive existante.

Si l'archive n'existe pas, on tentera de la créer. Si un fichier ou un dossier est déjà présent dans l'archive, ils seront ajoutés à la fin de l'archive. Il n'y aura pas de mise à jour des fichiers ou des dossiers existants dans l'archive. Cependant, lors de l'extraction de l'archive, le dernier fichier remplacera le premier. Ce résultat est une non-optimisation de la taille de l'archive. Si un fichier ou un dossier n'existe pas, il sera ignoré.

Parameter

  • mixed $filelist - un tableau de noms de fichiers et de dossiers, ou une chaîne avec les noms séparés par un seul espace.

  • string $add_dir - une chaîne qui contient un chemin à ajouter dans le chemin de chaque élément de la liste.

  • string $remove_dir - une chaîne qui contient un chemin à enlever du chemin de chaque élément de la liste.

    Le chemin indiqué par add_dir sera ajouté au début du chemin de chaque fichier/dossier de la liste. Cependant, il peut être défini comme vide ''. L'ajout d'un chemin est effectué après la suppression d'un chemin. Le chemin ajouté/enlevé permet à l'utilisateur de préparer une archive pour son extraction dans un chemin différent que l'original.

Return value

boolean - Returns TRUE on success, FALSE on failure.

Throws

Possible PEAR_Error values
Code erreur Message d'erreur Raison Solution
NULL "Invalid file list" L'argument de la fonction n'est pas correctement formatté. Vérifiez si vous n'avez pas fait d'erreur dans l'argument.
NULL "Unable to open in write mode file name " Les permissons de fichier pour un fichier existant ne permet pas l'écriture ou le fichier est verrouillé. Vérifiez les permissions et éventuellement les programmes accédant à ce fchier.
NULL "Invalid file list" L'archive est vide ou corrompue.
NULL "File filename does not exist" Un fichier que vous voulez ajouter à l'archive n'existe pas. Vérifiez que vous n'avez pas fait d'erreurs dans l'argument de la fonction.
NULL "Directory dirname can not be read" Un dossier ou un fichier que vous voulez ajouter à l'archive n'existe pas ou les permissions en lecture du dossier ne permettent pas l'accès. Vérifiez que vous n'avez pas fait d'erreurs dans l'argument de la fonction ainsi que dans les permissions.
NULL "Unable to open file filename in binary read mode" Le fichier à ajouter à l'archive ne peut pas être lu. Vérifiez que vous n'avez pas fait d'erreurs dans l'argument de la fonction ainsi que dans les permissions.

Note

This function can not be called statically.

Example

Ajout de fichiers dans une archive compressée dans un nouveau dossier

<?php
$tar_object 
= new Archive_Tar("tarname.tar");
$v_list[0]="dev/file.txt";
$v_list[1]="dev/data/";
$v_list[2]="log/file.log";
$tar_object->addModify($v_list"install");
// Les fichiers sont stockés dans l'archive sous la forme :
//   install/file.txt
//   install/data
//   install/data/file1.txt
//   install/data/... tous les fichiers et sous-dossiers de data/
//   install/file.log
?>

Ajout de fichiers dans une archive compressé déplacée dans une nouveau dossier

<?php
$tar_object 
= new Archive_Tar("tarname.tar");
$v_list[0]="dev/file.txt";
$v_list[1]="dev/data/";
$v_list[2]="log/file.log";
$tar_object->addModify($v_list"install""dev");
// Les fichiers sont stockés dans l'archive sous la forme :
//   install/file.txt
//   install/data
//   install/data/file1.txt
//   install/data/... tous les fichiers et sous-dossiers de data/
//   install/log/file.log
?>

Ajout de fichiers dans une archive compressée déplacée dans un nouveau dossier (tout spécialement pour Windows)

<?php
$tar_object 
= new Archive_Tar("tarname.tar");
$v_list[0]="d:\\dev\\file.txt";
$v_list[1]="d:\\dev\\data\\";
$v_list[2]="d:\\log\\file.log";
$tar_object->addModify($v_list"install/temp""d:\\dev");
// Les fichiers sont stockés dans l'archive sous la forme :
//   install/temp/file.txt
//   install/temp/data
//   install/temp/data/file1.txt
//   install/temp/data/...  tous les fichiers et sous-dossiers de data/
//   install/temp/log/file.log
?>

Pour les systèmes Windows, le format de chemin Windows peut être utilisé. Cependant, si les fichiers utilisent le chemin Windows, le paramètre $remove_dir doit également être dans un format de chemin Windows. Le paramètre $add_dir peut être en format Windows ou Unix.

Ajoute des fichiers ou des dossiers (Previous) Crée une archive (Next)
Last updated: Sun, 29 Aug 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.