文字
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
]]]]] )Table of Contents
- 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.