The Phar class

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)

简介

The Phar class provides a high-level interface to accessing and creating phar archives.

类摘要

Phar extends RecursiveDirectoryIterator implements Countable , ArrayAccess {

/* 继承的常量 */

const int FilesystemIterator::CURRENT_AS_PATHNAME = 32 ;

const int FilesystemIterator::CURRENT_AS_FILEINFO = 0 ;

const int FilesystemIterator::CURRENT_AS_SELF = 16 ;

const int FilesystemIterator::CURRENT_MODE_MASK = 240 ;

const int FilesystemIterator::KEY_AS_PATHNAME = 0 ;

const int FilesystemIterator::KEY_AS_FILENAME = 256 ;

const int FilesystemIterator::FOLLOW_SYMLINKS = 512 ;

const int FilesystemIterator::KEY_MODE_MASK = 3840 ;

const int FilesystemIterator::NEW_CURRENT_AND_KEY = 256 ;

const int FilesystemIterator::SKIP_DOTS = 4096 ;

const int FilesystemIterator::UNIX_PATHS = 8192 ;

/* 方法 */

public addEmptyDir ( string $dirname ) : void

public addFile ( string $filename , string|null $localName = null ) : void

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

final public static apiVersion ( ) : string

public buildFromDirectory ( string $directory , string $pattern = "" ) : array|false

public buildFromIterator ( Traversable $iterator , string|null $baseDirectory = null ) : array|false

final public static canCompress ( int $compression = 0 ) : bool

final public static canWrite ( ) : bool

public compress ( int $compression , string|null $extension = null ) : Phar|null

public compressFiles ( int $compression ) : void

public convertToData ( int|null $format = null , int|null $compression = null , string|null $extension = null ) : Phar|null

public convertToExecutable ( int|null $format = null , int|null $compression = null , string|null $extension = null ) : Phar|null

public copy ( string $to , string $from ) : bool

public count ( int $mode = COUNT_NORMAL ) : int

final public static createDefaultStub ( string|null $index = null , string|null $webIndex = null ) : string

public decompress ( string|null $extension = null ) : Phar|null

public decompressFiles ( ) : bool

public delMetadata ( ) : bool

public delete ( string $entry ) : bool

public extractTo ( string $directory , array|string|null $files = null , bool $overwrite = false ) : bool

public getAlias ( ) : string|null

public getMetadata ( array $unserializeOptions = [] ) : mixed

public getModified ( ) : bool

public getPath ( ) : string

public getSignature ( ) : array|false

public getStub ( ) : string

final public static getSupportedCompression ( ) : array

final public static getSupportedSignatures ( ) : array

public getVersion ( ) : string

public hasMetadata ( ) : bool

final public static interceptFileFuncs ( ) : void

public isBuffering ( ) : bool

public isCompressed ( ) : int|false

public isFileFormat ( int $format ) : bool

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

public isWritable ( ) : bool

final public static loadPhar ( string $filename , string|null $alias = null ) : bool

final public static mapPhar ( string|null $alias = null , int $offset = 0 ) : bool

final public static mount ( string $pharPath , string $externalPath ) : void

final public static mungServer ( array $variables ) : void

public offsetExists ( string $localName ) : bool

public offsetGet ( string $localName ) : PharFileInfo

public offsetSet ( string $localName , resource|string $value ) : void

public offsetUnset ( string $localName ) : bool

final public static running ( bool $returnPhar = true ) : string

public setAlias ( string $alias ) : bool

public setDefaultStub ( string|null $index = null , string|null $webIndex = null ) : bool

public setMetadata ( mixed $metadata ) : void

public setSignatureAlgorithm ( int $algo , string|null $privateKey = null ) : void

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

public startBuffering ( ) : void

public stopBuffering ( ) : void

final public static unlinkArchive ( string $filename ) : bool

final public static webPhar ( string|null $alias = null , string|null $index = null , string|null $fileNotFoundScript = null , array $mimeTypes = [] , callable|null $rewrite = null ) : void

}

Phar::addEmptyDir — 添加一个空目录到 phar 档案
Phar::addFile — 将一个文件从文件系统添加到 phar 档案中
Phar::addFromString — 以字符串的形式添加一个文件到 phar 档案
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::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 — 删除 phar 档案中的一个文件
Phar::extractTo — Extract the contents of a phar archive to a directory
Phar::getAlias — Get the alias for Phar
Phar::getMetadata — Returns phar archive meta-data
Phar::getModified — Return whether phar was modified
Phar::getPath — Get the real path to the Phar archive on disk
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::unlinkArchive — Completely remove a phar archive from disk and from memory
Phar::webPhar — Routes a request from a web browser to an internal file within the phar archive

User Contributed Notes

cornelius dot howl at gmail dot com 19-Dec-2011 12:49


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

halfdan 17-May-2008 01:18


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.

The Phar class

简介

类摘要

Table of Contents

User Contributed Notes