|
Phar::buildFromIteratorConstruct a phar archive from an iterator Description
public array Phar::buildFromIterator(Traversable
$iterator , stringnull $baseDirectory = null )
Populate a phar archive from an iterator. Two styles of iterators are supported, iterators that map the filename within the phar to the name of a file on disk, and iterators like DirectoryIterator that return SplFileInfo objects. For iterators that return SplFileInfo objects, the second parameter is required. Parameters
Return ValuesPhar::buildFromIterator returns an associative array mapping internal path of file to the full path of the file on the filesystem. Errors/Exceptions
This method returns UnexpectedValueException when the
iterator returns incorrect values, such as an integer key instead of a
string, a BadMethodCallException when an
SplFileInfo-based iterator is passed without a Changelog
ExamplesExample #1 A Phar::buildFromIterator with SplFileInfo For most phar archives, the archive will reflect an actual directory layout, and the second style is the most useful. For instance, to create a phar archive containing the files in this sample directory layout:
/path/to/project/ config/ dist.xml debug.xml lib/ file1.php file2.php src/ processthing.php www/ index.php cli/ index.php This code could be used to add these files to the "project.phar" phar archive:
The file project.phar can then be used immediately. Phar::buildFromIterator does not set values such as compression, metadata, and this can be done after creating the phar archive. As an interesting note, Phar::buildFromIterator can also be used to copy the contents of an existing phar archive, as the Phar object descends from DirectoryIterator:
Example #2 A Phar::buildFromIterator with other iterators The second form of the iterator can be used with any iterator that returns a key => value mapping, such as an ArrayIterator:
See Also
|