<h2>Editing File: /opt/alt/php74/usr/share/pear/PEAR/PackageFile/v2/rw.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php
/**
 * PEAR_PackageFile_v2, package.xml version 2.0, read/write version
 *
 * 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.0a8
 */
/**
 * For base class
 */
require_once 'PEAR/PackageFile/v2.php';
/**
 * @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.0a8
 */
class PEAR_PackageFile_v2_rw extends PEAR_PackageFile_v2
{
    /**
     * @param string Extension name
     * @return bool success of operation
     */
    function setProvidesExtension($extension)
    {
        if (in_array($this-&gt;getPackageType(),
              array('extsrc', 'extbin', 'zendextsrc', 'zendextbin'))) {
            if (!isset($this-&gt;_packageInfo['providesextension'])) {
                // ensure that the channel tag is set up in the right location
                $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo,
                    array('usesrole', 'usestask', 'srcpackage', 'srcuri', 'phprelease',
                    'extsrcrelease', 'extbinrelease', 'zendextsrcrelease', 'zendextbinrelease',
                    'bundle', 'changelog'),
                    $extension, 'providesextension');
            }
            $this-&gt;_packageInfo['providesextension'] = $extension;
            return true;
        }
        return false;
    }

    function setPackage($package)
    {
        $this-&gt;_isValid = 0;
        if (!isset($this-&gt;_packageInfo['attribs'])) {
            $this-&gt;_packageInfo = array_merge(array('attribs' =&gt; array(
                                 'version' =&gt; '2.0',
                                 'xmlns' =&gt; 'http://pear.php.net/dtd/package-2.0',
                                 'xmlns:tasks' =&gt; 'http://pear.php.net/dtd/tasks-1.0',
                                 'xmlns:xsi' =&gt; 'http://www.w3.org/2001/XMLSchema-instance',
                                 'xsi:schemaLocation' =&gt; 'http://pear.php.net/dtd/tasks-1.0
    http://pear.php.net/dtd/tasks-1.0.xsd
    http://pear.php.net/dtd/package-2.0
    http://pear.php.net/dtd/package-2.0.xsd',
                             )), $this-&gt;_packageInfo);
        }
        if (!isset($this-&gt;_packageInfo['name'])) {
            return $this-&gt;_packageInfo = array_merge(array('name' =&gt; $package),
                $this-&gt;_packageInfo);
        }
        $this-&gt;_packageInfo['name'] = $package;
    }

    /**
     * set this as a package.xml version 2.1
     * @access private
     */
    function _setPackageVersion2_1()
    {
        $info = array(
                                 'version' =&gt; '2.1',
                                 'xmlns' =&gt; 'http://pear.php.net/dtd/package-2.1',
                                 'xmlns:tasks' =&gt; 'http://pear.php.net/dtd/tasks-1.0',
                                 'xmlns:xsi' =&gt; 'http://www.w3.org/2001/XMLSchema-instance',
                                 'xsi:schemaLocation' =&gt; 'http://pear.php.net/dtd/tasks-1.0
    http://pear.php.net/dtd/tasks-1.0.xsd
    http://pear.php.net/dtd/package-2.1
    http://pear.php.net/dtd/package-2.1.xsd',
                             );
        if (!isset($this-&gt;_packageInfo['attribs'])) {
            $this-&gt;_packageInfo = array_merge(array('attribs' =&gt; $info), $this-&gt;_packageInfo);
        } else {
            $this-&gt;_packageInfo['attribs'] = $info;
        }
    }

    function setUri($uri)
    {
        unset($this-&gt;_packageInfo['channel']);
        $this-&gt;_isValid = 0;
        if (!isset($this-&gt;_packageInfo['uri'])) {
            // ensure that the uri tag is set up in the right location
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo,
                array('extends', 'summary', 'description', 'lead',
                'developer', 'contributor', 'helper', 'date', 'time', 'version',
                'stability', 'license', 'notes', 'contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'), $uri, 'uri');
        }
        $this-&gt;_packageInfo['uri'] = $uri;
    }

    function setChannel($channel)
    {
        unset($this-&gt;_packageInfo['uri']);
        $this-&gt;_isValid = 0;
        if (!isset($this-&gt;_packageInfo['channel'])) {
            // ensure that the channel tag is set up in the right location
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo,
                array('extends', 'summary', 'description', 'lead',
                'developer', 'contributor', 'helper', 'date', 'time', 'version',
                'stability', 'license', 'notes', 'contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'), $channel, 'channel');
        }
        $this-&gt;_packageInfo['channel'] = $channel;
    }

    function setExtends($extends)
    {
        $this-&gt;_isValid = 0;
        if (!isset($this-&gt;_packageInfo['extends'])) {
            // ensure that the extends tag is set up in the right location
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo,
                array('summary', 'description', 'lead',
                'developer', 'contributor', 'helper', 'date', 'time', 'version',
                'stability', 'license', 'notes', 'contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'), $extends, 'extends');
        }
        $this-&gt;_packageInfo['extends'] = $extends;
    }

    function setSummary($summary)
    {
        $this-&gt;_isValid = 0;
        if (!isset($this-&gt;_packageInfo['summary'])) {
            // ensure that the summary tag is set up in the right location
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo,
                array('description', 'lead',
                'developer', 'contributor', 'helper', 'date', 'time', 'version',
                'stability', 'license', 'notes', 'contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'), $summary, 'summary');
        }
        $this-&gt;_packageInfo['summary'] = $summary;
    }

    function setDescription($desc)
    {
        $this-&gt;_isValid = 0;
        if (!isset($this-&gt;_packageInfo['description'])) {
            // ensure that the description tag is set up in the right location
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo,
                array('lead',
                'developer', 'contributor', 'helper', 'date', 'time', 'version',
                'stability', 'license', 'notes', 'contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'), $desc, 'description');
        }
        $this-&gt;_packageInfo['description'] = $desc;
    }

    /**
     * Adds a new maintainer - no checking of duplicates is performed, use
     * updatemaintainer for that purpose.
     */
    function addMaintainer($role, $handle, $name, $email, $active = 'yes')
    {
        if (!in_array($role, array('lead', 'developer', 'contributor', 'helper'))) {
            return false;
        }
        if (isset($this-&gt;_packageInfo[$role])) {
            if (!isset($this-&gt;_packageInfo[$role][0])) {
                $this-&gt;_packageInfo[$role] = array($this-&gt;_packageInfo[$role]);
            }
            $this-&gt;_packageInfo[$role][] =
                array(
                    'name' =&gt; $name,
                    'user' =&gt; $handle,
                    'email' =&gt; $email,
                    'active' =&gt; $active,
                );
        } else {
            $testarr = array('lead',
                    'developer', 'contributor', 'helper', 'date', 'time', 'version',
                    'stability', 'license', 'notes', 'contents', 'compatible',
                    'dependencies', 'providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease',
                    'extbinrelease', 'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog');
            foreach (array('lead', 'developer', 'contributor', 'helper') as $testrole) {
                array_shift($testarr);
                if ($role == $testrole) {
                    break;
                }
            }
            if (!isset($this-&gt;_packageInfo[$role])) {
                // ensure that the extends tag is set up in the right location
                $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo, $testarr,
                    array(), $role);
            }
            $this-&gt;_packageInfo[$role] =
                array(
                    'name' =&gt; $name,
                    'user' =&gt; $handle,
                    'email' =&gt; $email,
                    'active' =&gt; $active,
                );
        }
        $this-&gt;_isValid = 0;
    }

    function updateMaintainer($newrole, $handle, $name, $email, $active = 'yes')
    {
        $found = false;
        foreach (array('lead', 'developer', 'contributor', 'helper') as $role) {
            if (!isset($this-&gt;_packageInfo[$role])) {
                continue;
            }
            $info = $this-&gt;_packageInfo[$role];
            if (!isset($info[0])) {
                if ($info['user'] == $handle) {
                    $found = true;
                    break;
                }
            }
            foreach ($info as $i =&gt; $maintainer) {
                if (is_array($maintainer) &amp;&amp; $maintainer['user'] == $handle) {
                    $found = $i;
                    break 2;
                }
            }
        }
        if ($found === false) {
            return $this-&gt;addMaintainer($newrole, $handle, $name, $email, $active);
        }
        if ($found !== false) {
            if ($found === true) {
                unset($this-&gt;_packageInfo[$role]);
            } else {
                unset($this-&gt;_packageInfo[$role][$found]);
                $this-&gt;_packageInfo[$role] = array_values($this-&gt;_packageInfo[$role]);
            }
        }
        $this-&gt;addMaintainer($newrole, $handle, $name, $email, $active);
        $this-&gt;_isValid = 0;
    }

    function deleteMaintainer($handle)
    {
        $found = false;
        foreach (array('lead', 'developer', 'contributor', 'helper') as $role) {
            if (!isset($this-&gt;_packageInfo[$role])) {
                continue;
            }
            if (!isset($this-&gt;_packageInfo[$role][0])) {
                $this-&gt;_packageInfo[$role] = array($this-&gt;_packageInfo[$role]);
            }
            foreach ($this-&gt;_packageInfo[$role] as $i =&gt; $maintainer) {
                if ($maintainer['user'] == $handle) {
                    $found = $i;
                    break;
                }
            }
            if ($found !== false) {
                unset($this-&gt;_packageInfo[$role][$found]);
                if (!count($this-&gt;_packageInfo[$role]) &amp;&amp; $role == 'lead') {
                    $this-&gt;_isValid = 0;
                }
                if (!count($this-&gt;_packageInfo[$role])) {
                    unset($this-&gt;_packageInfo[$role]);
                    return true;
                }
                $this-&gt;_packageInfo[$role] =
                    array_values($this-&gt;_packageInfo[$role]);
                if (count($this-&gt;_packageInfo[$role]) == 1) {
                    $this-&gt;_packageInfo[$role] = $this-&gt;_packageInfo[$role][0];
                }
                return true;
            }
            if (count($this-&gt;_packageInfo[$role]) == 1) {
                $this-&gt;_packageInfo[$role] = $this-&gt;_packageInfo[$role][0];
            }
        }
        return false;
    }

    function setReleaseVersion($version)
    {
        if (isset($this-&gt;_packageInfo['version']) &amp;&amp;
              isset($this-&gt;_packageInfo['version']['release'])) {
            unset($this-&gt;_packageInfo['version']['release']);
        }
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $version, array(
            'version' =&gt; array('stability', 'license', 'notes', 'contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'),
            'release' =&gt; array('api')));
        $this-&gt;_isValid = 0;
    }

    function setAPIVersion($version)
    {
        if (isset($this-&gt;_packageInfo['version']) &amp;&amp;
              isset($this-&gt;_packageInfo['version']['api'])) {
            unset($this-&gt;_packageInfo['version']['api']);
        }
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $version, array(
            'version' =&gt; array('stability', 'license', 'notes', 'contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'),
            'api' =&gt; array()));
        $this-&gt;_isValid = 0;
    }

    /**
     * snapshot|devel|alpha|beta|stable
     */
    function setReleaseStability($state)
    {
        if (isset($this-&gt;_packageInfo['stability']) &amp;&amp;
              isset($this-&gt;_packageInfo['stability']['release'])) {
            unset($this-&gt;_packageInfo['stability']['release']);
        }
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $state, array(
            'stability' =&gt; array('license', 'notes', 'contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'),
            'release' =&gt; array('api')));
        $this-&gt;_isValid = 0;
    }

    /**
     * @param devel|alpha|beta|stable
     */
    function setAPIStability($state)
    {
        if (isset($this-&gt;_packageInfo['stability']) &amp;&amp;
              isset($this-&gt;_packageInfo['stability']['api'])) {
            unset($this-&gt;_packageInfo['stability']['api']);
        }
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $state, array(
            'stability' =&gt; array('license', 'notes', 'contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'),
            'api' =&gt; array()));
        $this-&gt;_isValid = 0;
    }

    function setLicense($license, $uri = false, $filesource = false)
    {
        if (!isset($this-&gt;_packageInfo['license'])) {
            // ensure that the license tag is set up in the right location
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo,
                array('notes', 'contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'), 0, 'license');
        }
        if ($uri || $filesource) {
            $attribs = array();
            if ($uri) {
                $attribs['uri'] = $uri;
            }
            $uri = true; // for test below
            if ($filesource) {
                $attribs['filesource'] = $filesource;
            }
        }
        $license = $uri ? array('attribs' =&gt; $attribs, '_content' =&gt; $license) : $license;
        $this-&gt;_packageInfo['license'] = $license;
        $this-&gt;_isValid = 0;
    }

    function setNotes($notes)
    {
        $this-&gt;_isValid = 0;
        if (!isset($this-&gt;_packageInfo['notes'])) {
            // ensure that the notes tag is set up in the right location
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo,
                array('contents', 'compatible',
                'dependencies', 'providesextension', 'usesrole', 'usestask', 'srcpackage', 'srcuri',
                'phprelease', 'extsrcrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'extbinrelease', 'bundle', 'changelog'), $notes, 'notes');
        }
        $this-&gt;_packageInfo['notes'] = $notes;
    }

    /**
     * This is only used at install-time, after all serialization
     * is over.
     * @param string file name
     * @param string installed path
     */
    function setInstalledAs($file, $path)
    {
        if ($path) {
            return $this-&gt;_packageInfo['filelist'][$file]['installed_as'] = $path;
        }
        unset($this-&gt;_packageInfo['filelist'][$file]['installed_as']);
    }

    /**
     * This is only used at install-time, after all serialization
     * is over.
     */
    function installedFile($file, $atts)
    {
        if (isset($this-&gt;_packageInfo['filelist'][$file])) {
            $this-&gt;_packageInfo['filelist'][$file] =
                array_merge($this-&gt;_packageInfo['filelist'][$file], $atts['attribs']);
        } else {
            $this-&gt;_packageInfo['filelist'][$file] = $atts['attribs'];
        }
    }

    /**
     * Reset the listing of package contents
     * @param string base installation dir for the whole package, if any
     */
    function clearContents($baseinstall = false)
    {
        $this-&gt;_filesValid = false;
        $this-&gt;_isValid = 0;
        if (!isset($this-&gt;_packageInfo['contents'])) {
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo,
                array('compatible',
                    'dependencies', 'providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease',
                    'extbinrelease', 'zendextsrcrelease', 'zendextbinrelease',
                    'bundle', 'changelog'), array(), 'contents');
        }
        if ($this-&gt;getPackageType() != 'bundle') {
            $this-&gt;_packageInfo['contents'] =
                array('dir' =&gt; array('attribs' =&gt; array('name' =&gt; '/')));
            if ($baseinstall) {
                $this-&gt;_packageInfo['contents']['dir']['attribs']['baseinstalldir'] = $baseinstall;
            }
        } else {
            $this-&gt;_packageInfo['contents'] = array('bundledpackage' =&gt; array());
        }
    }

    /**
     * @param string relative path of the bundled package.
     */
    function addBundledPackage($path)
    {
        if ($this-&gt;getPackageType() != 'bundle') {
            return false;
        }
        $this-&gt;_filesValid = false;
        $this-&gt;_isValid = 0;
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $path, array(
                'contents' =&gt; array('compatible', 'dependencies', 'providesextension',
                'usesrole', 'usestask', 'srcpackage', 'srcuri', 'phprelease',
                'extsrcrelease', 'extbinrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'bundle', 'changelog'),
                'bundledpackage' =&gt; array()));
    }

    /**
     * @param string file name
     * @param PEAR_Task_Common a read/write task
     */
    function addTaskToFile($filename, $task)
    {
        if (!method_exists($task, 'getXml')) {
            return false;
        }
        if (!method_exists($task, 'getName')) {
            return false;
        }
        if (!method_exists($task, 'validate')) {
            return false;
        }
        if (!$task-&gt;validate()) {
            return false;
        }
        if (!isset($this-&gt;_packageInfo['contents']['dir']['file'])) {
            return false;
        }
        $this-&gt;getTasksNs(); // discover the tasks namespace if not done already
        $files = $this-&gt;_packageInfo['contents']['dir']['file'];
        if (!isset($files[0])) {
            $files = array($files);
            $ind = false;
        } else {
            $ind = true;
        }
        foreach ($files as $i =&gt; $file) {
            if (isset($file['attribs'])) {
                if ($file['attribs']['name'] == $filename) {
                    if ($ind) {
                        $t = isset($this-&gt;_packageInfo['contents']['dir']['file'][$i]
                              ['attribs'][$this-&gt;_tasksNs .
                              ':' . $task-&gt;getName()]) ?
                              $this-&gt;_packageInfo['contents']['dir']['file'][$i]
                              ['attribs'][$this-&gt;_tasksNs .
                              ':' . $task-&gt;getName()] : false;
                        if ($t &amp;&amp; !isset($t[0])) {
                            $this-&gt;_packageInfo['contents']['dir']['file'][$i]
                                [$this-&gt;_tasksNs . ':' . $task-&gt;getName()] = array($t);
                        }
                        $this-&gt;_packageInfo['contents']['dir']['file'][$i][$this-&gt;_tasksNs .
                            ':' . $task-&gt;getName()][] = $task-&gt;getXml();
                    } else {
                        $t = isset($this-&gt;_packageInfo['contents']['dir']['file']
                              ['attribs'][$this-&gt;_tasksNs .
                              ':' . $task-&gt;getName()]) ? $this-&gt;_packageInfo['contents']['dir']['file']
                              ['attribs'][$this-&gt;_tasksNs .
                              ':' . $task-&gt;getName()] : false;
                        if ($t &amp;&amp; !isset($t[0])) {
                            $this-&gt;_packageInfo['contents']['dir']['file']
                                [$this-&gt;_tasksNs . ':' . $task-&gt;getName()] = array($t);
                        }
                        $this-&gt;_packageInfo['contents']['dir']['file'][$this-&gt;_tasksNs .
                            ':' . $task-&gt;getName()][] = $task-&gt;getXml();
                    }
                    return true;
                }
            }
        }
        return false;
    }

    /**
     * @param string path to the file
     * @param string filename
     * @param array extra attributes
     */
    function addFile($dir, $file, $attrs)
    {
        if ($this-&gt;getPackageType() == 'bundle') {
            return false;
        }
        $this-&gt;_filesValid = false;
        $this-&gt;_isValid = 0;
        $dir = preg_replace(array('!\\\\+!', '!/+!'), array('/', '/'), $dir);
        if ($dir == '/' || $dir == '') {
            $dir = '';
        } else {
            $dir .= '/';
        }
        $attrs['name'] = $dir . $file;
        if (!isset($this-&gt;_packageInfo['contents'])) {
            // ensure that the contents tag is set up
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo,
                array('compatible', 'dependencies', 'providesextension', 'usesrole', 'usestask',
                'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease',
                'extbinrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'bundle', 'changelog'), array(), 'contents');
        }
        if (isset($this-&gt;_packageInfo['contents']['dir']['file'])) {
            if (!isset($this-&gt;_packageInfo['contents']['dir']['file'][0])) {
                $this-&gt;_packageInfo['contents']['dir']['file'] =
                    array($this-&gt;_packageInfo['contents']['dir']['file']);
            }
            $this-&gt;_packageInfo['contents']['dir']['file'][]['attribs'] = $attrs;
        } else {
            $this-&gt;_packageInfo['contents']['dir']['file']['attribs'] = $attrs;
        }
    }

    /**
     * @param string Dependent package name
     * @param string Dependent package's channel name
     * @param string minimum version of specified package that this release is guaranteed to be
     *               compatible with
     * @param string maximum version of specified package that this release is guaranteed to be
     *               compatible with
     * @param string versions of specified package that this release is not compatible with
     */
    function addCompatiblePackage($name, $channel, $min, $max, $exclude = false)
    {
        $this-&gt;_isValid = 0;
        $set = array(
            'name' =&gt; $name,
            'channel' =&gt; $channel,
            'min' =&gt; $min,
            'max' =&gt; $max,
        );
        if ($exclude) {
            $set['exclude'] = $exclude;
        }
        $this-&gt;_isValid = 0;
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $set, array(
                'compatible' =&gt; array('dependencies', 'providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog')
            ));
    }

    /**
     * Removes the &lt;usesrole&gt; tag entirely
     */
    function resetUsesrole()
    {
        if (isset($this-&gt;_packageInfo['usesrole'])) {
            unset($this-&gt;_packageInfo['usesrole']);
        }
    }

    /**
     * @param string
     * @param string package name or uri
     * @param string channel name if non-uri
     */
    function addUsesrole($role, $packageOrUri, $channel = false) {
        $set = array('role' =&gt; $role);
        if ($channel) {
            $set['package'] = $packageOrUri;
            $set['channel'] = $channel;
        } else {
            $set['uri'] = $packageOrUri;
        }
        $this-&gt;_isValid = 0;
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $set, array(
                'usesrole' =&gt; array('usestask', 'srcpackage', 'srcuri',
                    'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog')
            ));
    }

    /**
     * Removes the &lt;usestask&gt; tag entirely
     */
    function resetUsestask()
    {
        if (isset($this-&gt;_packageInfo['usestask'])) {
            unset($this-&gt;_packageInfo['usestask']);
        }
    }


    /**
     * @param string
     * @param string package name or uri
     * @param string channel name if non-uri
     */
    function addUsestask($task, $packageOrUri, $channel = false) {
        $set = array('task' =&gt; $task);
        if ($channel) {
            $set['package'] = $packageOrUri;
            $set['channel'] = $channel;
        } else {
            $set['uri'] = $packageOrUri;
        }
        $this-&gt;_isValid = 0;
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $set, array(
                'usestask' =&gt; array('srcpackage', 'srcuri',
                    'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog')
            ));
    }

    /**
     * Remove all compatible tags
     */
    function clearCompatible()
    {
        unset($this-&gt;_packageInfo['compatible']);
    }

    /**
     * Reset dependencies prior to adding new ones
     */
    function clearDeps()
    {
        if (!isset($this-&gt;_packageInfo['dependencies'])) {
            $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, array(),
                array(
                    'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                        'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                        'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog')));
        }
        $this-&gt;_packageInfo['dependencies'] = array();
    }

    /**
     * @param string minimum PHP version allowed
     * @param string maximum PHP version allowed
     * @param array $exclude incompatible PHP versions
     */
    function setPhpDep($min, $max = false, $exclude = false)
    {
        $this-&gt;_isValid = 0;
        $dep =
            array(
                'min' =&gt; $min,
            );
        if ($max) {
            $dep['max'] = $max;
        }
        if ($exclude) {
            if (count($exclude) == 1) {
                $exclude = $exclude[0];
            }
            $dep['exclude'] = $exclude;
        }
        if (isset($this-&gt;_packageInfo['dependencies']['required']['php'])) {
            $this-&gt;_stack-&gt;push(__FUNCTION__, 'warning', array('dep' =&gt;
            $this-&gt;_packageInfo['dependencies']['required']['php']),
                'warning: PHP dependency already exists, overwriting');
            unset($this-&gt;_packageInfo['dependencies']['required']['php']);
        }
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                'required' =&gt; array('optional', 'group'),
                'php' =&gt; array('pearinstaller', 'package', 'subpackage', 'extension', 'os', 'arch')
            ));
        return true;
    }

    /**
     * @param string minimum allowed PEAR installer version
     * @param string maximum allowed PEAR installer version
     * @param string recommended PEAR installer version
     * @param array incompatible version of the PEAR installer
     */
    function setPearinstallerDep($min, $max = false, $recommended = false, $exclude = false)
    {
        $this-&gt;_isValid = 0;
        $dep =
            array(
                'min' =&gt; $min,
            );
        if ($max) {
            $dep['max'] = $max;
        }
        if ($recommended) {
            $dep['recommended'] = $recommended;
        }
        if ($exclude) {
            if (count($exclude) == 1) {
                $exclude = $exclude[0];
            }
            $dep['exclude'] = $exclude;
        }
        if (isset($this-&gt;_packageInfo['dependencies']['required']['pearinstaller'])) {
            $this-&gt;_stack-&gt;push(__FUNCTION__, 'warning', array('dep' =&gt;
            $this-&gt;_packageInfo['dependencies']['required']['pearinstaller']),
                'warning: PEAR Installer dependency already exists, overwriting');
            unset($this-&gt;_packageInfo['dependencies']['required']['pearinstaller']);
        }
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                'required' =&gt; array('optional', 'group'),
                'pearinstaller' =&gt; array('package', 'subpackage', 'extension', 'os', 'arch')
            ));
    }

    /**
     * Mark a package as conflicting with this package
     * @param string package name
     * @param string package channel
     * @param string extension this package provides, if any
     * @param string|false minimum version required
     * @param string|false maximum version allowed
     * @param array|false versions to exclude from installation
     */
    function addConflictingPackageDepWithChannel($name, $channel,
                $providesextension = false, $min = false, $max = false, $exclude = false)
    {
        $this-&gt;_isValid = 0;
        $dep = $this-&gt;_constructDep($name, $channel, false, $min, $max, false,
            $exclude, $providesextension, false, true);
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                'required' =&gt; array('optional', 'group'),
                'package' =&gt; array('subpackage', 'extension', 'os', 'arch')
            ));
    }

    /**
     * Mark a package as conflicting with this package
     * @param string package name
     * @param string package channel
     * @param string extension this package provides, if any
     */
    function addConflictingPackageDepWithUri($name, $uri, $providesextension = false)
    {
        $this-&gt;_isValid = 0;
        $dep =
            array(
                'name' =&gt; $name,
                'uri' =&gt; $uri,
                'conflicts' =&gt; '',
            );
        if ($providesextension) {
            $dep['providesextension'] = $providesextension;
        }
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                'required' =&gt; array('optional', 'group'),
                'package' =&gt; array('subpackage', 'extension', 'os', 'arch')
            ));
    }

    function addDependencyGroup($name, $hint)
    {
        $this-&gt;_isValid = 0;
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo,
            array('attribs' =&gt; array('name' =&gt; $name, 'hint' =&gt; $hint)),
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                'group' =&gt; array(),
            ));
    }

    /**
     * @param string package name
     * @param string|false channel name, false if this is a uri
     * @param string|false uri name, false if this is a channel
     * @param string|false minimum version required
     * @param string|false maximum version allowed
     * @param string|false recommended installation version
     * @param array|false versions to exclude from installation
     * @param string extension this package provides, if any
     * @param bool if true, tells the installer to ignore the default optional dependency group
     *             when installing this package
     * @param bool if true, tells the installer to negate this dependency (conflicts)
     * @return array
     * @access private
     */
    function _constructDep($name, $channel, $uri, $min, $max, $recommended, $exclude,
                           $providesextension = false, $nodefault = false,
                           $conflicts = false)
    {
        $dep =
            array(
                'name' =&gt; $name,
            );
        if ($channel) {
            $dep['channel'] = $channel;
        } elseif ($uri) {
            $dep['uri'] = $uri;
        }
        if ($min) {
            $dep['min'] = $min;
        }
        if ($max) {
            $dep['max'] = $max;
        }
        if ($recommended) {
            $dep['recommended'] = $recommended;
        }
        if ($exclude) {
            if (is_array($exclude) &amp;&amp; count($exclude) == 1) {
                $exclude = $exclude[0];
            }
            $dep['exclude'] = $exclude;
        }
        if ($conflicts) {
            $dep['conflicts'] = '';
        }
        if ($nodefault) {
            $dep['nodefault'] = '';
        }
        if ($providesextension) {
            $dep['providesextension'] = $providesextension;
        }
        return $dep;
    }

    /**
     * @param package|subpackage
     * @param string group name
     * @param string package name
     * @param string package channel
     * @param string minimum version
     * @param string maximum version
     * @param string recommended version
     * @param array|false optional excluded versions
     * @param string extension this package provides, if any
     * @param bool if true, tells the installer to ignore the default optional dependency group
     *             when installing this package
     * @return bool false if the dependency group has not been initialized with
     *              {@link addDependencyGroup()}, or a subpackage is added with
     *              a providesextension
     */
    function addGroupPackageDepWithChannel($type, $groupname, $name, $channel, $min = false,
                                      $max = false, $recommended = false, $exclude = false,
                                      $providesextension = false, $nodefault = false)
    {
        if ($type == 'subpackage' &amp;&amp; $providesextension) {
            return false; // subpackages must be php packages
        }
        $dep = $this-&gt;_constructDep($name, $channel, false, $min, $max, $recommended, $exclude,
            $providesextension, $nodefault);
        return $this-&gt;_addGroupDependency($type, $dep, $groupname);
    }

    /**
     * @param package|subpackage
     * @param string group name
     * @param string package name
     * @param string package uri
     * @param string extension this package provides, if any
     * @param bool if true, tells the installer to ignore the default optional dependency group
     *             when installing this package
     * @return bool false if the dependency group has not been initialized with
     *              {@link addDependencyGroup()}
     */
    function addGroupPackageDepWithURI($type, $groupname, $name, $uri, $providesextension = false,
                                       $nodefault = false)
    {
        if ($type == 'subpackage' &amp;&amp; $providesextension) {
            return false; // subpackages must be php packages
        }
        $dep = $this-&gt;_constructDep($name, false, $uri, false, false, false, false,
            $providesextension, $nodefault);
        return $this-&gt;_addGroupDependency($type, $dep, $groupname);
    }

    /**
     * @param string group name (must be pre-existing)
     * @param string extension name
     * @param string minimum version allowed
     * @param string maximum version allowed
     * @param string recommended version
     * @param array incompatible versions
     */
    function addGroupExtensionDep($groupname, $name, $min = false, $max = false,
                                         $recommended = false, $exclude = false)
    {
        $this-&gt;_isValid = 0;
        $dep = $this-&gt;_constructDep($name, false, false, $min, $max, $recommended, $exclude);
        return $this-&gt;_addGroupDependency('extension', $dep, $groupname);
    }

    /**
     * @param package|subpackage|extension
     * @param array dependency contents
     * @param string name of the dependency group to add this to
     * @return boolean
     * @access private
     */
    function _addGroupDependency($type, $dep, $groupname)
    {
        $arr = array('subpackage', 'extension');
        if ($type != 'package') {
            array_shift($arr);
        }
        if ($type == 'extension') {
            array_shift($arr);
        }
        if (!isset($this-&gt;_packageInfo['dependencies']['group'])) {
            return false;
        } else {
            if (!isset($this-&gt;_packageInfo['dependencies']['group'][0])) {
                if ($this-&gt;_packageInfo['dependencies']['group']['attribs']['name'] == $groupname) {
                    $this-&gt;_packageInfo['dependencies']['group'] = $this-&gt;_mergeTag(
                        $this-&gt;_packageInfo['dependencies']['group'], $dep,
                        array(
                            $type =&gt; $arr
                        ));
                    $this-&gt;_isValid = 0;
                    return true;
                } else {
                    return false;
                }
            } else {
                foreach ($this-&gt;_packageInfo['dependencies']['group'] as $i =&gt; $group) {
                    if ($group['attribs']['name'] == $groupname) {
                    $this-&gt;_packageInfo['dependencies']['group'][$i] = $this-&gt;_mergeTag(
                        $this-&gt;_packageInfo['dependencies']['group'][$i], $dep,
                        array(
                            $type =&gt; $arr
                        ));
                        $this-&gt;_isValid = 0;
                        return true;
                    }
                }
                return false;
            }
        }
    }

    /**
     * @param optional|required
     * @param string package name
     * @param string package channel
     * @param string minimum version
     * @param string maximum version
     * @param string recommended version
     * @param string extension this package provides, if any
     * @param bool if true, tells the installer to ignore the default optional dependency group
     *             when installing this package
     * @param array|false optional excluded versions
     */
    function addPackageDepWithChannel($type, $name, $channel, $min = false, $max = false,
                                      $recommended = false, $exclude = false,
                                      $providesextension = false, $nodefault = false)
    {
        if (!in_array($type, array('optional', 'required'), true)) {
            $type = 'required';
        }
        $this-&gt;_isValid = 0;
        $arr = array('optional', 'group');
        if ($type != 'required') {
            array_shift($arr);
        }
        $dep = $this-&gt;_constructDep($name, $channel, false, $min, $max, $recommended, $exclude,
            $providesextension, $nodefault);
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                $type =&gt; $arr,
                'package' =&gt; array('subpackage', 'extension', 'os', 'arch')
            ));
    }

    /**
     * @param optional|required
     * @param string name of the package
     * @param string uri of the package
     * @param string extension this package provides, if any
     * @param bool if true, tells the installer to ignore the default optional dependency group
     *             when installing this package
     */
    function addPackageDepWithUri($type, $name, $uri, $providesextension = false,
                                  $nodefault = false)
    {
        $this-&gt;_isValid = 0;
        $arr = array('optional', 'group');
        if ($type != 'required') {
            array_shift($arr);
        }
        $dep = $this-&gt;_constructDep($name, false, $uri, false, false, false, false,
            $providesextension, $nodefault);
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                $type =&gt; $arr,
                'package' =&gt; array('subpackage', 'extension', 'os', 'arch')
            ));
    }

    /**
     * @param optional|required optional, required
     * @param string package name
     * @param string package channel
     * @param string minimum version
     * @param string maximum version
     * @param string recommended version
     * @param array incompatible versions
     * @param bool if true, tells the installer to ignore the default optional dependency group
     *             when installing this package
     */
    function addSubpackageDepWithChannel($type, $name, $channel, $min = false, $max = false,
                                         $recommended = false, $exclude = false,
                                         $nodefault = false)
    {
        $this-&gt;_isValid = 0;
        $arr = array('optional', 'group');
        if ($type != 'required') {
            array_shift($arr);
        }
        $dep = $this-&gt;_constructDep($name, $channel, false, $min, $max, $recommended, $exclude,
            $nodefault);
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                $type =&gt; $arr,
                'subpackage' =&gt; array('extension', 'os', 'arch')
            ));
    }

    /**
     * @param optional|required optional, required
     * @param string package name
     * @param string package uri for download
     * @param bool if true, tells the installer to ignore the default optional dependency group
     *             when installing this package
     */
    function addSubpackageDepWithUri($type, $name, $uri, $nodefault = false)
    {
        $this-&gt;_isValid = 0;
        $arr = array('optional', 'group');
        if ($type != 'required') {
            array_shift($arr);
        }
        $dep = $this-&gt;_constructDep($name, false, $uri, false, false, false, false, $nodefault);
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                $type =&gt; $arr,
                'subpackage' =&gt; array('extension', 'os', 'arch')
            ));
    }

    /**
     * @param optional|required optional, required
     * @param string extension name
     * @param string minimum version
     * @param string maximum version
     * @param string recommended version
     * @param array incompatible versions
     */
    function addExtensionDep($type, $name, $min = false, $max = false, $recommended = false,
                             $exclude = false)
    {
        $this-&gt;_isValid = 0;
        $arr = array('optional', 'group');
        if ($type != 'required') {
            array_shift($arr);
        }
        $dep = $this-&gt;_constructDep($name, false, false, $min, $max, $recommended, $exclude);
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                $type =&gt; $arr,
                'extension' =&gt; array('os', 'arch')
            ));
    }

    /**
     * @param string Operating system name
     * @param boolean true if this package cannot be installed on this OS
     */
    function addOsDep($name, $conflicts = false)
    {
        $this-&gt;_isValid = 0;
        $dep = array('name' =&gt; $name);
        if ($conflicts) {
            $dep['conflicts'] = '';
        }
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                'required' =&gt; array('optional', 'group'),
                'os' =&gt; array('arch')
            ));
    }

    /**
     * @param string Architecture matching pattern
     * @param boolean true if this package cannot be installed on this architecture
     */
    function addArchDep($pattern, $conflicts = false)
    {
        $this-&gt;_isValid = 0;
        $dep = array('pattern' =&gt; $pattern);
        if ($conflicts) {
            $dep['conflicts'] = '';
        }
        $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, $dep,
            array(
                'dependencies' =&gt; array('providesextension', 'usesrole', 'usestask',
                    'srcpackage', 'srcuri', 'phprelease', 'extsrcrelease', 'extbinrelease',
                    'zendextsrcrelease', 'zendextbinrelease', 'bundle', 'changelog'),
                'required' =&gt; array('optional', 'group'),
                'arch' =&gt; array()
            ));
    }

    /**
     * Set the kind of package, and erase all release tags
     *
     * - a php package is a PEAR-style package
     * - an extbin package is a PECL-style extension binary
     * - an extsrc package is a PECL-style source for a binary
     * - an zendextbin package is a PECL-style zend extension binary
     * - an zendextsrc package is a PECL-style source for a zend extension binary
     * - a bundle package is a collection of other pre-packaged packages
     * @param php|extbin|extsrc|zendextsrc|zendextbin|bundle
     * @return bool success
     */
    function setPackageType($type)
    {
        $this-&gt;_isValid = 0;
        if (!in_array($type, array('php', 'extbin', 'extsrc', 'zendextsrc',
                                   'zendextbin', 'bundle'))) {
            return false;
        }

        if (in_array($type, array('zendextsrc', 'zendextbin'))) {
            $this-&gt;_setPackageVersion2_1();
        }

        if ($type != 'bundle') {
            $type .= 'release';
        }

        foreach (array('phprelease', 'extbinrelease', 'extsrcrelease',
                       'zendextsrcrelease', 'zendextbinrelease', 'bundle') as $test) {
            unset($this-&gt;_packageInfo[$test]);
        }

        if (!isset($this-&gt;_packageInfo[$type])) {
            // ensure that the release tag is set up
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo, array('changelog'),
                array(), $type);
        }

        $this-&gt;_packageInfo[$type] = array();
        return true;
    }

    /**
     * @return bool true if package type is set up
     */
    function addRelease()
    {
        if ($type = $this-&gt;getPackageType()) {
            if ($type != 'bundle') {
                $type .= 'release';
            }
            $this-&gt;_packageInfo = $this-&gt;_mergeTag($this-&gt;_packageInfo, array(),
                array($type =&gt; array('changelog')));
            return true;
        }
        return false;
    }

    /**
     * Get the current release tag in order to add to it
     * @param bool returns only releases that have installcondition if true
     * @return array|null
     */
    function &amp;_getCurrentRelease($strict = true)
    {
        if ($p = $this-&gt;getPackageType()) {
            if ($strict) {
                if ($p == 'extsrc' || $p == 'zendextsrc') {
                    $a = null;
                    return $a;
                }
            }
            if ($p != 'bundle') {
                $p .= 'release';
            }
            if (isset($this-&gt;_packageInfo[$p][0])) {
                return $this-&gt;_packageInfo[$p][count($this-&gt;_packageInfo[$p]) - 1];
            } else {
                return $this-&gt;_packageInfo[$p];
            }
        } else {
            $a = null;
            return $a;
        }
    }

    /**
     * Add a file to the current release that should be installed under a different name
     * @param string &lt;contents&gt; path to file
     * @param string name the file should be installed as
     */
    function addInstallAs($path, $as)
    {
        $r = &amp;$this-&gt;_getCurrentRelease();
        if ($r === null) {
            return false;
        }
        $this-&gt;_isValid = 0;
        $r = $this-&gt;_mergeTag($r, array('attribs' =&gt; array('name' =&gt; $path, 'as' =&gt; $as)),
            array(
                'filelist' =&gt; array(),
                'install' =&gt; array('ignore')
            ));
    }

    /**
     * Add a file to the current release that should be ignored
     * @param string &lt;contents&gt; path to file
     * @return bool success of operation
     */
    function addIgnore($path)
    {
        $r = &amp;$this-&gt;_getCurrentRelease();
        if ($r === null) {
            return false;
        }
        $this-&gt;_isValid = 0;
        $r = $this-&gt;_mergeTag($r, array('attribs' =&gt; array('name' =&gt; $path)),
            array(
                'filelist' =&gt; array(),
                'ignore' =&gt; array()
            ));
    }

    /**
     * Add an extension binary package for this extension source code release
     *
     * Note that the package must be from the same channel as the extension source package
     * @param string
     */
    function addBinarypackage($package)
    {
        if ($this-&gt;getPackageType() != 'extsrc' &amp;&amp; $this-&gt;getPackageType() != 'zendextsrc') {
            return false;
        }
        $r = &amp;$this-&gt;_getCurrentRelease(false);
        if ($r === null) {
            return false;
        }
        $this-&gt;_isValid = 0;
        $r = $this-&gt;_mergeTag($r, $package,
            array(
                'binarypackage' =&gt; array('filelist'),
            ));
    }

    /**
     * Add a configureoption to an extension source package
     * @param string
     * @param string
     * @param string
     */
    function addConfigureOption($name, $prompt, $default = null)
    {
        if ($this-&gt;getPackageType() != 'extsrc' &amp;&amp; $this-&gt;getPackageType() != 'zendextsrc') {
            return false;
        }

        $r = &amp;$this-&gt;_getCurrentRelease(false);
        if ($r === null) {
            return false;
        }

        $opt = array('attribs' =&gt; array('name' =&gt; $name, 'prompt' =&gt; $prompt));
        if ($default !== null) {
            $opt['attribs']['default'] = $default;
        }

        $this-&gt;_isValid = 0;
        $r = $this-&gt;_mergeTag($r, $opt,
            array(
                'configureoption' =&gt; array('binarypackage', 'filelist'),
            ));
    }

    /**
     * Set an installation condition based on php version for the current release set
     * @param string minimum version
     * @param string maximum version
     * @param false|array incompatible versions of PHP
     */
    function setPhpInstallCondition($min, $max, $exclude = false)
    {
        $r = &amp;$this-&gt;_getCurrentRelease();
        if ($r === null) {
            return false;
        }
        $this-&gt;_isValid = 0;
        if (isset($r['installconditions']['php'])) {
            unset($r['installconditions']['php']);
        }
        $dep = array('min' =&gt; $min, 'max' =&gt; $max);
        if ($exclude) {
            if (is_array($exclude) &amp;&amp; count($exclude) == 1) {
                $exclude = $exclude[0];
            }
            $dep['exclude'] = $exclude;
        }
        if ($this-&gt;getPackageType() == 'extsrc' || $this-&gt;getPackageType() == 'zendextsrc') {
            $r = $this-&gt;_mergeTag($r, $dep,
                array(
                    'installconditions' =&gt; array('configureoption', 'binarypackage',
                        'filelist'),
                    'php' =&gt; array('extension', 'os', 'arch')
                ));
        } else {
            $r = $this-&gt;_mergeTag($r, $dep,
                array(
                    'installconditions' =&gt; array('filelist'),
                    'php' =&gt; array('extension', 'os', 'arch')
                ));
        }
    }

    /**
     * @param optional|required optional, required
     * @param string extension name
     * @param string minimum version
     * @param string maximum version
     * @param string recommended version
     * @param array incompatible versions
     */
    function addExtensionInstallCondition($name, $min = false, $max = false, $recommended = false,
                                          $exclude = false)
    {
        $r = &amp;$this-&gt;_getCurrentRelease();
        if ($r === null) {
            return false;
        }
        $this-&gt;_isValid = 0;
        $dep = $this-&gt;_constructDep($name, false, false, $min, $max, $recommended, $exclude);
        if ($this-&gt;getPackageType() == 'extsrc' || $this-&gt;getPackageType() == 'zendextsrc') {
            $r = $this-&gt;_mergeTag($r, $dep,
                array(
                    'installconditions' =&gt; array('configureoption', 'binarypackage',
                        'filelist'),
                    'extension' =&gt; array('os', 'arch')
                ));
        } else {
            $r = $this-&gt;_mergeTag($r, $dep,
                array(
                    'installconditions' =&gt; array('filelist'),
                    'extension' =&gt; array('os', 'arch')
                ));
        }
    }

    /**
     * Set an installation condition based on operating system for the current release set
     * @param string OS name
     * @param bool whether this OS is incompatible with the current release
     */
    function setOsInstallCondition($name, $conflicts = false)
    {
        $r = &amp;$this-&gt;_getCurrentRelease();
        if ($r === null) {
            return false;
        }
        $this-&gt;_isValid = 0;
        if (isset($r['installconditions']['os'])) {
            unset($r['installconditions']['os']);
        }
        $dep = array('name' =&gt; $name);
        if ($conflicts) {
            $dep['conflicts'] = '';
        }
        if ($this-&gt;getPackageType() == 'extsrc' || $this-&gt;getPackageType() == 'zendextsrc') {
            $r = $this-&gt;_mergeTag($r, $dep,
                array(
                    'installconditions' =&gt; array('configureoption', 'binarypackage',
                        'filelist'),
                    'os' =&gt; array('arch')
                ));
        } else {
            $r = $this-&gt;_mergeTag($r, $dep,
                array(
                    'installconditions' =&gt; array('filelist'),
                    'os' =&gt; array('arch')
                ));
        }
    }

    /**
     * Set an installation condition based on architecture for the current release set
     * @param string architecture pattern
     * @param bool whether this arch is incompatible with the current release
     */
    function setArchInstallCondition($pattern, $conflicts = false)
    {
        $r = &amp;$this-&gt;_getCurrentRelease();
        if ($r === null) {
            return false;
        }
        $this-&gt;_isValid = 0;
        if (isset($r['installconditions']['arch'])) {
            unset($r['installconditions']['arch']);
        }
        $dep = array('pattern' =&gt; $pattern);
        if ($conflicts) {
            $dep['conflicts'] = '';
        }
        if ($this-&gt;getPackageType() == 'extsrc' || $this-&gt;getPackageType() == 'zendextsrc') {
            $r = $this-&gt;_mergeTag($r, $dep,
                array(
                    'installconditions' =&gt; array('configureoption', 'binarypackage',
                        'filelist'),
                    'arch' =&gt; array()
                ));
        } else {
            $r = $this-&gt;_mergeTag($r, $dep,
                array(
                    'installconditions' =&gt; array('filelist'),
                    'arch' =&gt; array()
                ));
        }
    }

    /**
     * For extension binary releases, this is used to specify either the
     * static URI to a source package, or the package name and channel of the extsrc/zendextsrc
     * package it is based on.
     * @param string Package name, or full URI to source package (extsrc/zendextsrc type)
     */
    function setSourcePackage($packageOrUri)
    {
        $this-&gt;_isValid = 0;
        if (isset($this-&gt;_packageInfo['channel'])) {
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo, array('phprelease',
                'extsrcrelease', 'extbinrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'bundle', 'changelog'),
                $packageOrUri, 'srcpackage');
        } else {
            $this-&gt;_packageInfo = $this-&gt;_insertBefore($this-&gt;_packageInfo, array('phprelease',
                'extsrcrelease', 'extbinrelease', 'zendextsrcrelease', 'zendextbinrelease',
                'bundle', 'changelog'), $packageOrUri, 'srcuri');
        }
    }

    /**
     * Generate a valid change log entry from the current package.xml
     * @param string|false
     */
    function generateChangeLogEntry($notes = false)
    {
        return array(
            'version' =&gt;
                array(
                    'release' =&gt; $this-&gt;getVersion('release'),
                    'api' =&gt; $this-&gt;getVersion('api'),
                    ),
            'stability' =&gt;
                $this-&gt;getStability(),
            'date' =&gt; $this-&gt;getDate(),
            'license' =&gt; $this-&gt;getLicense(true),
            'notes' =&gt; $notes ? $notes : $this-&gt;getNotes()
            );
    }

    /**
     * @param string release version to set change log notes for
     * @param array output of {@link generateChangeLogEntry()}
     */
    function setChangelogEntry($releaseversion, $contents)
    {
        if (!isset($this-&gt;_packageInfo['changelog'])) {
            $this-&gt;_packageInfo['changelog']['release'] = $contents;
            return;
        }
        if (!isset($this-&gt;_packageInfo['changelog']['release'][0])) {
            if ($this-&gt;_packageInfo['changelog']['release']['version']['release'] == $releaseversion) {
                $this-&gt;_packageInfo['changelog']['release'] = array(
                    $this-&gt;_packageInfo['changelog']['release']);
            } else {
                $this-&gt;_packageInfo['changelog']['release'] = array(
                    $this-&gt;_packageInfo['changelog']['release']);
                return $this-&gt;_packageInfo['changelog']['release'][] = $contents;
            }
        }
        foreach($this-&gt;_packageInfo['changelog']['release'] as $index =&gt; $changelog) {
            if (isset($changelog['version']) &amp;&amp;
                  strnatcasecmp($changelog['version']['release'], $releaseversion) == 0) {
                $curlog = $index;
            }
        }
        if (isset($curlog)) {
            $this-&gt;_packageInfo['changelog']['release'][$curlog] = $contents;
        } else {
            $this-&gt;_packageInfo['changelog']['release'][] = $contents;
        }
    }

    /**
     * Remove the changelog entirely
     */
    function clearChangeLog()
    {
        unset($this-&gt;_packageInfo['changelog']);
    }
}</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fopt%2Falt%2Fphp74%2Fusr%2Fshare%2Fpear%2FPEAR%2FPackageFile%2Fv2'>Back to Directory</a>