PharData::addFile

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

PharData::addFileAdiciona um arquivo do sistema de arquivos ao arquivo tar/zip

Descrição

public PharData::addFile(string $filename, ?string $localName = null): void

Com este método, qualquer arquivo ou URL pode ser adicionado ao arquivo tar/zip. Se o segundo parâmetro opcional localname for especificado, o arquivo será armazenado no arquivo com esse nome; caso contrário, o parâmetro file será usado como caminho para armazenamento no arquivo. URLs devem ter um localname, ou uma exceção será lançada. Este método é semelhante a ZipArchive::addFile().

Parâmetros

filename

Caminho completo ou relativo para um arquivo no disco a ser adicionado ao arquivo phar.

localName

Caminho onde o arquivo será armazenado no arquivo compactado.

Valor Retornado

Nenhum valor de retorno, exceção é lançada em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 localName agora é anulável.

Exemplos

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

<?php
try {
$a = new PharData('/caminho/para/meu.tar');

$a->addFile('/caminho/completo/para/arquivo');
// demonstra como este arquivo é armazenado
$b = $a['/caminho/completo/para/arquivo']->getContent();

$a->addFile('/caminho/completo/para/arquivo', 'meu/arquivo.txt');
$c = $a['meu/arquivo.txt']->getContent();

// demonstra o uso de URL
$a->addFile('http://www.example.com', 'example.html');
} catch (
Exception $e) {
// manipula erros aqui
}
?>

Notas

Nota: PharData::addFile(), PharData::addFromString() e PharData::offsetSet() salvam um novo arquivo phar cada vez que são chamadas. Se o desempenho for uma preocupação, PharData::buildFromDirectory() ou PharData::buildFromIterator() devem ser usadas.

Veja Também

adicione uma nota

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

Não há notas de usuários para esta página.
To Top