Using Phar Archives: the phar stream wrapper

目录搜索

文字

The Phar stream wrapper fully supports fopen() for read and write (not append), unlink() , stat() , fstat() , fseek() , rename() and directory stream operations opendir() and as of version 2.0.0, rmdir() and mkdir() .

Individual file compression and per-file metadata can also be manipulated in a Phar archive using stream contexts:

  <?php
$context  =  stream_context_create (array( 'phar'  =>
                                    array( 'compress'  =>  Phar :: GZ )),
                                    array( 'metadata'  => array( 'user'  =>  'cellog' )));
 file_put_contents ( 'phar://my.phar/somefile.php' ,  0 ,  $context );
 ?>

The phar stream wrapper does not operate on remote files, and cannot operate on remote files, and so is allowed even when the allow_url_fopen and allow_url_include INI options are disabled.

Although it is possible to create phar archives from scratch just using stream operations, it is best to use the functionality built into the Phar class. The stream wrapper is best used for read-only operations.

用户评论:

[#1] staff at pro-unreal dot de [2011-06-08 22:52:04]

Please note that the phar stream wrapper does not work with any glob.
When you decide to move your project to phar archives you need to consider this.

The following won't work:
<?php glob('phar://some.phar

public void addEmptyDir ( string $dirname )

public void addFile ( string $file [, string $localname ] )

public void addFromString ( string $localname , string $contents )

final public static string apiVersion ( void )

public array buildFromDirectory ( string $base_dir [, string $regex ] )

public array buildFromIterator ( Iterator $iter [, string $base_directory ] )

final public static bool canCompress ([ int $type = 0 ] )

final public static bool canWrite ( void )

public object compress ( int $compression [, string $extension ] )

public bool compressAllFilesBZIP2 ( void )

public bool compressAllFilesGZ ( void )

public void compressFiles ( int $compression )

public __construct ( string $fname [, int $flags [, string $alias ]] )

public PharData convertToData ([ int $format = 9021976 [, int $compression = 9021976 [, string $extension ]]] )

public Phar convertToExecutable ([ int $format = 9021976 [, int $compression = 9021976 [, string $extension ]]] )

public bool copy ( string $oldfile , string $newfile )

public int count ( void )

final public static string createDefaultStub ([ string $indexfile [, string $webindexfile ]] )

public object decompress ([ string $extension ] )

public bool decompressFiles ( void )

public bool delMetadata ( void )

public bool delete ( string $entry )

public bool extractTo ( string $pathto [, string|array $files [, bool $overwrite = false ]] )

public mixed getMetadata ( void )

public bool getModified ( void )

public array getSignature ( void )

public string getStub ( void )

final public static array getSupportedCompression ( void )

final public static array getSupportedSignatures ( void )

public string getVersion ( void )

public bool hasMetadata ( void )

final public static void interceptFileFuncs ( void )

public bool isBuffering ( void )

public mixed isCompressed ( void )

public bool isFileFormat ( int $format )

final public static bool isValidPharFilename ( string $filename [, bool $executable = true ] )

public bool isWritable ( void )

final public static bool loadPhar ( string $filename [, string $alias ] )

final public static bool mapPhar ([ string $alias [, int $dataoffset = 0 ]] )

final public static void mount ( string $pharpath , string $externalpath )

final public static void mungServer ( array $munglist )

public bool offsetExists ( string $offset )

public int offsetGet ( string $offset )

public void offsetSet ( string $offset , string $value )

public bool offsetUnset ( string $offset )

final public static string running ([ bool $retphar = true ] )

public bool setAlias ( string $alias )

public bool setDefaultStub ([ string $index [, string $webindex ]] )

public void setMetadata ( mixed $metadata )

public void setSignatureAlgorithm ( int $sigtype [, string $privatekey ] )

public bool setStub ( string $stub [, int $len = -1 ] )

public void startBuffering ( void )

public void stopBuffering ( void )

public bool uncompressAllFiles ( void )

final public static bool unlinkArchive ( string $archive )

final public static void webPhar ([ string $alias [, string $index = "index.php" [, string $f404 [, array $mimetypes [, callable $rewrites ]]]]] )

}

Phar::addEmptyDir — Add an empty directory to the phar archive
Phar::addFile — Add a file from the filesystem to the phar archive
Phar::addFromString — Add a file from a string to the phar archive
Phar::apiVersion — Returns the api version
Phar::buildFromDirectory — Construct a phar archive from the files within a directory.
Phar::buildFromIterator — Construct a phar archive from an iterator.
Phar::canCompress — Returns whether phar extension supports compression using either zlib or bzip2
Phar::canWrite — Returns whether phar extension supports writing and creating phars
Phar::compress — Compresses the entire Phar archive using Gzip or Bzip2 compression
Phar::compressAllFilesBZIP2 — Compresses all files in the current Phar archive using Bzip2 compression
Phar::compressAllFilesGZ — Compresses all files in the current Phar archive using Gzip compression
Phar::compressFiles — Compresses all files in the current Phar archive
Phar::__construct — Construct a Phar archive object
Phar::convertToData — Convert a phar archive to a non-executable tar or zip file
Phar::convertToExecutable — Convert a phar archive to another executable phar archive file format
Phar::copy — Copy a file internal to the phar archive to another new file within the phar
Phar::count — Returns the number of entries (files) in the Phar archive
Phar::createDefaultStub — Create a phar-file format specific stub
Phar::decompress — Decompresses the entire Phar archive
Phar::decompressFiles — Decompresses all files in the current Phar archive
Phar::delMetadata — Deletes the global metadata of the phar
Phar::delete — Delete a file within a phar archive
Phar::extractTo — Extract the contents of a phar archive to a directory
Phar::getMetadata — Returns phar archive meta-data
Phar::getModified — Return whether phar was modified
Phar::getSignature — Return MD5/SHA1/SHA256/SHA512/OpenSSL signature of a Phar archive
Phar::getStub — Return the PHP loader or bootstrap stub of a Phar archive
Phar::getSupportedCompression — Return array of supported compression algorithms
Phar::getSupportedSignatures — Return array of supported signature types
Phar::getVersion — Return version info of Phar archive
Phar::hasMetadata — Returns whether phar has global meta-data
Phar::interceptFileFuncs — instructs phar to intercept fopen, file_get_contents, opendir, and all of the stat-related functions
Phar::isBuffering — Used to determine whether Phar write operations are being buffered, or are flushing directly to disk
Phar::isCompressed — Returns Phar::GZ or PHAR::BZ2 if the entire phar archive is compressed (.tar.gz/tar.bz and so on)
Phar::isFileFormat — Returns true if the phar archive is based on the tar/phar/zip file format depending on the parameter
Phar::isValidPharFilename — Returns whether the given filename is a valid phar filename
Phar::isWritable — Returns true if the phar archive can be modified
Phar::loadPhar — Loads any phar archive with an alias
Phar::mapPhar — Reads the currently executed file (a phar) and registers its manifest
Phar::mount — Mount an external path or file to a virtual location within the phar archive
Phar::mungServer — Defines a list of up to 4 $_SERVER variables that should be modified for execution
Phar::offsetExists — determines whether a file exists in the phar
Phar::offsetGet — Gets a PharFileInfo object for a specific file
Phar::offsetSet — set the contents of an internal file to those of an external file
Phar::offsetUnset — remove a file from a phar
Phar::running — Returns the full path on disk or full phar URL to the currently executing Phar archive
Phar::setAlias — Set the alias for the Phar archive
Phar::setDefaultStub — Used to set the PHP loader or bootstrap stub of a Phar archive to the default loader
Phar::setMetadata — Sets phar archive meta-data
Phar::setSignatureAlgorithm — set the signature algorithm for a phar and apply it.
Phar::setStub — Used to set the PHP loader or bootstrap stub of a Phar archive
Phar::startBuffering — Start buffering Phar write operations, do not modify the Phar object on disk
Phar::stopBuffering — Stop buffering write requests to the Phar archive, and save changes to disk
Phar::uncompressAllFiles — Uncompresses all files in the current Phar archive
Phar::unlinkArchive — Completely remove a phar archive from disk and from memory
Phar::webPhar — mapPhar for web-based phars. front controller for web applications

用户评论:

[#1] cornelius dot howl at gmail dot com [2011-12-19 00:49:57]

Onion utility can help you compile a package into a phar file (executable script file or library file)

https://github.com/c9s/Onion

   $ onion.phar compile \
    --executable \
    --classloader \
    --bootstrap scripts/onion.embed \
    --lib src \
    --lib ../CLIFramework/src \
    --lib ../GetOptionKit/src \
    --output onion.phar

[#2] halfdan [2008-05-17 13:18:36]

Hey, I thought writing a small article about the upcoming functionality and appearance of Phar in php5.3 might be a nice thing. So I did this at http://geekmonkey.org/articles/PHP_Archives - hope to save others some time when working with Phar.