ZipArchive::addGlob

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL zip >= 1.9.0)

ZipArchive::addGlob — Ajoute des fichiers d'un dossier en utilisant un masque glob

Description

public ZipArchive::addGlob(string $pattern, int $flags = 0, array $options = []): array|false

Ajoute des fichiers d'un dossier qui correspondent à un masque glob pattern.

Note: Pour une portabilité maximale, il est recommandé de toujours utiliser des barres obliques (/) comme séparateur de dossier dans les noms de fichiers zip.

Liste de paramètres

pattern

Un masque glob().

flags

Un masque d'octets de drapeaux glob().

options

Un tableau associatif d'options. Les options disponibles sont :

  • "add_path"

    Préfixe à ajouter lors de la traduction du chemin local du fichier dans l'archive. Il sera appliqué après les opérations de suppression définies par l'option "remove_path" ou l'option "remove_all_path".

  • "remove_path"

    Préfixe à supprimer des chemins des fichiers avant de les ajouter à l'archive.

  • "remove_all_path"

    true pour utiliser le nom du fichier uniquement, et ajouter les fichiers directement à la racine de l'archive.

  • "flags"

    Masque de bit consistant de ZipArchive::FL_OVERWRITE, ZipArchive::FL_ENC_GUESS, ZipArchive::FL_ENC_UTF_8, ZipArchive::FL_ENC_CP437, ZipArchive::FL_OPEN_FILE_NOW. Le comportement de ces constantes est décrites sur la page des constantes ZIP.

  • "comp_method"

    Méthode de compression, l'une des constantes ZipArchive::CM_*, voir la pages des constantes ZIP.

  • "comp_flags"

    Niveau de compression.

  • "enc_method"

    Méthode de chiffrement, l'une des constantes ZipArchive::EM_*, voir la pages des constantes ZIP.

  • "enc_password"

    Mot de passe utilisé pour le chiffrement.

Valeurs de retour

Un tableau des fichiers ajoutée en cas de succès ou false si une erreur survient

Historique

Version Description
8.0.0 / 1.18.0 flags a été ajouté.
8.0.0 / 1.18.1 "comp_method", "comp_flags", "enc_method" et "enc_password" dans options ont été ajouté.
8.3.0 / 1.22.1 ZipArchive::FL_OPEN_FILE_NOW a été ajouté.

Exemples

Exemple #1 Exemple avec ZipArchive::addGlob()

Ajoute tous les scripts PHP et les fichiers textes du dossier courant.

<?php
$zip = new ZipArchive();
$ret = $zip->open('application.zip', ZipArchive::CREATE | ZipArchive::OVERWRITE);
if ($ret !== TRUE) {
printf("A échoué avec le code d'erreur %d", $ret);
} else {
$options = array('add_path' => 'sources/', 'remove_all_path' => TRUE);
$zip->addGlob('*.{php,txt}', GLOB_BRACE, $options);
$zip->close();
}
?>

Voir aussi