<h2>Editing File: /opt/alt/php82/usr/share/pear/PEAR/PackageFile.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php
/**
 * PEAR_PackageFile, package.xml parsing utility class
 *
 * PHP versions 4 and 5
 *
 * @category   pear
 * @package    PEAR
 * @author     Greg Beaver &lt;cellog@php.net&gt;
 * @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
 */

/**
 * needed for PEAR_VALIDATE_* constants
 */
require_once 'PEAR/Validate.php';
/**
 * Error code if the package.xml &lt;package&gt; tag does not contain a valid version
 */
define('PEAR_PACKAGEFILE_ERROR_NO_PACKAGEVERSION', 1);
/**
 * Error code if the package.xml &lt;package&gt; tag version is not supported (version 1.0 and 1.1 are the only supported versions,
 * currently
 */
define('PEAR_PACKAGEFILE_ERROR_INVALID_PACKAGEVERSION', 2);
/**
 * Abstraction for the package.xml package description file
 *
 * @category   pear
 * @package    PEAR
 * @author     Greg Beaver &lt;cellog@php.net&gt;
 * @copyright  1997-2009 The Authors
 * @license    http://opensource.org/licenses/bsd-license.php New BSD License
 * @version    Release: 1.10.18
 * @link       http://pear.php.net/package/PEAR
 * @since      Class available since Release 1.4.0a1
 */
class PEAR_PackageFile
{
    /**
     * @var PEAR_Config
     */
    var $_config;
    var $_debug;

    var $_logger = false;
    /**
     * @var boolean
     */
    var $_rawReturn = false;

    /**
     * helper for extracting Archive_Tar errors
     * @var array
     * @access private
     */
    var $_extractErrors = array();

    /**
     *
     * @param   PEAR_Config $config
     * @param   ?   $debug
     * @param   string @tmpdir Optional temporary directory for uncompressing
     *          files
     */
    function __construct(&amp;$config, $debug = false)
    {
        $this-&gt;_config = $config;
        $this-&gt;_debug = $debug;
    }

    /**
     * Turn off validation - return a parsed package.xml without checking it
     *
     * This is used by the package-validate command
     */
    function rawReturn()
    {
        $this-&gt;_rawReturn = true;
    }

    function setLogger(&amp;$l)
    {
        $this-&gt;_logger = &amp;$l;
    }

    /**
     * Create a PEAR_PackageFile_Parser_v* of a given version.
     * @param   int $version
     * @return  PEAR_PackageFile_Parser_v1|PEAR_PackageFile_Parser_v1
     */
    function &amp;parserFactory($version)
    {
        if (!in_array($version[0], array('1', '2'))) {
            $a = false;
            return $a;
        }

        include_once 'PEAR/PackageFile/Parser/v' . $version[0] . '.php';
        $version = $version[0];
        $class = &quot;PEAR_PackageFile_Parser_v$version&quot;;
        $a = new $class;
        return $a;
    }

    /**
     * For simpler unit-testing
     * @return string
     */
    function getClassPrefix()
    {
        return 'PEAR_PackageFile_v';
    }

    /**
     * Create a PEAR_PackageFile_v* of a given version.
     * @param   int $version
     * @return  PEAR_PackageFile_v1|PEAR_PackageFile_v1
     */
    function &amp;factory($version)
    {
        if (!in_array($version[0], array('1', '2'))) {
            $a = false;
            return $a;
        }

        include_once 'PEAR/PackageFile/v' . $version[0] . '.php';
        $version = $version[0];
        $class = $this-&gt;getClassPrefix() . $version;
        $a = new $class;
        return $a;
    }

    /**
     * Create a PEAR_PackageFile_v* from its toArray() method
     *
     * WARNING: no validation is performed, the array is assumed to be valid,
     * always parse from xml if you want validation.
     * @param   array $arr
     * @return PEAR_PackageFileManager_v1|PEAR_PackageFileManager_v2
     * @uses    factory() to construct the returned object.
     */
    function &amp;fromArray($arr)
    {
        if (isset($arr['xsdversion'])) {
            $obj = &amp;$this-&gt;factory($arr['xsdversion']);
            if ($this-&gt;_logger) {
                $obj-&gt;setLogger($this-&gt;_logger);
            }

            $obj-&gt;setConfig($this-&gt;_config);
            $obj-&gt;fromArray($arr);
            return $obj;
        }

        if (isset($arr['package']['attribs']['version'])) {
            $obj = &amp;$this-&gt;factory($arr['package']['attribs']['version']);
        } else {
            $obj = &amp;$this-&gt;factory('1.0');
        }

        if ($this-&gt;_logger) {
            $obj-&gt;setLogger($this-&gt;_logger);
        }

        $obj-&gt;setConfig($this-&gt;_config);
        $obj-&gt;fromArray($arr);
        return $obj;
    }

    /**
     * Create a PEAR_PackageFile_v* from an XML string.
     * @access  public
     * @param   string $data contents of package.xml file
     * @param   int $state package state (one of PEAR_VALIDATE_* constants)
     * @param   string $file full path to the package.xml file (and the files
     *          it references)
     * @param   string $archive optional name of the archive that the XML was
     *          extracted from, if any
     * @return  PEAR_PackageFile_v1|PEAR_PackageFile_v2
     * @uses    parserFactory() to construct a parser to load the package.
     */
    function &amp;fromXmlString($data, $state, $file, $archive = false)
    {
        if (preg_match('/&lt;package[^&gt;]+version=[\'&quot;]([0-9]+\.[0-9]+)[\'&quot;]/', $data, $packageversion)) {
            if (!in_array($packageversion[1], array('1.0', '2.0', '2.1'))) {
                return PEAR::raiseError('package.xml version &quot;' . $packageversion[1] .
                    '&quot; is not supported, only 1.0, 2.0, and 2.1 are supported.');
            }

            $object = &amp;$this-&gt;parserFactory($packageversion[1]);
            if ($this-&gt;_logger) {
                $object-&gt;setLogger($this-&gt;_logger);
            }

            $object-&gt;setConfig($this-&gt;_config);
            $pf = $object-&gt;parse($data, $file, $archive);
            if (PEAR::isError($pf)) {
                return $pf;
            }

            if ($this-&gt;_rawReturn) {
                return $pf;
            }

            if (!$pf-&gt;validate($state)) {;
                if ($this-&gt;_config-&gt;get('verbose') &gt; 0
                    &amp;&amp; $this-&gt;_logger &amp;&amp; $pf-&gt;getValidationWarnings(false)
                ) {
                    foreach ($pf-&gt;getValidationWarnings(false) as $warning) {
                        $this-&gt;_logger-&gt;log(0, 'ERROR: ' . $warning['message']);
                    }
                }

                $a = PEAR::raiseError('Parsing of package.xml from file &quot;' . $file . '&quot; failed',
                    2, null, null, $pf-&gt;getValidationWarnings());
                return $a;
            }

            if ($this-&gt;_logger &amp;&amp; $pf-&gt;getValidationWarnings(false)) {
                foreach ($pf-&gt;getValidationWarnings() as $warning) {
                    $this-&gt;_logger-&gt;log(0, 'WARNING: ' . $warning['message']);
                }
            }

            if (method_exists($pf, 'flattenFilelist')) {
                $pf-&gt;flattenFilelist(); // for v2
            }

            return $pf;
        } elseif (preg_match('/&lt;package[^&gt;]+version=[\'&quot;]([^&quot;\']+)[\'&quot;]/', $data, $packageversion)) {
            $a = PEAR::raiseError('package.xml file &quot;' . $file .
                '&quot; has unsupported package.xml &lt;package&gt; version &quot;' . $packageversion[1] . '&quot;');
            return $a;
        } else {
            if (!class_exists('PEAR_ErrorStack')) {
                require_once 'PEAR/ErrorStack.php';
            }

            PEAR_ErrorStack::staticPush('PEAR_PackageFile',
                PEAR_PACKAGEFILE_ERROR_NO_PACKAGEVERSION,
                'warning', array('xml' =&gt; $data), 'package.xml &quot;' . $file .
                    '&quot; has no package.xml &lt;package&gt; version');
            $object = &amp;$this-&gt;parserFactory('1.0');
            $object-&gt;setConfig($this-&gt;_config);
            $pf = $object-&gt;parse($data, $file, $archive);
            if (PEAR::isError($pf)) {
                return $pf;
            }

            if ($this-&gt;_rawReturn) {
                return $pf;
            }

            if (!$pf-&gt;validate($state)) {
                $a = PEAR::raiseError('Parsing of package.xml from file &quot;' . $file . '&quot; failed',
                    2, null, null, $pf-&gt;getValidationWarnings());
                return $a;
            }

            if ($this-&gt;_logger &amp;&amp; $pf-&gt;getValidationWarnings(false)) {
                foreach ($pf-&gt;getValidationWarnings() as $warning) {
                    $this-&gt;_logger-&gt;log(0, 'WARNING: ' . $warning['message']);
                }
            }

            if (method_exists($pf, 'flattenFilelist')) {
                $pf-&gt;flattenFilelist(); // for v2
            }

            return $pf;
        }
    }

    /**
     * Register a temporary file or directory.  When the destructor is
     * executed, all registered temporary files and directories are
     * removed.
     *
     * @param string  $file  name of file or directory
     * @return  void
     */
    static function addTempFile($file)
    {
        $GLOBALS['_PEAR_Common_tempfiles'][] = $file;
    }

    /**
     * Create a PEAR_PackageFile_v* from a compressed Tar or Tgz file.
     * @access  public
     * @param string contents of package.xml file
     * @param int package state (one of PEAR_VALIDATE_* constants)
     * @return  PEAR_PackageFile_v1|PEAR_PackageFile_v2
     * @using   Archive_Tar to extract the files
     * @using   fromPackageFile() to load the package after the package.xml
     *          file is extracted.
     */
    function &amp;fromTgzFile($file, $state)
    {
        if (!class_exists('Archive_Tar')) {
            require_once 'Archive/Tar.php';
        }

        $tar = new Archive_Tar($file);
        if ($this-&gt;_debug &lt;= 1) {
            $tar-&gt;pushErrorHandling(PEAR_ERROR_RETURN);
        }

        $content = $tar-&gt;listContent();
        if ($this-&gt;_debug &lt;= 1) {
            $tar-&gt;popErrorHandling();
        }

        if (!is_array($content)) {
            if (is_string($file) &amp;&amp; strlen($file) &lt; 255 &amp;&amp;
                  (!file_exists($file) || !@is_file($file))) {
                $ret = PEAR::raiseError(&quot;could not open file \&quot;$file\&quot;&quot;);
                return $ret;
            }

            $file = realpath($file);
            $ret = PEAR::raiseError(&quot;Could not get contents of package \&quot;$file\&quot;&quot;.
                                     '. Invalid tgz file.');
            return $ret;
        }

        if (!count($content) &amp;&amp; !@is_file($file)) {
            $ret = PEAR::raiseError(&quot;could not open file \&quot;$file\&quot;&quot;);
            return $ret;
        }

        $xml      = null;
        $origfile = $file;
        foreach ($content as $file) {
            $name = $file['filename'];
            if ($name == 'package2.xml') { // allow a .tgz to distribute both versions
                $xml = $name;
                break;
            }

            if ($name == 'package.xml') {
                $xml = $name;
                break;
            } elseif (preg_match('/package.xml$/', $name, $match)) {
                $xml = $name;
                break;
            }
        }

        $tmpdir = System::mktemp('-t &quot;' . $this-&gt;_config-&gt;get('temp_dir') . '&quot; -d pear');
        if ($tmpdir === false) {
            $ret = PEAR::raiseError(&quot;there was a problem with getting the configured temp directory&quot;);
            return $ret;
        }

        PEAR_PackageFile::addTempFile($tmpdir);

        $this-&gt;_extractErrors();
        PEAR::staticPushErrorHandling(PEAR_ERROR_CALLBACK, array($this, '_extractErrors'));

        if (!$xml || !$tar-&gt;extractList(array($xml), $tmpdir)) {
            $extra = implode(&quot;\n&quot;, $this-&gt;_extractErrors());
            if ($extra) {
                $extra = ' ' . $extra;
            }

            PEAR::staticPopErrorHandling();
            $ret = PEAR::raiseError('could not extract the package.xml file from &quot;' .
                $origfile . '&quot;' . $extra);
            return $ret;
        }

        PEAR::staticPopErrorHandling();
        $ret = &amp;PEAR_PackageFile::fromPackageFile(&quot;$tmpdir/$xml&quot;, $state, $origfile);
        return $ret;
    }

    /**
     * helper callback for extracting Archive_Tar errors
     *
     * @param PEAR_Error|null $err
     * @return array
     * @access private
     */
    function _extractErrors($err = null)
    {
        static $errors = array();
        if ($err === null) {
            $e = $errors;
            $errors = array();
            return $e;
        }
        $errors[] = $err-&gt;getMessage();
    }

    /**
     * Create a PEAR_PackageFile_v* from a package.xml file.
     *
     * @access public
     * @param   string  $descfile  name of package xml file
     * @param   int     $state package state (one of PEAR_VALIDATE_* constants)
     * @param   string|false $archive name of the archive this package.xml came
     *          from, if any
     * @return  PEAR_PackageFile_v1|PEAR_PackageFile_v2
     * @uses    PEAR_PackageFile::fromXmlString to create the oject after the
     *          XML is loaded from the package.xml file.
     */
    function &amp;fromPackageFile($descfile, $state, $archive = false)
    {
        $fp = false;
        if (is_string($descfile) &amp;&amp; strlen($descfile) &lt; 255 &amp;&amp;
             (
              !file_exists($descfile) || !is_file($descfile) || !is_readable($descfile)
              || (!$fp = @fopen($descfile, 'r'))
             )
        ) {
            $a = PEAR::raiseError(&quot;Unable to open $descfile&quot;);
            return $a;
        }

        // read the whole thing so we only get one cdata callback
        // for each block of cdata
        fclose($fp);
        $data = file_get_contents($descfile);
        $ret = &amp;PEAR_PackageFile::fromXmlString($data, $state, $descfile, $archive);
        return $ret;
    }

    /**
     * Create a PEAR_PackageFile_v* from a .tgz archive or package.xml file.
     *
     * This method is able to extract information about a package from a .tgz
     * archive or from a XML package definition file.
     *
     * @access public
     * @param   string  $info file name
     * @param   int     $state package state (one of PEAR_VALIDATE_* constants)
     * @return  PEAR_PackageFile_v1|PEAR_PackageFile_v2
     * @uses    fromPackageFile() if the file appears to be XML
     * @uses    fromTgzFile() to load all non-XML files
     */
    function &amp;fromAnyFile($info, $state)
    {
        if (is_dir($info)) {
            $dir_name = realpath($info);
            if (file_exists($dir_name . '/package.xml')) {
                $info = PEAR_PackageFile::fromPackageFile($dir_name .  '/package.xml', $state);
            } elseif (file_exists($dir_name .  '/package2.xml')) {
                $info = PEAR_PackageFile::fromPackageFile($dir_name .  '/package2.xml', $state);
            } else {
                $info = PEAR::raiseError(&quot;No package definition found in '$info' directory&quot;);
            }

            return $info;
        }

        $fp = false;
        if (is_string($info) &amp;&amp; strlen($info) &lt; 255 &amp;&amp;
             (file_exists($info) || ($fp = @fopen($info, 'r')))
        ) {

            if ($fp) {
                fclose($fp);
            }

            $tmp = substr($info, -4);
            if ($tmp == '.xml') {
                $info = &amp;PEAR_PackageFile::fromPackageFile($info, $state);
            } elseif ($tmp == '.tar' || $tmp == '.tgz') {
                $info = &amp;PEAR_PackageFile::fromTgzFile($info, $state);
            } else {
                $fp   = fopen($info, 'r');
                $test = fread($fp, 5);
                fclose($fp);
                if ($test == '&lt;?xml') {
                    $info = &amp;PEAR_PackageFile::fromPackageFile($info, $state);
                } else {
                    $info = &amp;PEAR_PackageFile::fromTgzFile($info, $state);
                }
            }

            return $info;
        }

        $info = PEAR::raiseError(&quot;Cannot open '$info' for parsing&quot;);
        return $info;
    }
}
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fopt%2Falt%2Fphp82%2Fusr%2Fshare%2Fpear%2FPEAR'>Back to Directory</a>