WebSVN – Applications.gtt – Diff – /trunk/bibliotheque/pear/PEAR/PackageFile/v1.php


<?php
/**
 * PEAR_PackageFile_v1, package.xml version 1.0
 *
 * PHP versions 4 and 5
 *
 
 
 
 
 
 
 * @category   pear
 * @package    PEAR
 * @author     Greg Beaver <cellog@php.net>
 * @copyright  1997-2009 The Authors
 * @license    http://opensource.org/licenses/bsd-license.php New BSD License
 
 * @link       http://pear.php.net/package/PEAR
 * @since      File available since Release 1.4.0a1
 */
/**
 * For error handling
 */
require_once 'PEAR/ErrorStack.php';
 
/**
 * Error code if parsing is attempted with no xml extension
 */
define('PEAR_PACKAGEFILE_ERROR_NO_XML_EXT', 3);
 
/**
 * Error code if creating the xml parser resource fails
 */
define('PEAR_PACKAGEFILE_ERROR_CANT_MAKE_PARSER', 4);
 
/**
 * Error code used for all sax xml parsing errors
 */
define('PEAR_PACKAGEFILE_ERROR_PARSER_ERROR', 5);
 
/**
 * Error code used when there is no name
 */
define('PEAR_PACKAGEFILE_ERROR_NO_NAME', 6);
 
/**
 * Error code when a package name is not valid
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_NAME', 7);
 
/**
 * Error code used when no summary is parsed
 */
define('PEAR_PACKAGEFILE_ERROR_NO_SUMMARY', 8);
 
/**
 * Error code for summaries that are more than 1 line
 */
define('PEAR_PACKAGEFILE_ERROR_MULTILINE_SUMMARY', 9);
 
/**
 * Error code used when no description is present
 */
define('PEAR_PACKAGEFILE_ERROR_NO_DESCRIPTION', 10);
 
/**
 * Error code used when no license is present
 */
define('PEAR_PACKAGEFILE_ERROR_NO_LICENSE', 11);
 
/**
 * Error code used when a <version> version number is not present
 */
define('PEAR_PACKAGEFILE_ERROR_NO_VERSION', 12);
 
/**
 * Error code used when a <version> version number is invalid
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_VERSION', 13);
 
/**
 * Error code when release state is missing
 */
define('PEAR_PACKAGEFILE_ERROR_NO_STATE', 14);
 
/**
 * Error code when release state is invalid
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_STATE', 15);
 
/**
 * Error code when release state is missing
 */
define('PEAR_PACKAGEFILE_ERROR_NO_DATE', 16);
 
/**
 * Error code when release state is invalid
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_DATE', 17);
 
/**
 * Error code when no release notes are found
 */
define('PEAR_PACKAGEFILE_ERROR_NO_NOTES', 18);
 
/**
 * Error code when no maintainers are found
 */
define('PEAR_PACKAGEFILE_ERROR_NO_MAINTAINERS', 19);
 
/**
 * Error code when a maintainer has no handle
 */
define('PEAR_PACKAGEFILE_ERROR_NO_MAINTHANDLE', 20);
 
/**
 * Error code when a maintainer has no handle
 */
define('PEAR_PACKAGEFILE_ERROR_NO_MAINTROLE', 21);
 
/**
 * Error code when a maintainer has no name
 */
define('PEAR_PACKAGEFILE_ERROR_NO_MAINTNAME', 22);
 
/**
 * Error code when a maintainer has no email
 */
define('PEAR_PACKAGEFILE_ERROR_NO_MAINTEMAIL', 23);
 
/**
 * Error code when a maintainer has no handle
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_MAINTROLE', 24);
 
/**
 * Error code when a dependency is not a PHP dependency, but has no name
 */
define('PEAR_PACKAGEFILE_ERROR_NO_DEPNAME', 25);
 
/**
 * Error code when a dependency has no type (pkg, php, etc.)
 */
define('PEAR_PACKAGEFILE_ERROR_NO_DEPTYPE', 26);
 
/**
 * Error code when a dependency has no relation (lt, ge, has, etc.)
 */
define('PEAR_PACKAGEFILE_ERROR_NO_DEPREL', 27);
 
/**
 * Error code when a dependency is not a 'has' relation, but has no version
 */
define('PEAR_PACKAGEFILE_ERROR_NO_DEPVERSION', 28);
 
/**
 * Error code when a dependency has an invalid relation
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPREL', 29);
 
/**
 * Error code when a dependency has an invalid type
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPTYPE', 30);
 
/**
 * Error code when a dependency has an invalid optional option
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPOPTIONAL', 31);
 
/**
 * Error code when a dependency is a pkg dependency, and has an invalid package name
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPNAME', 32);
 
/**
 * Error code when a dependency has a channel="foo" attribute, and foo is not a registered channel
 */
define('PEAR_PACKAGEFILE_ERROR_UNKNOWN_DEPCHANNEL', 33);
 
/**
 * Error code when rel="has" and version attribute is present.
 */
define('PEAR_PACKAGEFILE_ERROR_DEPVERSION_IGNORED', 34);
 
/**
 * Error code when type="php" and dependency name is present
 */
define('PEAR_PACKAGEFILE_ERROR_DEPNAME_IGNORED', 35);
 
/**
 * Error code when a configure option has no name
 */
define('PEAR_PACKAGEFILE_ERROR_NO_CONFNAME', 36);
 
/**
 * Error code when a configure option has no name
 */
define('PEAR_PACKAGEFILE_ERROR_NO_CONFPROMPT', 37);
 
/**
 * Error code when a file in the filelist has an invalid role
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_FILEROLE', 38);
 
/**
 * Error code when a file in the filelist has no role
 */
define('PEAR_PACKAGEFILE_ERROR_NO_FILEROLE', 39);
 
/**
 * Error code when analyzing a php source file that has parse errors
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_PHPFILE', 40);
 
/**
 * Error code when analyzing a php source file reveals a source element
 * without a package name prefix
 */
define('PEAR_PACKAGEFILE_ERROR_NO_PNAME_PREFIX', 41);
 
/**
 * Error code when an unknown channel is specified
 */
define('PEAR_PACKAGEFILE_ERROR_UNKNOWN_CHANNEL', 42);
 
/**
 * Error code when no files are found in the filelist
 */
define('PEAR_PACKAGEFILE_ERROR_NO_FILES', 43);
 
/**
 * Error code when a file is not valid php according to _analyzeSourceCode()
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_FILE', 44);
 
/**
 * Error code when the channel validator returns an error or warning
 */
define('PEAR_PACKAGEFILE_ERROR_CHANNELVAL', 45);
 
/**
 * Error code when a php5 package is packaged in php4 (analysis doesn't work)
 */
define('PEAR_PACKAGEFILE_ERROR_PHP5', 46);
 
/**
 * Error code when a file is listed in package.xml but does not exist
 */
define('PEAR_PACKAGEFILE_ERROR_FILE_NOTFOUND', 47);
 
/**
 * Error code when a <dep type="php" rel="not"... is encountered (use rel="ne")
 */
define('PEAR_PACKAGEFILE_PHP_NO_NOT', 48);
 
/**
 * Error code when a package.xml contains non-ISO-8859-1 characters
 */
define('PEAR_PACKAGEFILE_ERROR_NON_ISO_CHARS', 49);
 
/**
 * Error code when a dependency is not a 'has' relation, but has no version
 */
define('PEAR_PACKAGEFILE_ERROR_NO_DEPPHPVERSION', 50);
 
/**
 * Error code when a package has no lead developer
 */
define('PEAR_PACKAGEFILE_ERROR_NO_LEAD', 51);
 
/**
 * Error code when a filename begins with "."
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_FILENAME', 52);
/**
 * package.xml encapsulator
 * @category   pear
 * @package    PEAR
 * @author     Greg Beaver <cellog@php.net>
 * @copyright  1997-2009 The Authors
 * @license    http://opensource.org/licenses/bsd-license.php New BSD License
 * @version    Release: 1.10.1
 * @link       http://pear.php.net/package/PEAR
 * @since      Class available since Release 1.4.0a1
 */
class PEAR_PackageFile_v1
{
    /**
     * @access private
     * @var PEAR_ErrorStack
     * @access private
     */
    var $_stack;
 
    /**
     * A registry object, used to access the package name validation regex for non-standard channels
     * @var PEAR_Registry
     * @access private
     */
    var $_registry;
 
    /**
     * An object that contains a log method that matches PEAR_Common::log's signature
     * @var object
     * @access private
     */
    var $_logger;
 
    /**
     * Parsed package information
     * @var array
     * @access private
     */
    var $_packageInfo;
 
    /**
     * path to package.xml
     * @var string
     * @access private
     */
    var $_packageFile;
 
    /**
     * path to package .tgz or false if this is a local/extracted package.xml
     * @var string
     * @access private
     */
    var $_archiveFile;
 
    /**
     * @var int
     * @access private
     */
    var $_isValid = 0;
 
    /**
     * Determines whether this packagefile was initialized only with partial package info
     *
     * If this package file was constructed via parsing REST, it will only contain
     *
     * - package name
     * - channel name
     * - dependencies 
     * @var boolean
     * @access private
     */
    var $_incomplete = true;
 
    /**
     * @param bool determines whether to return a PEAR_Error object, or use the PEAR_ErrorStack
     * @param string Name of Error Stack class to use.
     */
    function __construct()
    {
        $this->_stack = new PEAR_ErrorStack('PEAR_PackageFile_v1');
        $this->_stack->setErrorMessageTemplate($this->_getErrorMessage());
        $this->_isValid = 0;
    }
 
    function installBinary($installer)
    {
        return false;
    }
 
    function isExtension($name)
    {
        return false;
    }
 
    function setConfig(&$config)
    {
        $this->_config = &$config;
        $this->_registry = &$config->getRegistry();
    }
 
    function setRequestedGroup()
    {
        // placeholder
    }
 
    /**
     * For saving in the registry.
     *
     * Set the last version that was installed
     * @param string
     */
    function setLastInstalledVersion($version)
    {
        $this->_packageInfo['_lastversion'] = $version;
    }
 
    /**
     * @return string|false
     */
    function getLastInstalledVersion()
    {
        if (isset($this->_packageInfo['_lastversion'])) {
            return $this->_packageInfo['_lastversion'];
        }
        return false;
    }
 
    function getInstalledBinary()
    {
        return false;
    }
 
    function listPostinstallScripts()
    {
        return false;
    }
 
    function initPostinstallScripts()
    {
        return false;
    }
 
    function setLogger(&$logger)
    {
        if ($logger && (!is_object($logger) || !method_exists($logger, 'log'))) {
            return PEAR::raiseError('Logger must be compatible with PEAR_Common::log');
        }
        $this->_logger = &$logger;
    }
 
    function setPackagefile($file, $archive = false)
    {
        $this->_packageFile = $file;
        $this->_archiveFile = $archive ? $archive : $file;
    }
 
    function getPackageFile()
    {
        return isset($this->_packageFile) ? $this->_packageFile : false;
    }
 
    function getPackageType()
    {
        return 'php';
    }
 
    function getArchiveFile()
    {
        return $this->_archiveFile;
    }
 
    function packageInfo($field)
    {
        if (!is_string($field) || empty($field) ||
            !isset($this->_packageInfo[$field])) {
            return false;
        }
        return $this->_packageInfo[$field];
    }
 
    function setDirtree($path)
    {
        if (!isset($this->_packageInfo['dirtree'])) {
            $this->_packageInfo['dirtree'] = array();
        }
        $this->_packageInfo['dirtree'][$path] = true;
    }
 
    function getDirtree()
    {
        if (isset($this->_packageInfo['dirtree']) && count($this->_packageInfo['dirtree'])) {
            return $this->_packageInfo['dirtree'];
        }
        return false;
    }
 
    function resetDirtree()
    {
        unset($this->_packageInfo['dirtree']);
    }
 
    function fromArray($pinfo)
    {
        $this->_incomplete = false;
        $this->_packageInfo = $pinfo;
    }
 
    function isIncomplete()
    {
        return $this->_incomplete;
    }
 
    function getChannel()
    {
        return 'pear.php.net';
    }
 
    function getUri()
    {
        return false;
    }
 
    function getTime()
    {
        return false;
    }
 
    function getExtends()
    {
        if (isset($this->_packageInfo['extends'])) {
            return $this->_packageInfo['extends'];
        }
        return false;
    }
 
    /**
     * @return array
     */
    function toArray()
    {
        if (!$this->validate(PEAR_VALIDATE_NORMAL)) {
            return false;
        }
        return $this->getArray();
    }
 
    function getArray()
    {
        return $this->_packageInfo;
    }
 
    function getName()
    {
        return $this->getPackage();
    }
 
    function getPackage()
    {
        if (isset($this->_packageInfo['package'])) {
            return $this->_packageInfo['package'];
        }
        return false;
    }
 
    /**
     * WARNING - don't use this unless you know what you are doing
     */
    function setRawPackage($package)
    {
        $this->_packageInfo['package'] = $package;
    }
 
    function setPackage($package)
    {
        $this->_packageInfo['package'] = $package;
        $this->_isValid = false;
    }
 
    function getVersion()
    {
        if (isset($this->_packageInfo['version'])) {
            return $this->_packageInfo['version'];
        }
        return false;
    }
 
    function setVersion($version)
    {
        $this->_packageInfo['version'] = $version;
        $this->_isValid = false;
    }
 
    function clearMaintainers()
    {
        unset($this->_packageInfo['maintainers']);
    }
 
    function getMaintainers()
    {
        if (isset($this->_packageInfo['maintainers'])) {
            return $this->_packageInfo['maintainers'];
        }
        return false;
    }
 
    /**
     * Adds a new maintainer - no checking of duplicates is performed, use
     * updatemaintainer for that purpose.
     */
    function addMaintainer($role, $handle, $name, $email)
    {
        $this->_packageInfo['maintainers'][] =
            array('handle' => $handle, 'role' => $role, 'email' => $email, 'name' => $name);
        $this->_isValid = false;
    }
 
    function updateMaintainer($role, $handle, $name, $email)
    {
        $found = false;
        if (!isset($this->_packageInfo['maintainers']) ||
              !is_array($this->_packageInfo['maintainers'])) {
            return $this->addMaintainer($role, $handle, $name, $email);
        }
        foreach ($this->_packageInfo['maintainers'] as $i => $maintainer) {
            if ($maintainer['handle'] == $handle) {
                $found = $i;
                break;
            }
        }
        if ($found !== false) {
            unset($this->_packageInfo['maintainers'][$found]);
            $this->_packageInfo['maintainers'] =
                array_values($this->_packageInfo['maintainers']);
        }
        $this->addMaintainer($role, $handle, $name, $email);
    }
 
    function deleteMaintainer($handle)
    {
        $found = false;
        foreach ($this->_packageInfo['maintainers'] as $i => $maintainer) {
            if ($maintainer['handle'] == $handle) {
                $found = $i;
                break;
            }
        }
        if ($found !== false) {
            unset($this->_packageInfo['maintainers'][$found]);
            $this->_packageInfo['maintainers'] =
                array_values($this->_packageInfo['maintainers']);
            return true;
        }
        return false;
    }
 
    function getState()
    {
        if (isset($this->_packageInfo['release_state'])) {
            return $this->_packageInfo['release_state'];
        }
        return false;
    }
 
    function setRawState($state)
    {
        $this->_packageInfo['release_state'] = $state;
    }
 
    function setState($state)
    {
        $this->_packageInfo['release_state'] = $state;
        $this->_isValid = false;
    }
 
    function getDate()
    {
        if (isset($this->_packageInfo['release_date'])) {
            return $this->_packageInfo['release_date'];
        }
        return false;
    }
 
    function setDate($date)
    {
        $this->_packageInfo['release_date'] = $date;
        $this->_isValid = false;
    }
 
    function getLicense()
    {
        if (isset($this->_packageInfo['release_license'])) {
            return $this->_packageInfo['release_license'];
        }
        return false;
    }
 
    function setLicense($date)
    {
        $this->_packageInfo['release_license'] = $date;
        $this->_isValid = false;
    }
 
    function getSummary()
    {
        if (isset($this->_packageInfo['summary'])) {
            return $this->_packageInfo['summary'];
        }
        return false;
    }
 
    function setSummary($summary)
    {
        $this->_packageInfo['summary'] = $summary;
        $this->_isValid = false;
    }
 
    function getDescription()
    {
        if (isset($this->_packageInfo['description'])) {
            return $this->_packageInfo['description'];
        }
        return false;
    }
 
    function setDescription($desc)
    {
        $this->_packageInfo['description'] = $desc;
        $this->_isValid = false;
    }
 
    function getNotes()
    {
        if (isset($this->_packageInfo['release_notes'])) {
            return $this->_packageInfo['release_notes'];
        }
        return false;
    }
 
    function setNotes($notes)
    {
        $this->_packageInfo['release_notes'] = $notes;
        $this->_isValid = false;
    }
 
    function getDeps()
    {
        if (isset($this->_packageInfo['release_deps'])) {
            return $this->_packageInfo['release_deps'];
        }
        return false;
    }
 
    /**
     * Reset dependencies prior to adding new ones
     */
    function clearDeps()
    {
        unset($this->_packageInfo['release_deps']);
    }
 
    function addPhpDep($version, $rel)
    {
        $this->_isValid = false;
        $this->_packageInfo['release_deps'][] =
            array('type' => 'php',
                  'rel' => $rel,
                  'version' => $version);
    }
 
    function addPackageDep($name, $version, $rel, $optional = 'no')
    {
        $this->_isValid = false;
        $dep =
            array('type' => 'pkg',
                  'name' => $name,
                  'rel' => $rel,
                  'optional' => $optional);
        if ($rel != 'has' && $rel != 'not') {
            $dep['version'] = $version;
        }
        $this->_packageInfo['release_deps'][] = $dep;
    }
 
    function addExtensionDep($name, $version, $rel, $optional = 'no')
    {
        $this->_isValid = false;
        $this->_packageInfo['release_deps'][] =
            array('type' => 'ext',
                  'name' => $name,
                  'rel' => $rel,
                  'version' => $version,
                  'optional' => $optional);
    }
 
    /**
     * WARNING - do not use this function directly unless you know what you're doing
     */
    function setDeps($deps)
    {
        $this->_packageInfo['release_deps'] = $deps;
    }
 
    function hasDeps()
    {
        return isset($this->_packageInfo['release_deps']) &&
            count($this->_packageInfo['release_deps']);
    }
 
    function getDependencyGroup($group)
    {
        return false;
    }
 
    function isCompatible($pf)
    {
        return false;
    }
 
    function isSubpackageOf($p)
    {
        return $p->isSubpackage($this);
    }
 
    function isSubpackage($p)
    {
        return false;
    }
 
    function dependsOn($package, $channel)
    {
        if (strtolower($channel) != 'pear.php.net') {
            return false;
        }
        if (!($deps = $this->getDeps())) {
            return false;
        }
        foreach ($deps as $dep) {
            if ($dep['type'] != 'pkg') {
                continue;
            }
            if (strtolower($dep['name']) == strtolower($package)) {
                return true;
            }
        }
        return false;
    }
 
    function getConfigureOptions()
    {
        if (isset($this->_packageInfo['configure_options'])) {
            return $this->_packageInfo['configure_options'];
        }
        return false;
    }
 
    function hasConfigureOptions()
    {
        return isset($this->_packageInfo['configure_options']) &&
            count($this->_packageInfo['configure_options']);
    }
 
    function addConfigureOption($name, $prompt, $default = false)
    {
        $o = array('name' => $name, 'prompt' => $prompt);
        if ($default !== false) {
            $o['default'] = $default;
        }
        if (!isset($this->_packageInfo['configure_options'])) {
            $this->_packageInfo['configure_options'] = array();
        }
        $this->_packageInfo['configure_options'][] = $o;
    }
 
    function clearConfigureOptions()
    {
        unset($this->_packageInfo['configure_options']);
    }
 
    function getProvides()
    {
        if (isset($this->_packageInfo['provides'])) {
            return $this->_packageInfo['provides'];
        }
        return false;
    }
 
    function getProvidesExtension()
    {
        return false;
    }
 
    function addFile($dir, $file, $attrs)
    {
        $dir = preg_replace(array('!\\\\+!', '!/+!'), array('/', '/'), $dir);
        if ($dir == '/' || $dir == '') {
            $dir = '';
        } else {
            $dir .= '/';
        }
        $file = $dir . $file;
        $file = preg_replace('![\\/]+!', '/', $file);
        $this->_packageInfo['filelist'][$file] = $attrs;
    }
 
    function getInstallationFilelist()
    {
        return $this->getFilelist();
    }
 
    function getFilelist()
    {
        if (isset($this->_packageInfo['filelist'])) {
            return $this->_packageInfo['filelist'];
        }
        return false;
    }
 
    function setFileAttribute($file, $attr, $value)
    {
        $this->_packageInfo['filelist'][$file][$attr] = $value;
    }
 
    function resetFilelist()
    {
        $this->_packageInfo['filelist'] = array();
    }
 
    function setInstalledAs($file, $path)
    {
        if ($path) {
            return $this->_packageInfo['filelist'][$file]['installed_as'] = $path;
        }
        unset($this->_packageInfo['filelist'][$file]['installed_as']);
    }
 
    function installedFile($file, $atts)
    {
        if (isset($this->_packageInfo['filelist'][$file])) {
            $this->_packageInfo['filelist'][$file] =
                array_merge($this->_packageInfo['filelist'][$file], $atts);
        } else {
            $this->_packageInfo['filelist'][$file] = $atts;
        }
    }
 
    function getChangelog()
    {
        if (isset($this->_packageInfo['changelog'])) {
            return $this->_packageInfo['changelog'];
        }
        return false;
    }
 
    function getPackagexmlVersion()
    {
        return '1.0';
    }
 
    /**
     * Wrapper to {@link PEAR_ErrorStack::getErrors()}
     * @param boolean determines whether to purge the error stack after retrieving
     * @return array
     */
    function getValidationWarnings($purge = true)
    {
        return $this->_stack->getErrors($purge);
    }
 
    // }}}
    /**
     * Validation error.  Also marks the object contents as invalid
     * @param error code
     * @param array error information
     * @access private
     */
    function _validateError($code, $params = array())
    {
        $this->_stack->push($code, 'error', $params, false, false, debug_backtrace());
        $this->_isValid = false;
    }
 
    /**
     * Validation warning.  Does not mark the object contents invalid.
     * @param error code
     * @param array error information
     * @access private
     */
    function _validateWarning($code, $params = array())
    {
        $this->_stack->push($code, 'warning', $params, false, false, debug_backtrace());
    }
 
    /**
     * @param integer error code
     * @access protected
     */
    function _getErrorMessage()
    {
        return array(
                PEAR_PACKAGEFILE_ERROR_NO_NAME =>
                    'Missing Package Name',
                PEAR_PACKAGEFILE_ERROR_NO_SUMMARY =>
                    'No summary found',
                PEAR_PACKAGEFILE_ERROR_MULTILINE_SUMMARY =>
                    'Summary should be on one line',
                PEAR_PACKAGEFILE_ERROR_NO_DESCRIPTION =>
                    'Missing description',
                PEAR_PACKAGEFILE_ERROR_NO_LICENSE =>
                    'Missing license',
                PEAR_PACKAGEFILE_ERROR_NO_VERSION =>
                    'No release version found',
                PEAR_PACKAGEFILE_ERROR_NO_STATE =>
                    'No release state found',
                PEAR_PACKAGEFILE_ERROR_NO_DATE =>
                    'No release date found',
                PEAR_PACKAGEFILE_ERROR_NO_NOTES =>
                    'No release notes found',
                PEAR_PACKAGEFILE_ERROR_NO_LEAD =>
                    'Package must have at least one lead maintainer',
                PEAR_PACKAGEFILE_ERROR_NO_MAINTAINERS =>
                    'No maintainers found, at least one must be defined',
                PEAR_PACKAGEFILE_ERROR_NO_MAINTHANDLE =>
                    'Maintainer %index% has no handle (user ID at channel server)',
                PEAR_PACKAGEFILE_ERROR_NO_MAINTROLE =>
                    'Maintainer %index% has no role',
                PEAR_PACKAGEFILE_ERROR_NO_MAINTNAME =>
                    'Maintainer %index% has no name',
                PEAR_PACKAGEFILE_ERROR_NO_MAINTEMAIL =>
                    'Maintainer %index% has no email',
                PEAR_PACKAGEFILE_ERROR_NO_DEPNAME =>
                    'Dependency %index% is not a php dependency, and has no name',
                PEAR_PACKAGEFILE_ERROR_NO_DEPREL =>
                    'Dependency %index% has no relation (rel)',
                PEAR_PACKAGEFILE_ERROR_NO_DEPTYPE =>
                    'Dependency %index% has no type',
                PEAR_PACKAGEFILE_ERROR_DEPNAME_IGNORED =>
                    'PHP Dependency %index% has a name attribute of "%name%" which will be' .
                        ' ignored!',
                PEAR_PACKAGEFILE_ERROR_NO_DEPVERSION =>
                    'Dependency %index% is not a rel="has" or rel="not" dependency, ' .
                        'and has no version',
                PEAR_PACKAGEFILE_ERROR_NO_DEPPHPVERSION =>
                    'Dependency %index% is a type="php" dependency, ' .
                        'and has no version',
                PEAR_PACKAGEFILE_ERROR_DEPVERSION_IGNORED =>
                    'Dependency %index% is a rel="%rel%" dependency, versioning is ignored',
                PEAR_PACKAGEFILE_ERROR_INVALID_DEPOPTIONAL =>
                    'Dependency %index% has invalid optional value "%opt%", should be yes or no',
                PEAR_PACKAGEFILE_PHP_NO_NOT =>
                    'Dependency %index%: php dependencies cannot use "not" rel, use "ne"' .
                        ' to exclude specific versions',
                PEAR_PACKAGEFILE_ERROR_NO_CONFNAME =>
                    'Configure Option %index% has no name',
                PEAR_PACKAGEFILE_ERROR_NO_CONFPROMPT =>
                    'Configure Option %index% has no prompt',
                PEAR_PACKAGEFILE_ERROR_NO_FILES =>
                    'No files in <filelist> section of package.xml',
                PEAR_PACKAGEFILE_ERROR_NO_FILEROLE =>
                    'File "%file%" has no role, expecting one of "%roles%"',
                PEAR_PACKAGEFILE_ERROR_INVALID_FILEROLE =>
                    'File "%file%" has invalid role "%role%", expecting one of "%roles%"',
                PEAR_PACKAGEFILE_ERROR_INVALID_FILENAME =>
                    'File "%file%" cannot start with ".", cannot package or install',
                PEAR_PACKAGEFILE_ERROR_INVALID_PHPFILE =>
                    'Parser error: invalid PHP found in file "%file%"',
                PEAR_PACKAGEFILE_ERROR_NO_PNAME_PREFIX =>
                    'in %file%: %type% "%name%" not prefixed with package name "%package%"',
                PEAR_PACKAGEFILE_ERROR_INVALID_FILE =>
                    'Parser error: invalid PHP file "%file%"',
                PEAR_PACKAGEFILE_ERROR_CHANNELVAL =>
                    'Channel validator error: field "%field%" - %reason%',
                PEAR_PACKAGEFILE_ERROR_PHP5 =>
                    'Error, PHP5 token encountered in %file%, analysis should be in PHP5',
                PEAR_PACKAGEFILE_ERROR_FILE_NOTFOUND =>
                    'File "%file%" in package.xml does not exist',
                PEAR_PACKAGEFILE_ERROR_NON_ISO_CHARS =>
                    'Package.xml contains non-ISO-8859-1 characters, and may not validate',
            );
    }
 
    /**
     * Validate XML package definition file.
     *
     * @access public
     * @return boolean
     */
    function validate($state = PEAR_VALIDATE_NORMAL, $nofilechecking = false)
    {
        if (($this->_isValid & $state) == $state) {
            return true;
        }
        $this->_isValid = true;
        $info = $this->_packageInfo;
        if (empty($info['package'])) {
            $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_NAME);
            $this->_packageName = $pn = 'unknown';
        } else {
            $this->_packageName = $pn = $info['package'];
        }
 
        if (empty($info['summary'])) {
            $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_SUMMARY);
        } elseif (strpos(trim($info['summary']), "\n") !== false) {
            $this->_validateWarning(PEAR_PACKAGEFILE_ERROR_MULTILINE_SUMMARY,
                array('summary' => $info['summary']));
        }
        if (empty($info['description'])) {
            $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_DESCRIPTION);
        }
        if (empty($info['release_license'])) {
            $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_LICENSE);
        }
        if (empty($info['version'])) {
            $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_VERSION);
        }
        if (empty($info['release_state'])) {
            $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_STATE);
        }
        if (empty($info['release_date'])) {
            $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_DATE);
        }
        if (empty($info['release_notes'])) {
            $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_NOTES);
        }
        if (empty($info['maintainers'])) {
            $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_MAINTAINERS);
        } else {
            $haslead = false;
            $i = 1;
            foreach ($info['maintainers'] as $m) {
                if (empty($m['handle'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_MAINTHANDLE,
                        array('index' => $i));
                }
                if (empty($m['role'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_MAINTROLE,
                        array('index' => $i, 'roles' => PEAR_Common::getUserRoles()));
                } elseif ($m['role'] == 'lead') {
                    $haslead = true;
                }
                if (empty($m['name'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_MAINTNAME,
                        array('index' => $i));
                }
                if (empty($m['email'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_MAINTEMAIL,
                        array('index' => $i));
                }
                $i++;
            }
            if (!$haslead) {
                $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_LEAD);
            }
        }
        if (!empty($info['release_deps'])) {
            $i = 1;
            foreach ($info['release_deps'] as $d) {
                if (!isset($d['type']) || empty($d['type'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_DEPTYPE,
                        array('index' => $i, 'types' => PEAR_Common::getDependencyTypes()));
                    continue;
                }
                if (!isset($d['rel']) || empty($d['rel'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_DEPREL,
                        array('index' => $i, 'rels' => PEAR_Common::getDependencyRelations()));
                    continue;
                }
                if (!empty($d['optional'])) {
                    if (!in_array($d['optional'], array('yes', 'no'))) {
                        $this->_validateError(PEAR_PACKAGEFILE_ERROR_INVALID_DEPOPTIONAL,
                            array('index' => $i, 'opt' => $d['optional']));
                    }
                }
                if ($d['rel'] != 'has' && $d['rel'] != 'not' && empty($d['version'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_DEPVERSION,
                        array('index' => $i));
                } elseif (($d['rel'] == 'has' || $d['rel'] == 'not') && !empty($d['version'])) {
                    $this->_validateWarning(PEAR_PACKAGEFILE_ERROR_DEPVERSION_IGNORED,
                        array('index' => $i, 'rel' => $d['rel']));
                }
                if ($d['type'] == 'php' && !empty($d['name'])) {
                    $this->_validateWarning(PEAR_PACKAGEFILE_ERROR_DEPNAME_IGNORED,
                        array('index' => $i, 'name' => $d['name']));
                } elseif ($d['type'] != 'php' && empty($d['name'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_DEPNAME,
                        array('index' => $i));
                }
                if ($d['type'] == 'php' && empty($d['version'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_DEPPHPVERSION,
                        array('index' => $i));
                }
                if (($d['rel'] == 'not') && ($d['type'] == 'php')) {
                    $this->_validateError(PEAR_PACKAGEFILE_PHP_NO_NOT,
                        array('index' => $i));
                }
                $i++;
            }
        }
        if (!empty($info['configure_options'])) {
            $i = 1;
            foreach ($info['configure_options'] as $c) {
                if (empty($c['name'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_CONFNAME,
                        array('index' => $i));
                }
                if (empty($c['prompt'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_CONFPROMPT,
                        array('index' => $i));
                }
                $i++;
            }
        }
        if (empty($info['filelist'])) {
            $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_FILES);
            $errors[] = 'no files';
        } else {
            foreach ($info['filelist'] as $file => $fa) {
                if (empty($fa['role'])) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_NO_FILEROLE,
                        array('file' => $file, 'roles' => PEAR_Common::getFileRoles()));
                    continue;
                } elseif (!in_array($fa['role'], PEAR_Common::getFileRoles())) {
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_INVALID_FILEROLE,
                        array('file' => $file, 'role' => $fa['role'], 'roles' => PEAR_Common::getFileRoles()));
                }
                if (preg_match('~/\.\.?(/|\\z)|^\.\.?/~', str_replace('\\', '/', $file))) {
                    // file contains .. parent directory or . cur directory references
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_INVALID_FILENAME,
                        array('file' => $file));
                }
                if (isset($fa['install-as']) &&
                      preg_match('~/\.\.?(/|\\z)|^\.\.?/~', 
                                 str_replace('\\', '/', $fa['install-as']))) {
                    // install-as contains .. parent directory or . cur directory references
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_INVALID_FILENAME,
                        array('file' => $file . ' [installed as ' . $fa['install-as'] . ']'));
                }
                if (isset($fa['baseinstalldir']) &&
                      preg_match('~/\.\.?(/|\\z)|^\.\.?/~', 
                                 str_replace('\\', '/', $fa['baseinstalldir']))) {
                    // install-as contains .. parent directory or . cur directory references
                    $this->_validateError(PEAR_PACKAGEFILE_ERROR_INVALID_FILENAME,
                        array('file' => $file . ' [baseinstalldir ' . $fa['baseinstalldir'] . ']'));
                }
            }
        }
        if (isset($this->_registry) && $this->_isValid) {
            $chan = $this->_registry->getChannel('pear.php.net');
            if (PEAR::isError($chan)) {
                $this->_validateError(PEAR_PACKAGEFILE_ERROR_CHANNELVAL, $chan->getMessage());
                return $this->_isValid = 0;
            }
            $validator = $chan->getValidationObject();
            $validator->setPackageFile($this);
            $validator->validate($state);
            $failures = $validator->getFailures();
            foreach ($failures['errors'] as $error) {
                $this->_validateError(PEAR_PACKAGEFILE_ERROR_CHANNELVAL, $error);
            }
            foreach ($failures['warnings'] as $warning) {
                $this->_validateWarning(PEAR_PACKAGEFILE_ERROR_CHANNELVAL, $warning);
            }
        }
        if ($this->_isValid && $state == PEAR_VALIDATE_PACKAGING && !$nofilechecking) {
            if ($this->_analyzePhpFiles()) {
                $this->_isValid = true;
            }
        }
        if ($this->_isValid) {
            return $this->_isValid = $state;
        }
        return $this->_isValid = 0;
    }
 
    function _analyzePhpFiles()
    {
        if (!$this->_isValid) {
            return false;
        }
        if (!isset($this->_packageFile)) {
            return false;
        }
        $dir_prefix = dirname($this->_packageFile);
        $common = new PEAR_Common;
        $log = isset($this->_logger) ? array(&$this->_logger, 'log') :
            array($common, 'log');
        $info = $this->getFilelist();
        foreach ($info as $file => $fa) {
            if (!file_exists($dir_prefix . DIRECTORY_SEPARATOR . $file)) {
                $this->_validateError(PEAR_PACKAGEFILE_ERROR_FILE_NOTFOUND,
                    array('file' => realpath($dir_prefix) . DIRECTORY_SEPARATOR . $file));
                continue;
            }
            if ($fa['role'] == 'php' && $dir_prefix) {
                call_user_func_array($log, array(1, "Analyzing $file"));
                $srcinfo = $this->_analyzeSourceCode($dir_prefix . DIRECTORY_SEPARATOR . $file);
                if ($srcinfo) {
                    $this->_buildProvidesArray($srcinfo);
                }
            }
        }
        $this->_packageName = $pn = $this->getPackage();
        $pnl = strlen($pn);
        if (isset($this->_packageInfo['provides'])) {
            foreach ((array) $this->_packageInfo['provides'] as $key => $what) {
                if (isset($what['explicit'])) {
                    // skip conformance checks if the provides entry is
                    // specified in the package.xml file
                    continue;
                }
                extract($what);
                if ($type == 'class') {
                    if (!strncasecmp($name, $pn, $pnl)) {
                        continue;
                    }
                    $this->_validateWarning(PEAR_PACKAGEFILE_ERROR_NO_PNAME_PREFIX,
                        array('file' => $file, 'type' => $type, 'name' => $name, 'package' => $pn));
                } elseif ($type == 'function') {
                    if (strstr($name, '::') || !strncasecmp($name, $pn, $pnl)) {
                        continue;
                    }
                    $this->_validateWarning(PEAR_PACKAGEFILE_ERROR_NO_PNAME_PREFIX,
                        array('file' => $file, 'type' => $type, 'name' => $name, 'package' => $pn));
                }
            }
        }
        return $this->_isValid;
    }
 
    /**
     * Get the default xml generator object
     *
     * @return PEAR_PackageFile_Generator_v1
     */
    function &getDefaultGenerator()
    {
        if (!class_exists('PEAR_PackageFile_Generator_v1')) {
            require_once 'PEAR/PackageFile/Generator/v1.php';
        }
        $a = new PEAR_PackageFile_Generator_v1($this);
        return $a;
    }
 
    /**
     * Get the contents of a file listed within the package.xml
     * @param string
     * @return string
     */
    function getFileContents($file)
    {
        if ($this->_archiveFile == $this->_packageFile) { // unpacked
            $dir = dirname($this->_packageFile);
            $file = $dir . DIRECTORY_SEPARATOR . $file;
            $file = str_replace(array('/', '\\'),
                array(DIRECTORY_SEPARATOR, DIRECTORY_SEPARATOR), $file);
            if (file_exists($file) && is_readable($file)) {
                return implode('', file($file));
            }
        } else { // tgz
            if (!class_exists('Archive_Tar')) {
                require_once 'Archive/Tar.php';
            }
            $tar = new Archive_Tar($this->_archiveFile);
            $tar->pushErrorHandling(PEAR_ERROR_RETURN);
            if ($file != 'package.xml' && $file != 'package2.xml') {
                $file = $this->getPackage() . '-' . $this->getVersion() . '/' . $file;
            }
            $file = $tar->extractInString($file);
            $tar->popErrorHandling();
            if (PEAR::isError($file)) {
                return PEAR::raiseError("Cannot locate file '$file' in archive");
            }
            return $file;
        }
    }
 
    // {{{ analyzeSourceCode()
    /**
     * Analyze the source code of the given PHP file
     *
     * @param  string Filename of the PHP file
     * @return mixed
     * @access private
     */
    function _analyzeSourceCode($file)
    {
        if (!function_exists("token_get_all")) {
            return false;
        }
        if (!defined('T_DOC_COMMENT')) {
            define('T_DOC_COMMENT', T_COMMENT);
        }
        if (!defined('T_INTERFACE')) {
            define('T_INTERFACE', -1);
        }
        if (!defined('T_IMPLEMENTS')) {
            define('T_IMPLEMENTS', -1);
        }
        if (!$fp = @fopen($file, "r")) {
            return false;
        }
        fclose($fp);
        $contents = file_get_contents($file);
        $tokens = token_get_all($contents);
/*
        for ($i = 0; $i < sizeof($tokens); $i++) {
            @list($token, $data) = $tokens[$i];
            if (is_string($token)) {
                var_dump($token);
            } else {
                print token_name($token) . ' ';
                var_dump(rtrim($data));
            }
        }
*/
        $look_for = 0;
        $paren_level = 0;
        $bracket_level = 0;
        $brace_level = 0;
        $lastphpdoc = '';
        $current_class = '';
        $current_interface = '';
        $current_class_level = -1;
        $current_function = '';
        $current_function_level = -1;
        $declared_classes = array();
        $declared_interfaces = array();
        $declared_functions = array();
        $declared_methods = array();
        $used_classes = array();
        $used_functions = array();
        $extends = array();
        $implements = array();
        $nodeps = array();
        $inquote = false;
        $interface = false;
        for ($i = 0; $i < sizeof($tokens); $i++) {
            if (is_array($tokens[$i])) {
                list($token, $data) = $tokens[$i];
            } else {
                $token = $tokens[$i];
                $data = '';
            }
            if ($inquote) {
                if ($token != '"' && $token != T_END_HEREDOC) {
                    continue;
                } else {
                    $inquote = false;
                    continue;
                }
            }
            switch ($token) {
                case T_WHITESPACE :
                    continue;
                case ';':
                    if ($interface) {
                        $current_function = '';
                        $current_function_level = -1;
                    }
                    break;
                case '"':
                case T_START_HEREDOC:
                    $inquote = true;
                    break;
                case T_CURLY_OPEN:
                case T_DOLLAR_OPEN_CURLY_BRACES:
                case '{': $brace_level++; continue 2;
                case '}':
                    $brace_level--;
                    if ($current_class_level == $brace_level) {
                        $current_class = '';
                        $current_class_level = -1;
                    }
                    if ($current_function_level == $brace_level) {
                        $current_function = '';
                        $current_function_level = -1;
                    }
                    continue 2;
                case '[': $bracket_level++; continue 2;
                case ']': $bracket_level--; continue 2;
                case '(': $paren_level++;   continue 2;
                case ')': $paren_level--;   continue 2;
                case T_INTERFACE:
                    $interface = true;
                case T_CLASS:
                    if (($current_class_level != -1) || ($current_function_level != -1)) {
                        $this->_validateError(PEAR_PACKAGEFILE_ERROR_INVALID_PHPFILE,
                            array('file' => $file));
                        return false;
                    }
                case T_FUNCTION:
                case T_NEW:
                case T_EXTENDS:
                case T_IMPLEMENTS:
                    $look_for = $token;
                    continue 2;
                case T_STRING:
 
 
 
 
 
 
 
 
 
                    if ($look_for == T_CLASS) {
                        $current_class = $data;
                        $current_class_level = $brace_level;
                        $declared_classes[] = $current_class;
                    } elseif ($look_for == T_INTERFACE) {
                        $current_interface = $data;
                        $current_class_level = $brace_level;
                        $declared_interfaces[] = $current_interface;
                    } elseif ($look_for == T_IMPLEMENTS) {
                        $implements[$current_class] = $data;
                    } elseif ($look_for == T_EXTENDS) {
                        $extends[$current_class] = $data;
                    } elseif ($look_for == T_FUNCTION) {
                        if ($current_class) {
                            $current_function = "$current_class::$data";
                            $declared_methods[$current_class][] = $data;
                        } elseif ($current_interface) {
                            $current_function = "$current_interface::$data";
                            $declared_methods[$current_interface][] = $data;
                        } else {
                            $current_function = $data;
                            $declared_functions[] = $current_function;
                        }
                        $current_function_level = $brace_level;
                        $m = array();
                    } elseif ($look_for == T_NEW) {
                        $used_classes[$data] = true;
                    }
                    $look_for = 0;
                    continue 2;
                case T_VARIABLE:
                    $look_for = 0;
                    continue 2;
                case T_DOC_COMMENT:
                case T_COMMENT:
                    if (preg_match('!^/\*\*\s!', $data)) {
                        $lastphpdoc = $data;
                        if (preg_match_all('/@nodep\s+(\S+)/', $lastphpdoc, $m)) {
                            $nodeps = array_merge($nodeps, $m[1]);
                        }
                    }
                    continue 2;
                case T_DOUBLE_COLON:
                    if (!($tokens[$i - 1][0] == T_WHITESPACE || $tokens[$i - 1][0] == T_STRING)) {
                        $this->_validateError(PEAR_PACKAGEFILE_ERROR_INVALID_PHPFILE,
                            array('file' => $file));
                        return false;
                    }
                    $class = $tokens[$i - 1][1];
                    if (strtolower($class) != 'parent') {
                        $used_classes[$class] = true;
                    }
                    continue 2;
            }
        }
        return array(
            "source_file" => $file,
            "declared_classes" => $declared_classes,
            "declared_interfaces" => $declared_interfaces,
            "declared_methods" => $declared_methods,
            "declared_functions" => $declared_functions,
            "used_classes" => array_diff(array_keys($used_classes), $nodeps),
            "inheritance" => $extends,
            "implements" => $implements,
            );
    }
 
    /**
     * Build a "provides" array from data returned by
     * analyzeSourceCode().  The format of the built array is like
     * this:
     *
     *  array(
     *    'class;MyClass' => 'array('type' => 'class', 'name' => 'MyClass'),
     *    ...
     *  )
     *
     *
     * @param array $srcinfo array with information about a source file
     * as returned by the analyzeSourceCode() method.
     *
     * @return void
     *
     * @access private
     *
     */
    function _buildProvidesArray($srcinfo)
    {
        if (!$this->_isValid) {
            return false;
        }
        $file = basename($srcinfo['source_file']);
        $pn = $this->getPackage();
        $pnl = strlen($pn);
        foreach ($srcinfo['declared_classes'] as $class) {
            $key = "class;$class";
            if (isset($this->_packageInfo['provides'][$key])) {
                continue;
            }
            $this->_packageInfo['provides'][$key] =
                array('file'=> $file, 'type' => 'class', 'name' => $class);
            if (isset($srcinfo['inheritance'][$class])) {
                $this->_packageInfo['provides'][$key]['extends'] =
                    $srcinfo['inheritance'][$class];
            }
        }
        foreach ($srcinfo['declared_methods'] as $class => $methods) {
            foreach ($methods as $method) {
                $function = "$class::$method";
                $key = "function;$function";
                if ($method{0} == '_' || !strcasecmp($method, $class) ||
                    isset($this->_packageInfo['provides'][$key])) {
                    continue;
                }
                $this->_packageInfo['provides'][$key] =
                    array('file'=> $file, 'type' => 'function', 'name' => $function);
            }
        }
 
        foreach ($srcinfo['declared_functions'] as $function) {
            $key = "function;$function";
            if ($function{0} == '_' || isset($this->_packageInfo['provides'][$key])) {
                continue;
            }
            if (!strstr($function, '::') && strncasecmp($function, $pn, $pnl)) {
                $warnings[] = "in1 " . $file . ": function \"$function\" not prefixed with package name \"$pn\"";
            }
            $this->_packageInfo['provides'][$key] =
                array('file'=> $file, 'type' => 'function', 'name' => $function);
        }
    }
 
    // }}}
}
?>

Rev 94	Rev 187
1	`<?php`	1	`<?php`
2	`/**`	2	`/**`
3	`* PEAR_PackageFile_v1, package.xml version 1.0`	3	`* PEAR_PackageFile_v1, package.xml version 1.0`
4	`*`	4	`*`
5	`* PHP versions 4 and 5`	5	`* PHP versions 4 and 5`
6	`*`	6	`*`
7	`* LICENSE: This source file is subject to version 3.0 of the PHP license`	-
8	`* that is available through the world-wide-web at the following URI:`	-
9	`* http://www.php.net/license/3_0.txt. If you did not receive a copy of`	-
10	`* the PHP License and are unable to obtain it through the web, please`	-
11	`* send a note to license@php.net so we can mail you a copy immediately.`	-
12	`*`	-
13	`* @category pear`	7	`* @category pear`
14	`* @package PEAR`	8	`* @package PEAR`
15	`* @author Greg Beaver <cellog@php.net>`	9	`* @author Greg Beaver <cellog@php.net>`
16	`* @copyright 1997-2006 The PHP Group`	10	`* @copyright 1997-2009 The Authors`
17	`* @license http://www.php.net/license/3_0.txt PHP License 3.0`	11	`* @license http://opensource.org/licenses/bsd-license.php New BSD License`
18	`* @version CVS: $Id: v1.php,v 1.72 2006/10/31 02:54:41 cellog Exp $`	-
19	`* @link http://pear.php.net/package/PEAR`	12	`* @link http://pear.php.net/package/PEAR`
20	`* @since File available since Release 1.4.0a1`	13	`* @since File available since Release 1.4.0a1`
21	`*/`	14	`*/`
22	`/**`	15	`/**`
23	`* For error handling`	16	`* For error handling`
24	`*/`	17	`*/`
25	`require_once 'PEAR/ErrorStack.php';`	18	`require_once 'PEAR/ErrorStack.php';`
26		19
27	`/**`	20	`/**`
28	`* Error code if parsing is attempted with no xml extension`	21	`* Error code if parsing is attempted with no xml extension`
29	`*/`	22	`*/`
30	`define('PEAR_PACKAGEFILE_ERROR_NO_XML_EXT', 3);`	23	`define('PEAR_PACKAGEFILE_ERROR_NO_XML_EXT', 3);`
31		24
32	`/**`	25	`/**`
33	`* Error code if creating the xml parser resource fails`	26	`* Error code if creating the xml parser resource fails`
34	`*/`	27	`*/`
35	`define('PEAR_PACKAGEFILE_ERROR_CANT_MAKE_PARSER', 4);`	28	`define('PEAR_PACKAGEFILE_ERROR_CANT_MAKE_PARSER', 4);`
36		29
37	`/**`	30	`/**`
38	`* Error code used for all sax xml parsing errors`	31	`* Error code used for all sax xml parsing errors`
39	`*/`	32	`*/`
40	`define('PEAR_PACKAGEFILE_ERROR_PARSER_ERROR', 5);`	33	`define('PEAR_PACKAGEFILE_ERROR_PARSER_ERROR', 5);`
41		34
42	`/**`	35	`/**`
43	`* Error code used when there is no name`	36	`* Error code used when there is no name`
44	`*/`	37	`*/`
45	`define('PEAR_PACKAGEFILE_ERROR_NO_NAME', 6);`	38	`define('PEAR_PACKAGEFILE_ERROR_NO_NAME', 6);`
46		39
47	`/**`	40	`/**`
48	`* Error code when a package name is not valid`	41	`* Error code when a package name is not valid`
49	`*/`	42	`*/`
50	`define('PEAR_PACKAGEFILE_ERROR_INVALID_NAME', 7);`	43	`define('PEAR_PACKAGEFILE_ERROR_INVALID_NAME', 7);`
51		44
52	`/**`	45	`/**`
53	`* Error code used when no summary is parsed`	46	`* Error code used when no summary is parsed`
54	`*/`	47	`*/`
55	`define('PEAR_PACKAGEFILE_ERROR_NO_SUMMARY', 8);`	48	`define('PEAR_PACKAGEFILE_ERROR_NO_SUMMARY', 8);`
56		49
57	`/**`	50	`/**`
58	`* Error code for summaries that are more than 1 line`	51	`* Error code for summaries that are more than 1 line`
59	`*/`	52	`*/`
60	`define('PEAR_PACKAGEFILE_ERROR_MULTILINE_SUMMARY', 9);`	53	`define('PEAR_PACKAGEFILE_ERROR_MULTILINE_SUMMARY', 9);`
61		54
62	`/**`	55	`/**`
63	`* Error code used when no description is present`	56	`* Error code used when no description is present`
64	`*/`	57	`*/`
65	`define('PEAR_PACKAGEFILE_ERROR_NO_DESCRIPTION', 10);`	58	`define('PEAR_PACKAGEFILE_ERROR_NO_DESCRIPTION', 10);`
66		59
67	`/**`	60	`/**`
68	`* Error code used when no license is present`	61	`* Error code used when no license is present`
69	`*/`	62	`*/`
70	`define('PEAR_PACKAGEFILE_ERROR_NO_LICENSE', 11);`	63	`define('PEAR_PACKAGEFILE_ERROR_NO_LICENSE', 11);`
71		64
72	`/**`	65	`/**`
73	`* Error code used when a <version> version number is not present`	66	`* Error code used when a <version> version number is not present`
74	`*/`	67	`*/`
75	`define('PEAR_PACKAGEFILE_ERROR_NO_VERSION', 12);`	68	`define('PEAR_PACKAGEFILE_ERROR_NO_VERSION', 12);`
76		69
77	`/**`	70	`/**`
78	`* Error code used when a <version> version number is invalid`	71	`* Error code used when a <version> version number is invalid`
79	`*/`	72	`*/`
80	`define('PEAR_PACKAGEFILE_ERROR_INVALID_VERSION', 13);`	73	`define('PEAR_PACKAGEFILE_ERROR_INVALID_VERSION', 13);`
81		74
82	`/**`	75	`/**`
83	`* Error code when release state is missing`	76	`* Error code when release state is missing`
84	`*/`	77	`*/`
85	`define('PEAR_PACKAGEFILE_ERROR_NO_STATE', 14);`	78	`define('PEAR_PACKAGEFILE_ERROR_NO_STATE', 14);`
86		79
87	`/**`	80	`/**`
88	`* Error code when release state is invalid`	81	`* Error code when release state is invalid`
89	`*/`	82	`*/`
90	`define('PEAR_PACKAGEFILE_ERROR_INVALID_STATE', 15);`	83	`define('PEAR_PACKAGEFILE_ERROR_INVALID_STATE', 15);`
91		84
92	`/**`	85	`/**`
93	`* Error code when release state is missing`	86	`* Error code when release state is missing`
94	`*/`	87	`*/`
95	`define('PEAR_PACKAGEFILE_ERROR_NO_DATE', 16);`	88	`define('PEAR_PACKAGEFILE_ERROR_NO_DATE', 16);`
96		89
97	`/**`	90	`/**`
98	`* Error code when release state is invalid`	91	`* Error code when release state is invalid`
99	`*/`	92	`*/`
100	`define('PEAR_PACKAGEFILE_ERROR_INVALID_DATE', 17);`	93	`define('PEAR_PACKAGEFILE_ERROR_INVALID_DATE', 17);`
101		94
102	`/**`	95	`/**`
103	`* Error code when no release notes are found`	96	`* Error code when no release notes are found`
104	`*/`	97	`*/`
105	`define('PEAR_PACKAGEFILE_ERROR_NO_NOTES', 18);`	98	`define('PEAR_PACKAGEFILE_ERROR_NO_NOTES', 18);`
106		99
107	`/**`	100	`/**`
108	`* Error code when no maintainers are found`	101	`* Error code when no maintainers are found`
109	`*/`	102	`*/`
110	`define('PEAR_PACKAGEFILE_ERROR_NO_MAINTAINERS', 19);`	103	`define('PEAR_PACKAGEFILE_ERROR_NO_MAINTAINERS', 19);`
111		104
112	`/**`	105	`/**`
113	`* Error code when a maintainer has no handle`	106	`* Error code when a maintainer has no handle`
114	`*/`	107	`*/`
115	`define('PEAR_PACKAGEFILE_ERROR_NO_MAINTHANDLE', 20);`	108	`define('PEAR_PACKAGEFILE_ERROR_NO_MAINTHANDLE', 20);`
116		109
117	`/**`	110	`/**`
118	`* Error code when a maintainer has no handle`	111	`* Error code when a maintainer has no handle`
119	`*/`	112	`*/`
120	`define('PEAR_PACKAGEFILE_ERROR_NO_MAINTROLE', 21);`	113	`define('PEAR_PACKAGEFILE_ERROR_NO_MAINTROLE', 21);`
121		114
122	`/**`	115	`/**`
123	`* Error code when a maintainer has no name`	116	`* Error code when a maintainer has no name`
124	`*/`	117	`*/`
125	`define('PEAR_PACKAGEFILE_ERROR_NO_MAINTNAME', 22);`	118	`define('PEAR_PACKAGEFILE_ERROR_NO_MAINTNAME', 22);`
126		119
127	`/**`	120	`/**`
128	`* Error code when a maintainer has no email`	121	`* Error code when a maintainer has no email`
129	`*/`	122	`*/`
130	`define('PEAR_PACKAGEFILE_ERROR_NO_MAINTEMAIL', 23);`	123	`define('PEAR_PACKAGEFILE_ERROR_NO_MAINTEMAIL', 23);`
131		124
132	`/**`	125	`/**`
133	`* Error code when a maintainer has no handle`	126	`* Error code when a maintainer has no handle`
134	`*/`	127	`*/`
135	`define('PEAR_PACKAGEFILE_ERROR_INVALID_MAINTROLE', 24);`	128	`define('PEAR_PACKAGEFILE_ERROR_INVALID_MAINTROLE', 24);`
136		129
137	`/**`	130	`/**`
138	`* Error code when a dependency is not a PHP dependency, but has no name`	131	`* Error code when a dependency is not a PHP dependency, but has no name`
139	`*/`	132	`*/`
140	`define('PEAR_PACKAGEFILE_ERROR_NO_DEPNAME', 25);`	133	`define('PEAR_PACKAGEFILE_ERROR_NO_DEPNAME', 25);`
141		134
142	`/**`	135	`/**`
143	`* Error code when a dependency has no type (pkg, php, etc.)`	136	`* Error code when a dependency has no type (pkg, php, etc.)`
144	`*/`	137	`*/`
145	`define('PEAR_PACKAGEFILE_ERROR_NO_DEPTYPE', 26);`	138	`define('PEAR_PACKAGEFILE_ERROR_NO_DEPTYPE', 26);`
146		139
147	`/**`	140	`/**`
148	`* Error code when a dependency has no relation (lt, ge, has, etc.)`	141	`* Error code when a dependency has no relation (lt, ge, has, etc.)`
149	`*/`	142	`*/`
150	`define('PEAR_PACKAGEFILE_ERROR_NO_DEPREL', 27);`	143	`define('PEAR_PACKAGEFILE_ERROR_NO_DEPREL', 27);`
151		144
152	`/**`	145	`/**`
153	`* Error code when a dependency is not a 'has' relation, but has no version`	146	`* Error code when a dependency is not a 'has' relation, but has no version`
154	`*/`	147	`*/`
155	`define('PEAR_PACKAGEFILE_ERROR_NO_DEPVERSION', 28);`	148	`define('PEAR_PACKAGEFILE_ERROR_NO_DEPVERSION', 28);`
156		149
157	`/**`	150	`/**`
158	`* Error code when a dependency has an invalid relation`	151	`* Error code when a dependency has an invalid relation`
159	`*/`	152	`*/`
160	`define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPREL', 29);`	153	`define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPREL', 29);`
161		154
162	`/**`	155	`/**`
163	`* Error code when a dependency has an invalid type`	156	`* Error code when a dependency has an invalid type`
164	`*/`	157	`*/`
165	`define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPTYPE', 30);`	158	`define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPTYPE', 30);`
166		159
167	`/**`	160	`/**`
168	`* Error code when a dependency has an invalid optional option`	161	`* Error code when a dependency has an invalid optional option`
169	`*/`	162	`*/`
170	`define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPOPTIONAL', 31);`	163	`define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPOPTIONAL', 31);`
171		164
172	`/**`	165	`/**`
173	`* Error code when a dependency is a pkg dependency, and has an invalid package name`	166	`* Error code when a dependency is a pkg dependency, and has an invalid package name`
174	`*/`	167	`*/`
175	`define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPNAME', 32);`	168	`define('PEAR_PACKAGEFILE_ERROR_INVALID_DEPNAME', 32);`
176		169
177	`/**`	170	`/**`
178	`* Error code when a dependency has a channel="foo" attribute, and foo is not a registered channel`	171	`* Error code when a dependency has a channel="foo" attribute, and foo is not a registered channel`
179	`*/`	172	`*/`
180	`define('PEAR_PACKAGEFILE_ERROR_UNKNOWN_DEPCHANNEL', 33);`	173	`define('PEAR_PACKAGEFILE_ERROR_UNKNOWN_DEPCHANNEL', 33);`
181		174
182	`/**`	175	`/**`
183	`* Error code when rel="has" and version attribute is present.`	176	`* Error code when rel="has" and version attribute is present.`
184	`*/`	177	`*/`
185	`define('PEAR_PACKAGEFILE_ERROR_DEPVERSION_IGNORED', 34);`	178	`define('PEAR_PACKAGEFILE_ERROR_DEPVERSION_IGNORED', 34);`
186		179
187	`/**`	180	`/**`
188	`* Error code when type="php" and dependency name is present`	181	`* Error code when type="php" and dependency name is present`
189	`*/`	182	`*/`
190	`define('PEAR_PACKAGEFILE_ERROR_DEPNAME_IGNORED', 35);`	183	`define('PEAR_PACKAGEFILE_ERROR_DEPNAME_IGNORED', 35);`
191		184
192	`/**`	185	`/**`
193	`* Error code when a configure option has no name`	186	`* Error code when a configure option has no name`
194	`*/`	187	`*/`
195	`define('PEAR_PACKAGEFILE_ERROR_NO_CONFNAME', 36);`	188	`define('PEAR_PACKAGEFILE_ERROR_NO_CONFNAME', 36);`
196		189
197	`/**`	190	`/**`
198	`* Error code when a configure option has no name`	191	`* Error code when a configure option has no name`
199	`*/`	192	`*/`
200	`define('PEAR_PACKAGEFILE_ERROR_NO_CONFPROMPT', 37);`	193	`define('PEAR_PACKAGEFILE_ERROR_NO_CONFPROMPT', 37);`
201		194
202	`/**`	195	`/**`
203	`* Error code when a file in the filelist has an invalid role`	196	`* Error code when a file in the filelist has an invalid role`
204	`*/`	197	`*/`
205	`define('PEAR_PACKAGEFILE_ERROR_INVALID_FILEROLE', 38);`	198	`define('PEAR_PACKAGEFILE_ERROR_INVALID_FILEROLE', 38);`
206		199
207	`/**`	200	`/**`
208	`* Error code when a file in the filelist has no role`	201	`* Error code when a file in the filelist has no role`
209	`*/`	202	`*/`
210	`define('PEAR_PACKAGEFILE_ERROR_NO_FILEROLE', 39);`	203	`define('PEAR_PACKAGEFILE_ERROR_NO_FILEROLE', 39);`
211		204
212	`/**`	205	`/**`
213	`* Error code when analyzing a php source file that has parse errors`	206	`* Error code when analyzing a php source file that has parse errors`
214	`*/`	207	`*/`
215	`define('PEAR_PACKAGEFILE_ERROR_INVALID_PHPFILE', 40);`	208	`define('PEAR_PACKAGEFILE_ERROR_INVALID_PHPFILE', 40);`
216		209
217	`/**`	210	`/**`
218	`* Error code when analyzing a php source file reveals a source element`	211	`* Error code when analyzing a php source file reveals a source element`
219	`* without a package name prefix`	212	`* without a package name prefix`
220	`*/`	213	`*/`
221	`define('PEAR_PACKAGEFILE_ERROR_NO_PNAME_PREFIX', 41);`	214	`define('PEAR_PACKAGEFILE_ERROR_NO_PNAME_PREFIX', 41);`
222		215
223	`/**`	216	`/**`
224	`* Error code when an unknown channel is specified`	217	`* Error code when an unknown channel is specified`
225	`*/`	218	`*/`
226	`define('PEAR_PACKAGEFILE_ERROR_UNKNOWN_CHANNEL', 42);`	219	`define('PEAR_PACKAGEFILE_ERROR_UNKNOWN_CHANNEL', 42);`
227		220
228	`/**`	221	`/**`
229	`* Error code when no files are found in the filelist`	222	`* Error code when no files are found in the filelist`
230	`*/`	223	`*/`
231	`define('PEAR_PACKAGEFILE_ERROR_NO_FILES', 43);`	224	`define('PEAR_PACKAGEFILE_ERROR_NO_FILES', 43);`
232		225
233	`/**`	226	`/**`
234	`* Error code when a file is not valid php according to _analyzeSourceCode()`	227	`* Error code when a file is not valid php according to _analyzeSourceCode()`
235	`*/`	228	`*/`
236	`define('PEAR_PACKAGEFILE_ERROR_INVALID_FILE', 44);`	229	`define('PEAR_PACKAGEFILE_ERROR_INVALID_FILE', 44);`
237		230
238	`/**`	231	`/**`
239	`* Error code when the channel validator returns an error or warning`	232	`* Error code when the channel validator returns an error or warning`
240	`*/`	233	`*/`
241	`define('PEAR_PACKAGEFILE_ERROR_CHANNELVAL', 45);`	234	`define('PEAR_PACKAGEFILE_ERROR_CHANNELVAL', 45);`
242		235
243	`/**`	236	`/**`
244	`* Error code when a php5 package is packaged in php4 (analysis doesn't work)`	237	`* Error code when a php5 package is packaged in php4 (analysis doesn't work)`
245	`*/`	238	`*/`
246	`define('PEAR_PACKAGEFILE_ERROR_PHP5', 46);`	239	`define('PEAR_PACKAGEFILE_ERROR_PHP5', 46);`
247		240
248	`/**`	241	`/**`
249	`* Error code when a file is listed in package.xml but does not exist`	242	`* Error code when a file is listed in package.xml but does not exist`
250	`*/`	243	`*/`
251	`define('PEAR_PACKAGEFILE_ERROR_FILE_NOTFOUND', 47);`	244	`define('PEAR_PACKAGEFILE_ERROR_FILE_NOTFOUND', 47);`
252		245
253	`/**`	246	`/**`
254	`* Error code when a <dep type="php" rel="not"... is encountered (use rel="ne")`	247	`* Error code when a <dep type="php" rel="not"... is encountered (use rel="ne")`
255	`*/`	248	`*/`
256	`define('PEAR_PACKAGEFILE_PHP_NO_NOT', 48);`	249	`define('PEAR_PACKAGEFILE_PHP_NO_NOT', 48);`
257		250
258	`/**`	251	`/**`
259	`* Error code when a package.xml contains non-ISO-8859-1 characters`	252	`* Error code when a package.xml contains non-ISO-8859-1 characters`
260	`*/`	253	`*/`
261	`define('PEAR_PACKAGEFILE_ERROR_NON_ISO_CHARS', 49);`	254	`define('PEAR_PACKAGEFILE_ERROR_NON_ISO_CHARS', 49);`
262		255
263	`/**`	256	`/**`
264	`* Error code when a dependency is not a 'has' relation, but has no version`	257	`* Error code when a dependency is not a 'has' relation, but has no version`
265	`*/`	258	`*/`
266	`define('PEAR_PACKAGEFILE_ERROR_NO_DEPPHPVERSION', 50);`	259	`define('PEAR_PACKAGEFILE_ERROR_NO_DEPPHPVERSION', 50);`
267		260
268	`/**`	261	`/**`
269	`* Error code when a package has no lead developer`	262	`* Error code when a package has no lead developer`
270	`*/`	263	`*/`
271	`define('PEAR_PACKAGEFILE_ERROR_NO_LEAD', 51);`	264	`define('PEAR_PACKAGEFILE_ERROR_NO_LEAD', 51);`
272		265
273	`/**`	266	`/**`
274	`* Error code when a filename begins with "."`	267	`* Error code when a filename begins with "."`
275	`*/`	268	`*/`
276	`define('PEAR_PACKAGEFILE_ERROR_INVALID_FILENAME', 52);`	269	`define('PEAR_PACKAGEFILE_ERROR_INVALID_FILENAME', 52);`
277	`/**`	270	`/**`
278	`* package.xml encapsulator`	271	`* package.xml encapsulator`
279	`* @category pear`	272	`* @category pear`
280	`* @package PEAR`	273	`* @package PEAR`
281	`* @author Greg Beaver <cellog@php.net>`	274	`* @author Greg Beaver <cellog@php.net>`
282	`* @copyright 1997-2006 The PHP Group`	275	`* @copyright 1997-2009 The Authors`
283	`* @license http://www.php.net/license/3_0.txt PHP License 3.0`	276	`* @license http://opensource.org/licenses/bsd-license.php New BSD License`
284	`* @version Release: 1.5.1`	277	`* @version Release: 1.10.1`
285	`* @link http://pear.php.net/package/PEAR`	278	`* @link http://pear.php.net/package/PEAR`
286	`* @since Class available since Release 1.4.0a1`	279	`* @since Class available since Release 1.4.0a1`
287	`*/`	280	`*/`
288	`class PEAR_PackageFile_v1`	281	`class PEAR_PackageFile_v1`
289	`{`	282	`{`
290	`/**`	283	`/**`
291	`* @access private`	284	`* @access private`
292	`* @var PEAR_ErrorStack`	285	`* @var PEAR_ErrorStack`
293	`* @access private`	286	`* @access private`
294	`*/`	287	`*/`
295	`var $_stack;`	288	`var $_stack;`
296		289
297	`/**`	290	`/**`
298	`* A registry object, used to access the package name validation regex for non-standard channels`	291	`* A registry object, used to access the package name validation regex for non-standard channels`
299	`* @var PEAR_Registry`	292	`* @var PEAR_Registry`
300	`* @access private`	293	`* @access private`
301	`*/`	294	`*/`
302	`var $_registry;`	295	`var $_registry;`
303		296
304	`/**`	297	`/**`
305	`* An object that contains a log method that matches PEAR_Common::log's signature`	298	`* An object that contains a log method that matches PEAR_Common::log's signature`
306	`* @var object`	299	`* @var object`
307	`* @access private`	300	`* @access private`
308	`*/`	301	`*/`
309	`var $_logger;`	302	`var $_logger;`
310		303
311	`/**`	304	`/**`
312	`* Parsed package information`	305	`* Parsed package information`
313	`* @var array`	306	`* @var array`
314	`* @access private`	307	`* @access private`
315	`*/`	308	`*/`
316	`var $_packageInfo;`	309	`var $_packageInfo;`
317		310
318	`/**`	311	`/**`
319	`* path to package.xml`	312	`* path to package.xml`
320	`* @var string`	313	`* @var string`
321	`* @access private`	314	`* @access private`
322	`*/`	315	`*/`
323	`var $_packageFile;`	316	`var $_packageFile;`
324		317
325	`/**`	318	`/**`
326	`* path to package .tgz or false if this is a local/extracted package.xml`	319	`* path to package .tgz or false if this is a local/extracted package.xml`
327	`* @var string`	320	`* @var string`
328	`* @access private`	321	`* @access private`
329	`*/`	322	`*/`
330	`var $_archiveFile;`	323	`var $_archiveFile;`
331		324
332	`/**`	325	`/**`
333	`* @var int`	326	`* @var int`
334	`* @access private`	327	`* @access private`
335	`*/`	328	`*/`
336	`var $_isValid = 0;`	329	`var $_isValid = 0;`
337		330
338	`/**`	331	`/**`
339	`* Determines whether this packagefile was initialized only with partial package info`	332	`* Determines whether this packagefile was initialized only with partial package info`
340	`*`	333	`*`
341	`* If this package file was constructed via parsing REST, it will only contain`	334	`* If this package file was constructed via parsing REST, it will only contain`
342	`*`	335	`*`
343	`* - package name`	336	`* - package name`
344	`* - channel name`	337	`* - channel name`
345	`* - dependencies`	338	`* - dependencies`
346	`* @var boolean`	339	`* @var boolean`
347	`* @access private`	340	`* @access private`
348	`*/`	341	`*/`
349	`var $_incomplete = true;`	342	`var $_incomplete = true;`
350		343
351	`/**`	344	`/**`
352	`* @param bool determines whether to return a PEAR_Error object, or use the PEAR_ErrorStack`	345	`* @param bool determines whether to return a PEAR_Error object, or use the PEAR_ErrorStack`
353	`* @param string Name of Error Stack class to use.`	346	`* @param string Name of Error Stack class to use.`
354	`*/`	347	`*/`
355	`function PEAR_PackageFile_v1()`	348	`function __construct()`
356	`{`	349	`{`
357	`$this->_stack = &new PEAR_ErrorStack('PEAR_PackageFile_v1');`	350	`$this->_stack = new PEAR_ErrorStack('PEAR_PackageFile_v1');`
358	`$this->_stack->setErrorMessageTemplate($this->_getErrorMessage());`	351	`$this->_stack->setErrorMessageTemplate($this->_getErrorMessage());`
359	`$this->_isValid = 0;`	352	`$this->_isValid = 0;`
360	`}`	353	`}`
361		354
362	`function installBinary($installer)`	355	`function installBinary($installer)`
363	`{`	356	`{`
364	`return false;`	357	`return false;`
365	`}`	358	`}`
366		359
367	`function isExtension($name)`	360	`function isExtension($name)`
368	`{`	361	`{`
369	`return false;`	362	`return false;`
370	`}`	363	`}`
371		364
372	`function setConfig(&$config)`	365	`function setConfig(&$config)`
373	`{`	366	`{`
374	`$this->_config = &$config;`	367	`$this->_config = &$config;`
375	`$this->_registry = &$config->getRegistry();`	368	`$this->_registry = &$config->getRegistry();`
376	`}`	369	`}`
377		370
378	`function setRequestedGroup()`	371	`function setRequestedGroup()`
379	`{`	372	`{`
380	`// placeholder`	373	`// placeholder`
381	`}`	374	`}`
382		375
383	`/**`	376	`/**`
384	`* For saving in the registry.`	377	`* For saving in the registry.`
385	`*`	378	`*`
386	`* Set the last version that was installed`	379	`* Set the last version that was installed`
387	`* @param string`	380	`* @param string`
388	`*/`	381	`*/`
389	`function setLastInstalledVersion($version)`	382	`function setLastInstalledVersion($version)`
390	`{`	383	`{`
391	`$this->_packageInfo['_lastversion'] = $version;`	384	`$this->_packageInfo['_lastversion'] = $version;`
392	`}`	385	`}`
393		386
394	`/**`	387	`/**`
395	`* @return string\|false`	388	`* @return string\|false`
396	`*/`	389	`*/`
397	`function getLastInstalledVersion()`	390	`function getLastInstalledVersion()`
398	`{`	391	`{`
399	`if (isset($this->_packageInfo['_lastversion'])) {`	392	`if (isset($this->_packageInfo['_lastversion'])) {`
400	`return $this->_packageInfo['_lastversion'];`	393	`return $this->_packageInfo['_lastversion'];`
401	`}`	394	`}`
402	`return false;`	395	`return false;`
403	`}`	396	`}`
404		397
405	`function getInstalledBinary()`	398	`function getInstalledBinary()`
406	`{`	399	`{`
407	`return false;`	400	`return false;`
408	`}`	401	`}`
409		402
410	`function listPostinstallScripts()`	403	`function listPostinstallScripts()`
411	`{`	404	`{`
412	`return false;`	405	`return false;`
413	`}`	406	`}`
414		407
415	`function initPostinstallScripts()`	408	`function initPostinstallScripts()`
416	`{`	409	`{`
417	`return false;`	410	`return false;`
418	`}`	411	`}`
419		412
420	`function setLogger(&$logger)`	413	`function setLogger(&$logger)`
421	`{`	414	`{`
422	`if ($logger && (!is_object($logger) \|\| !method_exists($logger, 'log'))) {`	415	`if ($logger && (!is_object($logger) \|\| !method_exists($logger, 'log'))) {`
423	`return PEAR::raiseError('Logger must be compatible with PEAR_Common::log');`	416	`return PEAR::raiseError('Logger must be compatible with PEAR_Common::log');`
424	`}`	417	`}`
425	`$this->_logger = &$logger;`	418	`$this->_logger = &$logger;`
426	`}`	419	`}`
427		420
428	`function setPackagefile($file, $archive = false)`	421	`function setPackagefile($file, $archive = false)`
429	`{`	422	`{`
430	`$this->_packageFile = $file;`	423	`$this->_packageFile = $file;`
431	`$this->_archiveFile = $archive ? $archive : $file;`	424	`$this->_archiveFile = $archive ? $archive : $file;`
432	`}`	425	`}`
433		426
434	`function getPackageFile()`	427	`function getPackageFile()`
435	`{`	428	`{`
436	`return isset($this->_packageFile) ? $this->_packageFile : false;`	429	`return isset($this->_packageFile) ? $this->_packageFile : false;`
437	`}`	430	`}`
438		431
439	`function getPackageType()`	432	`function getPackageType()`
440	`{`	433	`{`
441	`return 'php';`	434	`return 'php';`
442	`}`	435	`}`
443		436
444	`function getArchiveFile()`	437	`function getArchiveFile()`
445	`{`	438	`{`
446	`return $this->_archiveFile;`	439	`return $this->_archiveFile;`
447	`}`	440	`}`
448		441
449	`function packageInfo($field)`	442	`function packageInfo($field)`
450	`{`	443	`{`
451	`if (!is_string($field) \|\| empty($field) \|\|`	444	`if (!is_string($field) \|\| empty($field) \|\|`
452	`!isset($this->_packageInfo[$field])) {`	445	`!isset($this->_packageInfo[$field])) {`
453	`return false;`	446	`return false;`
454	`}`	447	`}`
455	`return $this->_packageInfo[$field];`	448	`return $this->_packageInfo[$field];`
456	`}`	449	`}`
457		450
458	`function setDirtree($path)`	451	`function setDirtree($path)`
459	`{`	452	`{`
460	`if (!isset($this->_packageInfo['dirtree'])) {`	453	`if (!isset($this->_packageInfo['dirtree'])) {`
461	`$this->_packageInfo['dirtree'] = array();`	454	`$this->_packageInfo['dirtree'] = array();`
462	`}`	455	`}`
463	`$this->_packageInfo['dirtree'][$path] = true;`	456	`$this->_packageInfo['dirtree'][$path] = true;`
464	`}`	457	`}`
465		458
466	`function getDirtree()`	459	`function getDirtree()`
467	`{`	460	`{`
468	`if (isset($this->_packageInfo['dirtree']) && count($this->_packageInfo['dirtree'])) {`	461	`if (isset($this->_packageInfo['dirtree']) && count($this->_packageInfo['dirtree'])) {`
469	`return $this->_packageInfo['dirtree'];`	462	`return $this->_packageInfo['dirtree'];`
470	`}`	463	`}`
471	`return false;`	464	`return false;`
472	`}`	465	`}`
473		466
474	`function resetDirtree()`	467	`function resetDirtree()`
475	`{`	468	`{`
476	`unset($this->_packageInfo['dirtree']);`	469	`unset($this->_packageInfo['dirtree']);`
477	`}`	470	`}`
478		471
479	`function fromArray($pinfo)`	472	`function fromArray($pinfo)`
480	`{`	473	`{`
481	`$this->_incomplete = false;`	474	`$this->_incomplete = false;`
482	`$this->_packageInfo = $pinfo;`	475	`$this->_packageInfo = $pinfo;`
483	`}`	476	`}`
484		477
485	`function isIncomplete()`	478	`function isIncomplete()`
486	`{`	479	`{`
487	`return $this->_incomplete;`	480	`return $this->_incomplete;`
488	`}`	481	`}`
489		482
490	`function getChannel()`	483	`function getChannel()`
491	`{`	484	`{`
492	`return 'pear.php.net';`	485	`return 'pear.php.net';`
493	`}`	486	`}`
494		487
495	`function getUri()`	488	`function getUri()`
496	`{`	489	`{`
497	`return false;`	490	`return false;`
498	`}`	491	`}`
499		492
500	`function getTime()`	493	`function getTime()`

Subversion Repositories Applications.gtt

(root)/trunk/bibliotheque/pear/PEAR/PackageFile/v1.php – Rev 94 → 187