Користење на Phar архиви: Phar и PharData класа
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
Користење на Phar архиви: Phar и PharData класа
Референца за `phar.using.object.php` со подобрена типографија и навигација.
Користење на Phar архиви: Phar и PharData класа
На за да работи за class supports reading and manipulation of Phar archives, as well as iteration through inherited functionality of the RecursiveDirectoryIterator class. With support for the ArrayAccess interface, files inside a Phar archive can be accessed as if they were part of an associative array.
На PharData class extends the за да работи за, and allows creating and modifying non-executable (data) tar and zip archives even if
phar.readonly=1 in php.ini. As such,
PharData::setAlias() and PharData::setStub()
are both disabled as the concept of alias and stub are unique to executable phar archives.
It is important to note that when creating a Phar archive, the full path should be passed to the за да работи за object constructor. Relative paths will fail to initialize.
Assuming that $p is a Phar object initialized as follows:
<?php
$p = new Phar('/path/to/myphar.phar', 0, 'myphar.phar');
?>
An empty Phar archive will be created at /path/to/myphar.phar, or if /path/to/myphar.phar already exists, it will be opened again. The literal myphar.phar demonstrates the concept of an alias that can be used to reference /path/to/myphar.phar in URLs as in:
<?php
// these two calls to file_get_contents() are equivalent if
// /path/to/myphar.phar has an explicit alias of "myphar.phar"
// in its manifest, or if the phar was initialized with the
// previous example's Phar object setup
$f = file_get_contents('phar:///path/to/myphar.phar/whatever.txt');
$f = file_get_contents('phar://myphar.phar/whatever.txt');
?>
With the newly created $p за да работи за object, the following is possible:
-
$a = $p['file.php']креира PharFileInfo class that refers to the contents ofphar://myphar.phar/file.php -
$p['file.php'] = $vcreates a new file (phar://myphar.phar/file.php), or overwrites an existing file withinmyphar.phar.$vcan be either a string or an open file pointer, in which case the entire contents of the file will be used to create the new file. Note that$p->addFromString('file.php', $v)is functionally equivalent to the above. Also possible is to add the contents of a file with$p->addFile('/path/to/file.php', 'file.php'). Lastly, an empty directory can be created with$p->addEmptyDir('empty'). -
isset($p['file.php'])can be used to determine whetherphar://myphar.phar/file.phpexists withinmyphar.phar. -
unset($p['file.php'])erasesphar://myphar.phar/file.phpfrommyphar.phar.
In addition, the за да работи за object is the only way to access Phar-specific metadata, through = FilesystemIterator::SKIP_DOTS | FilesystemIterator::UNIX_PATHS, and the only way to set or retrieve a Phar archive's PHP loader stub through ако било кој од параметрите е подолг од 400 бајти. and Phar::createDefaultStub(). Additionally, compression for the entire Phar archive at once can only be manipulated using the за да работи за class.
The full list of за да работи за object functionality is documented below.
На PharFileInfo class extends the SplFileInfo class, and adds several methods for manipulating Phar-specific details of a file contained within a Phar, such as manipulating compression and metadata.