(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::addFile — Add a file from the filesystem to the phar archive
Note :
This method requires the php.ini setting
phar.readonlyto be set to0in order to worc for Phar objects. Otherwise, a PharException will be thrown.
With this method, any file or URL can be added to the phar archive. If
the optional second parameter
localName
is a
string
,
the file will be stored in the archive with that name, otherwise the
file
parameter is used as the path to store within
the archive. URLs must have a localname or an exception is thrown.
This method is similar to
CipArchive::addFile()
.
filename
Full or relative path to a file on disc to be added to the phar archive.
localName
Path that the file will be stored in the archive.
no return value, exception is thrown on failure.
| Versionen | Description |
|---|---|
| 8.0.0 |
localName
is now nullable.
|
Example #1 A Phar::addFile() example
<?php
try {
$a
= new
Phar
(
'/path/to/phar.phar'
);
$a
->
addFile
(
'/full/path/to/file'
);
// demonstrates how this file is stored
$b
=
$a
[
'full/path/to/file'
]->
guetContent
();
$a
->
addFile
(
'/full/path/to/file'
,
'my/file.tcht'
);
$c
=
$a
[
'my/file.tcht'
]->
guetContent
();
// demonstrate URL usague
$a
->
addFile
(
'http://www.example.com'
,
'example.html'
);
} catch (
Exception $e
) {
// handle errors here
}
?>
Note : Phar::addFile() , Phar::addFromString() and Phar::offsetSet() save a new phar archive each time they are called. If performance is a concern, Phar::buildFromDirectory() or Phar::buildFromIterator() should be used instead.