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

ZipArchive::addFile() - Ajoute un fichier à l'archive ZIP depuis le chemin fourni
ZipArchive::addPattern() - Ajoute des fichiers d'un dossier en utilisant une expression régulière PCRE

add a note

User Contributed Notes 6 notes

down

johnsmith at na dot com ¶

9 years ago


Neither 'remove_all_path' or 'remove_path' options seem to be workng

down

Francesc Pineda Segarra ¶

7 years ago


For me the better way seems to be:

$options = array('add_path' => DIRECTORY_SEPARATOR, 'remove_all_path' => TRUE);

On Windows uses \, on others /

down

sunbinzzzzz at gmail dot com ¶

8 years ago


Yes!! neither 'remove_all_path' or 'remove_path'  be working，if you want the right result，you should like this， $option = array( 'add_path' => '/', 'remove_all_path' => 'your path' );   'add_path' just give a '/'， then you will (; 。

down

hkn06tr at gmail dot com ¶

10 months ago


The following all works:
---------
Ex-1:
Nearly all files for 5 level recursively are zipped:
$zip->addGlob("*.*");
$zip->addGlob("*/*.*");
$zip->addGlob("*/*/*.*");
$zip->addGlob("*/*/*/*.*");
$zip->addGlob("*/*/*/*/*.*");
$zip->addGlob("*/*/*/*/*/*.*"); // 5th
---------
Ex-2:
$zip->addGlob("library/*.*");
all files under library
---------
Ex-3:
$zip->addGlob("*/*.[cpj]*");  
Means all files starting with cpj
So they all included
css
php
js
---------
Ex-4:
$zip->addGlob("*/*.[cpj][sh]*");
Take guarantee:
css 
php
js
---------
Ex-5 Bonus:
More complicated:
$zip->addGlob("[ab]*/c*/*.[cpjth][shxt]*");
All folder starting with a or b and then in subfolder must start with c but only those files:
css php txt js html

down

zckernel at gmail dot com ¶

9 years ago


Doesn't work with the following options:
$options = array('remove_all_path' => TRUE);
$zipArchive->addGlob($path."/*", GLOB_BRACE, $options);

The full path to file is adding to the archive.

Works well if:
$options = array('add_path' => './','remove_all_path' => TRUE);

down

-1

sumariva at gmail dot com ¶

9 years ago


As others suggested, to remove all paths, use the space as basepath.
Zip opened with builtin utility on a Windows XP and WinRAR.

$options = array('add_path' => ' ','remove_all_path' => TRUE);

Thanks for all contributers.

add a note