ZipArchive::addGlob

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

ZipArchive::addGlobAdicionar arquivos de um diretório por padrão glob

Descrição

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

Adiciona arquivos de um diretório que correspondem ao pattern glob.

Nota: Para portabilidade máxima, é recomendável sempre usar barras normais (/) como separador de diretório em nomes de arquivos ZIP.

Parâmetros

pattern

Um padrão glob() contra o qual os arquivos serão correspondidos.

flags

Uma máscara de bits de opções glob().

options

Um array associativo de opções. As opções disponíveis são:

  • "add_path"

    Prefixo a ser adicionado ao traduzir para o caminho local do arquivo dentro do arquivo. Isso é aplicado após quaisquer operações de remoção definidas pelas opções "remove_path" ou "remove_all_path".

  • "remove_path"

    Prefixo a ser removido dos caminhos de arquivo correspondentes antes de serem adicionados ao arquivo.

  • "remove_all_path"

    true para usar apenas o nome do arquivo e adicionar à raiz do arquivo.

  • "flags"

    Máscara de bits consistindo em ZipArchive::FL_OVERWRITE, ZipArchive::FL_ENC_GUESS, ZipArchive::FL_ENC_UTF_8, ZipArchive::FL_ENC_CP437, ZipArchive::FL_OPEN_FILE_NOW. O comportamento dessas constantes é descrito na página de constantes ZIP.

  • "comp_method"

    Método de compressão, um dos constantes ZipArchive::CM_*, consulte a página de constantes ZIP.

  • "comp_flags"

    Nível de compressão.

  • "enc_method"

    Método de criptografia, um dos constantes ZipArchive::EM_*, consulte a página de constantes ZIP.

  • "enc_password"

    Senha usada para criptografia.

Valor Retornado

Um array de arquivos adicionados em caso de sucesso ou false em caso de falha

Registro de Alterações

Versão Descrição
8.0.0 / 1.18.0 "flags" em options foi adicionado.
8.0.0 / 1.18.1 "comp_method", "comp_flags", "enc_method" e "enc_password" em options foram adicionados.
8.3.0 / 1.22.1 ZipArchive::FL_OPEN_FILE_NOW foi adicionado.

Exemplos

Exemplo #1 Exemplo de ZipArchive::addGlob()

Adiciona todos os scripts php e arquivos de texto do diretório de trabalho atual

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

Veja Também