Docs For Class PEAR_PackageFile

PEAR_PackageFile_v2 (Constructor) [line 133]

PEAR_PackageFile_v2 PEAR_PackageFile_v2(
)

The constructor merely sets up the private error stack

[ Top ]

analyzeSourceCode [line 1819]

void analyzeSourceCode(

$file, [
$string = false])

Parameters:

	`$file`	—
	`$string`	—

[ Top ]

dependsOn [line 1503]

void dependsOn(

$package, 
$channel)

Parameters:

	`$package`	—
	`$channel`	—

[ Top ]

flattenFilelist [line 633]

void flattenFilelist(
)

Convert a recursive set of <dir> and <file> tags into a single <dir> tag with <file> tags.

[ Top ]

fromArray [line 766]

void fromArray(
array
$pinfo)

Directly set the array that defines this packagefile

WARNING: no validation. This should only be performed by internal methods inside PEAR or by inputting an array saved from an existing PEAR_PackageFile_v2

Parameters:

array $pinfo —

[ Top ]

getArchiveFile [line 753]

void getArchiveFile(
)

[ Top ]

getArray [line 790]

void getArray(
[
$forReg = false])

Parameters:

$forReg —

[ Top ]

getBundledPackages [line 1744]

void getBundledPackages(
)

[ Top ]

getChangelog [line 1714]

array getChangelog(
)

[ Top ]

getChannel [line 851]

void getChannel(
)

[ Top ]

getCompatible [line 1428]

array|false getCompatible(
)

[ Top ]

getConfigureOptions [line 1154]

array|false getConfigureOptions(
)

Return configure options array, if any

[ Top ]

getContents [line 1308]

void getContents(
)

Retrieve the contents tag

[ Top ]

getContributors [line 976]

void getContributors(
)

[ Top ]

getDate [line 1022]

void getDate(
)

[ Top ]

getDefaultGenerator [line 1810]

void &getDefaultGenerator(
)

[ Top ]

getDependencies [line 1436]

void getDependencies(
)

[ Top ]

getDependencyGroup [line 1551]

array|false getDependencyGroup(
string
$name)

Get the contents of a dependency group

Parameters:

string $name —

[ Top ]

getDeps [line 1580]

array|false getDeps(
[boolean
$raw = false], [
$nopearinstaller = false])

Retrieve a partial package.xml 1.0 representation of dependencies

a very limited representation of dependencies is returned by this method. The <exclude> tag for excluding certain versions of a dependency is completely ignored. In addition, dependency groups are ignored, with the assumption that all dependencies in dependency groups are also listed in the optional group that work with all dependency groups

Parameters:

boolean	`$raw`	—	return package.xml 2.0 <dependencies> tag
	`$nopearinstaller`	—

[ Top ]

getDescription [line 886]

void getDescription(
)

[ Top ]

getDevelopers [line 968]

void getDevelopers(
)

[ Top ]

getDirtree [line 1365]

void getDirtree(
)

[ Top ]

getExtends [line 870]

void getExtends(
)

[ Top ]

getFileContents [line 1765]

string getFileContents(
string
$file)

Get the contents of a file listed within the package.xml

Parameters:

string $file —

[ Top ]

getFilelist [line 1123]

void getFilelist(
[
$preserve = false])

This should only be used to retrieve filenames and install attributes

Parameters:

$preserve —

[ Top ]

getHelpers [line 984]

void getHelpers(
)

[ Top ]

getInstallationFilelist [line 1185]

array getInstallationFilelist(
[
$forfilecheck = false])

Retrieve a list of files that should be installed on this computer

Parameters:

$forfilecheck —

[ Top ]

getInstalledBinary [line 171]

void getInstalledBinary(
)

[ Top ]

getInstalledLocation [line 1283]

void getInstalledLocation(

$file)

Parameters:

$file —

[ Top ]

getLastInstalledVersion [line 512]

string|false getLastInstalledVersion(
)

[ Top ]

getLastModified [line 1752]

void getLastModified(
)

[ Top ]

getLeads [line 960]

void getLeads(
)

[ Top ]

getLicense [line 1065]

void getLicense(
[
$raw = false])

Parameters:

$raw —

[ Top ]

getLicenseLocation [line 1080]

void getLicenseLocation(
)

[ Top ]

getMaintainers [line 894]

void getMaintainers(
[
$raw = false])

Parameters:

$raw —

[ Top ]

getName [line 838]

void getName(
)

[ Top ]

getNotes [line 1088]

void getNotes(
)

[ Top ]

getPackage [line 843]

void getPackage(
)

[ Top ]

getPackageFile [line 748]

void getPackageFile(
)

[ Top ]

getPackageType [line 1679]

php|extsrc|extbin|bundle|false getPackageType(
)

[ Top ]

getPackagexmlVersion [line 1727]

void getPackagexmlVersion(
)

[ Top ]

getPEARDependency2 [line 162]

PEAR_Dependency2 &getPEARDependency2(
PEAR_Config
&$c, array
$o, array
$p, [int
$s = PEAR_VALIDATE_INSTALLING])

To make unit-testing easier

Access: protected

Parameters:

PEAR_Config	`&$c`	—
array	`$o`	—	options
array	`$p`	—	package name as returned from PEAR_Registry::parsePackageName()
int	`$s`	—	PEAR_VALIDATE_* constant

[ Top ]

getPEARDownloader [line 147]

PEAR_Downloader &getPEARDownloader(
PEAR_Frontend_*
&$i, array
$o, PEAR_Config
&$c)

To make unit-testing easier

Access: protected

Parameters:

PEAR_Frontend_*	`&$i`	—
array	`$o`	—	options
PEAR_Config	`&$c`	—

[ Top ]

getProvidesExtension [line 260]

string|false getProvidesExtension(
)

Return: Extension name

[ Top ]

getReleases [line 1699]

array|false getReleases(
)

[ Top ]

getRequestedGroup [line 490]

void getRequestedGroup(
)

[ Top ]

getRW [line 1790]

void &getRW(
)

[ Top ]

getSourcePackage [line 1735]

array|false getSourcePackage(
)

[ Top ]

getStability [line 1049]

void getStability(
)

[ Top ]

getState [line 1057]

void getState(
[
$key = 'release'])

Parameters:

$key —

[ Top ]

getSummary [line 878]

void getSummary(
)

[ Top ]

getTask [line 1869]

boolean getTask(
string
$task)

Determine whether a task name is a valid task. Custom tasks may be defined using subdirectories by putting a "-" in the name, as in <tasks:mycustom-task>

Note that this method will auto-load the task class file and test for the existence of the name with "-" replaced by "_" as in PEAR/Task/mycustom/task.php makes class PEAR_Task_mycustom_task

Parameters:

string $task —

[ Top ]

getTasksNs [line 1844]

void getTasksNs(
)

[ Top ]

getTime [line 1030]

void getTime(
)

[ Top ]

getUri [line 862]

void getUri(
)

[ Top ]

getUsesrole [line 1100]

array|false getUsesrole(
)

Return the <usesrole> tag contents, if any

[ Top ]

getUsestask [line 1112]

array|false getUsestask(
)

Return the <usestask> tag contents, if any

[ Top ]

getValidationWarnings [line 743]

array getValidationWarnings(
[boolean
$purge = true])

Wrapper to PEAR_ErrorStack::getErrors()

Parameters:

boolean $purge — determines whether to purge the error stack after retrieving

[ Top ]

getVersion [line 1041]

void getVersion(
[package|api
$key = 'release'])

Parameters:

package|api $key — version category to return

[ Top ]

hasDeps [line 1722]

void hasDeps(
)

[ Top ]

initPostinstallScripts [line 571]

bool initPostinstallScripts(
)

Initialize post-install scripts for running

This method can be used to detect post-install scripts, as the return value indicates whether any exist

[ Top ]

installBinary [line 183]

array|false installBinary(
PEAR_Installer
&$installer)

Installation of source package has failed, attempt to download and install the binary version of this package.

Parameters:

PEAR_Installer &$installer —

[ Top ]

installedFile [line 1295]

void installedFile(

$file, 
$atts)

This is only used at install-time, after all serialization is over.

Overridden in child classes as:

PEAR_PackageFile_v2_rw::installedFile(): This is only used at install-time, after all serialization is over.

Parameters:

	`$file`	—
	`$atts`	—

[ Top ]

isCompatible [line 1384]

boolean isCompatible(
PEAR_PackageFile_v2|PEAR_PackageFile_v1|PEAR_Downloader_Package
$pf)

Determines whether this package claims it is compatible with the version of

the package that has a recommended version dependency

Parameters:

PEAR_PackageFile_v2|PEAR_PackageFile_v1|PEAR_Downloader_Package $pf —

[ Top ]

isEquivalent [line 288]

bool isEquivalent(
PEAR_PackageFile_v1
$pf1)

Tests whether every part of the package.xml 1.0 is represented in

this package.xml 2.0

Parameters:

PEAR_PackageFile_v1 $pf1 —

[ Top ]

isExtension [line 274]

bool isExtension(
string
$extension)

Parameters:

string $extension — Extension name

[ Top ]

isIncomplete [line 774]

void isIncomplete(
)

[ Top ]

isSubpackage [line 1456]

bool isSubpackage(
PEAR_PackageFile_v1|PEAR_PackageFile_v2
$p)

Determines whether the passed in package is a subpackage of this package.

No version checking is done, only name verification.

Parameters:

PEAR_PackageFile_v1|PEAR_PackageFile_v2 $p —

[ Top ]

isSubpackageOf [line 1444]

void isSubpackageOf(

$p)

Parameters:

$p —

[ Top ]

listPostinstallScripts [line 524]

array|false listPostinstallScripts(
)

Determines whether this package.xml has post-install scripts or not

[ Top ]

packageInfo [line 817]

void packageInfo(

$field)

Parameters:

$field —

[ Top ]

resetDirtree [line 1373]

void resetDirtree(
)

[ Top ]

resetFilelist [line 1176]

void resetFilelist(
)

This is only used at install-time, after all serialization is over.

[ Top ]

runPostinstallScripts [line 618]

void runPostinstallScripts(
)

[ Top ]

setConfig [line 710]

void setConfig(

&$config)

Parameters:

&$config —

[ Top ]

setDate [line 992]

void setDate(

$date)

Parameters:

$date —

[ Top ]

setDeps [line 727]

void setDeps(

$deps)

WARNING - do not use this function directly unless you know what you're doing

Parameters:

$deps —

[ Top ]

setDirtree [line 1360]

void setDirtree(

$path)

Parameters:

$path —

[ Top ]

setFileAttribute [line 1324]

bool setFileAttribute(
string
$filename, string
$attr, string
$value, [int
$index = false])

Return: success of operation

Parameters:

string	`$filename`	—	full path to file
string	`$attr`	—	attribute name
string	`$value`	—	attribute value
int	`$index`	—	risky but fast - use this to choose a file based on its position in the list of files. Index is zero-based like PHP arrays.

[ Top ]

setInstalledAs [line 1275]

void setInstalledAs(
string
$file, string
$path)

This is only used at install-time, after all serialization is over.

Overridden in child classes as:

PEAR_PackageFile_v2_rw::setInstalledAs(): This is only used at install-time, after all serialization is over.

Parameters:

string	`$file`	—	file name
string	`$path`	—	installed path

[ Top ]

setLastInstalledVersion [line 504]

void setLastInstalledVersion(
string
$version)

For saving in the registry.

Set the last version that was installed

Parameters:

string $version —

[ Top ]

setLogger [line 716]

void setLogger(

&$logger)

Parameters:

&$logger —

[ Top ]

setPackagefile [line 732]

void setPackagefile(

$file, [
$archive = false])

Parameters:

	`$file`	—
	`$archive`	—

[ Top ]

setRawChannel [line 480]

void setRawChannel(

$channel)

WARNING - do not use this function unless you know what you're doing

Parameters:

$channel —

[ Top ]

setRawPackage [line 472]

void setRawPackage(

$package)

WARNING - do not use this function unless you know what you're doing

Parameters:

$package —

[ Top ]

setRawState [line 464]

void setRawState(

$state)

array _getFlattenedFilelist(
array
&$files, array
$dir, [string|false
$baseinstall = false], [string
$path = ''])

Access: protected

Parameters:

array	`&$files`	—	the final flattened file list
array	`$dir`	—	the current directory being processed
string\|false	`$baseinstall`	—	any recursively inherited baeinstalldir attribute
string	`$path`	—	private recursion variable

[ Top ]

Class: PEAR_PackageFile_v2

Class Overview

Author(s):

Version:

Copyright:

Variables

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Class Variables

$_config =

$_logger =

$_registry =

$_stack =

Method Detail

PEAR_PackageFile_v2 (Constructor) [line 133]

analyzeSourceCode [line 1819]

Parameters:

dependsOn [line 1503]

Parameters:

flattenFilelist [line 633]

fromArray [line 766]

Parameters:

getArchiveFile [line 753]

getArray [line 790]

Parameters:

getBundledPackages [line 1744]

getChangelog [line 1714]

getChannel [line 851]

getCompatible [line 1428]

getConfigureOptions [line 1154]

getContents [line 1308]

getContributors [line 976]

getDate [line 1022]

getDefaultGenerator [line 1810]

getDependencies [line 1436]

getDependencyGroup [line 1551]

Parameters:

getDeps [line 1580]

Parameters:

getDescription [line 886]

getDevelopers [line 968]

getDirtree [line 1365]

getExtends [line 870]

getFileContents [line 1765]

Parameters:

getFilelist [line 1123]

Parameters:

getHelpers [line 984]

getInstallationFilelist [line 1185]

Parameters:

getInstalledBinary [line 171]

getInstalledLocation [line 1283]

Parameters:

getLastInstalledVersion [line 512]

getLastModified [line 1752]

getLeads [line 960]

getLicense [line 1065]

Parameters:

getLicenseLocation [line 1080]

getMaintainers [line 894]

Parameters:

getName [line 838]

getNotes [line 1088]

getPackage [line 843]

getPackageFile [line 748]

getPackageType [line 1679]

getPackagexmlVersion [line 1727]

getPEARDependency2 [line 162]

Parameters:

getPEARDownloader [line 147]

Parameters:

getProvidesExtension [line 260]

getReleases [line 1699]

getRequestedGroup [line 490]

getRW [line 1790]

getSourcePackage [line 1735]

getStability [line 1049]