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é.

Paramètres

Valeur retournée

boolean - Renvoie TRUE en cas de succès, FALSE en cas d'échec.

Valeurs renvoyées

Tableau 39-1. Valeurs PEAR_Error possibles

Code erreurMessage d'erreurRaisonSolution
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 filenamein 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

Cette fonction ne peut pas être appelée de façon statique.

Exemple

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.