PharData::buildFromDirectory

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

PharData::buildFromDirectoryConstrói um arquivo tar/zip a partir dos arquivos dentro de um diretório

Descrição

public PharData::buildFromDirectory(string $directory, string $pattern = ""): array

Preenche um arquivo tar/zip a partir do conteúdo do diretório. O segundo parâmetro opcional é uma expressão regular (pcre) usada para excluir arquivos. Qualquer nome de arquivo que corresponda à expressão regular será incluído, todos os outros serão excluídos. Para um controle mais refinado, use PharData::buildFromIterator().

Parâmetros

directory

O caminho completo ou relativo para o diretório que contém todos os arquivos a serem adicionados ao arquivo.

pattern

Uma expressão regular pcre opcional usada para filtrar a lista de arquivos. Somente caminhos de arquivo que correspondam à expressão regular serão incluídos no arquivo.

Valor Retornado

Phar::buildFromDirectory() retorna um array associativo mapeando o caminho interno do arquivo para o caminho completo do arquivo no sistema de arquivos, ou false em caso de falha.

Erros/Exceções

Este método lança BadMethodCallException quando não é possível instanciar os iteradores de diretório interno, ou uma PharException se houver erros ao salvar o arquivo phar.

Registro de Alterações

Versão Descrição
8.1.0 PharData::buildFromDirectory() não retorna mais false.

Exemplos

Exemplo #1 Um exemplo de PharData::buildFromDirectory()

<?php
$phar
= new PharData('project.tar');
// adiciona todos os arquivos no projeto
$phar->buildFromDirectory(dirname(__FILE__) . '/project');

$phar2 = new PharData('project2.zip');
// adiciona todos os arquivos no projeto, inclui somente arquivos php
$phar2->buildFromDirectory(dirname(__FILE__) . '/project', '/\.php$/');
?>

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês) 1 note

up
0
dan
5 years ago
buildFromDirectory won't add empty subdirectories on 7.2
To Top