(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::addFile — Adiciona um arquivo do sistema de arquivos ao arquivo tar/zip
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().
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.
Nenhum valor de retorno, exceção é lançada em caso de falha.
Versão | Descrição |
---|---|
8.0.0 |
localName agora é anulável.
|
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
}
?>
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.