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é.
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.
Tableau 39-1. Valeurs PEAR_Error possibles
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 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. |
Exemple 39-1. Ajout de fichiers dans une archive compressée dans un nouveau dossier
|
Exemple 39-2. Ajout de fichiers dans une archive compressé déplacée dans une nouveau dossier
|
Exemple 39-3. Ajout de fichiers dans une archive compressée déplacée dans un nouveau dossier (tout spécialement pour Windows)
|
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.
Précédent | Sommaire | Suivant |
Archive_Tar::add() | Niveau supérieur | Archive_Tar::create() |