PharData::addFile
Add a file from the filesystem to the tar/zip archive
Description
public void PharData::addFile(string $filename
, stringnull $localName
= null
)
Parameters
-
filename
-
Full or relative path to a file on disk to be added
to the phar archive.
-
localName
-
Path that the file will be stored in the archive.
Return Values
no return value, exception is thrown on failure.
Examples
Example #1 A PharData::addFile example
<?php
try {
$a = new PharData('/path/to/my.tar');
$a->addFile('/full/path/to/file');
// demonstrates how this file is stored
$b = $a['full/path/to/file']->getContent();
$a->addFile('/full/path/to/file', 'my/file.txt');
$c = $a['my/file.txt']->getContent();
// demonstrate URL usage
$a->addFile('http://www.example.com', 'example.html');
} catch (Exception $e) {
// handle errors here
}
?>
Notes
Note:
PharData::addFile, PharData::addFromString and PharData::offsetSet
save a new phar archive each time they are called. If performance is a concern,
PharData::buildFromDirectory or PharData::buildFromIterator
should be used instead.
See Also
- PharData::offsetSet
- Phar::addFile
- PharData::addFromString
- PharData::addEmptyDir