<h2>Editing File: /opt/cpanel/ea-php80/root/usr/share/pear/PEAR/Validate.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php
/**
 * PEAR_Validate
 *
 * 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
 */
/**#@+
 * Constants for install stage
 */
define('PEAR_VALIDATE_INSTALLING', 1);
define('PEAR_VALIDATE_UNINSTALLING', 2); // this is not bit-mapped like the others
define('PEAR_VALIDATE_NORMAL', 3);
define('PEAR_VALIDATE_DOWNLOADING', 4); // this is not bit-mapped like the others
define('PEAR_VALIDATE_PACKAGING', 7);
/**#@-*/
require_once 'PEAR/Common.php';
require_once 'PEAR/Validator/PECL.php';

/**
 * Validation class for package.xml - channel-level advanced validation
 * @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_Validate
{
    var $packageregex = _PEAR_COMMON_PACKAGE_NAME_PREG;
    /**
     * @var PEAR_PackageFile_v1|PEAR_PackageFile_v2
     */
    var $_packagexml;
    /**
     * @var int one of the PEAR_VALIDATE_* constants
     */
    var $_state = PEAR_VALIDATE_NORMAL;
    /**
     * Format: ('error' =&gt; array('field' =&gt; name, 'reason' =&gt; reason), 'warning' =&gt; same)
     * @var array
     * @access private
     */
    var $_failures = array('error' =&gt; array(), 'warning' =&gt; array());

    /**
     * Override this method to handle validation of normal package names
     * @param string
     * @return bool
     * @access protected
     */
    function _validPackageName($name)
    {
        return (bool) preg_match('/^' . $this-&gt;packageregex . '\\z/', $name);
    }

    /**
     * @param string package name to validate
     * @param string name of channel-specific validation package
     * @final
     */
    function validPackageName($name, $validatepackagename = false)
    {
        if ($validatepackagename) {
            if (strtolower($name) == strtolower($validatepackagename)) {
                return (bool) preg_match('/^[a-zA-Z0-9_]+(?:\.[a-zA-Z0-9_]+)*\\z/', $name);
            }
        }
        return $this-&gt;_validPackageName($name);
    }

    /**
     * This validates a bundle name, and bundle names must conform
     * to the PEAR naming convention, so the method is final and static.
     * @param string
     * @final
     */
    public static function validGroupName($name)
    {
        return (bool) preg_match('/^' . _PEAR_COMMON_PACKAGE_NAME_PREG . '\\z/', $name);
    }

    /**
     * Determine whether $state represents a valid stability level
     * @param string
     * @return bool
     * @final
     */
    public static function validState($state)
    {
        return in_array($state, array('snapshot', 'devel', 'alpha', 'beta', 'stable'));
    }

    /**
     * Get a list of valid stability levels
     * @return array
     * @final
     */
    public static function getValidStates()
    {
        return array('snapshot', 'devel', 'alpha', 'beta', 'stable');
    }

    /**
     * Determine whether a version is a properly formatted version number that can be used
     * by version_compare
     * @param string
     * @return bool
     * @final
     */
    public static function validVersion($ver)
    {
        return (bool) preg_match(PEAR_COMMON_PACKAGE_VERSION_PREG, $ver);
    }

    /**
     * @param PEAR_PackageFile_v1|PEAR_PackageFile_v2
     */
    function setPackageFile(&amp;$pf)
    {
        $this-&gt;_packagexml = &amp;$pf;
    }

    /**
     * @access private
     */
    function _addFailure($field, $reason)
    {
        $this-&gt;_failures['errors'][] = array('field' =&gt; $field, 'reason' =&gt; $reason);
    }

    /**
     * @access private
     */
    function _addWarning($field, $reason)
    {
        $this-&gt;_failures['warnings'][] = array('field' =&gt; $field, 'reason' =&gt; $reason);
    }

    function getFailures()
    {
        $failures = $this-&gt;_failures;
        $this-&gt;_failures = array('warnings' =&gt; array(), 'errors' =&gt; array());
        return $failures;
    }

    /**
     * @param int one of the PEAR_VALIDATE_* constants
     */
    function validate($state = null)
    {
        if (!isset($this-&gt;_packagexml)) {
            return false;
        }
        if ($state !== null) {
            $this-&gt;_state = $state;
        }
        $this-&gt;_failures = array('warnings' =&gt; array(), 'errors' =&gt; array());
        $this-&gt;validatePackageName();
        $this-&gt;validateVersion();
        $this-&gt;validateMaintainers();
        $this-&gt;validateDate();
        $this-&gt;validateSummary();
        $this-&gt;validateDescription();
        $this-&gt;validateLicense();
        $this-&gt;validateNotes();
        if ($this-&gt;_packagexml-&gt;getPackagexmlVersion() == '1.0') {
            $this-&gt;validateState();
            $this-&gt;validateFilelist();
        } elseif ($this-&gt;_packagexml-&gt;getPackagexmlVersion() == '2.0' ||
                  $this-&gt;_packagexml-&gt;getPackagexmlVersion() == '2.1') {
            $this-&gt;validateTime();
            $this-&gt;validateStability();
            $this-&gt;validateDeps();
            $this-&gt;validateMainFilelist();
            $this-&gt;validateReleaseFilelist();
            //$this-&gt;validateGlobalTasks();
            $this-&gt;validateChangelog();
        }
        return !((bool) count($this-&gt;_failures['errors']));
    }

    /**
     * @access protected
     */
    function validatePackageName()
    {
        if ($this-&gt;_state == PEAR_VALIDATE_PACKAGING ||
              $this-&gt;_state == PEAR_VALIDATE_NORMAL) {
            if (($this-&gt;_packagexml-&gt;getPackagexmlVersion() == '2.0' ||
                 $this-&gt;_packagexml-&gt;getPackagexmlVersion() == '2.1') &amp;&amp;
                  $this-&gt;_packagexml-&gt;getExtends()) {
                $version = $this-&gt;_packagexml-&gt;getVersion() . '';
                $name = $this-&gt;_packagexml-&gt;getPackage();
                $a = explode('.', $version);
                $test = array_shift($a);
                if ($test == '0') {
                    return true;
                }
                $vlen = strlen($test);
                $majver = substr($name, strlen($name) - $vlen);
                while ($majver &amp;&amp; !is_numeric($majver[0])) {
                    $majver = substr($majver, 1);
                }
                if ($majver != $test) {
                    $this-&gt;_addWarning('package', &quot;package $name extends package &quot; .
                        $this-&gt;_packagexml-&gt;getExtends() . ' and so the name should ' .
                        'have a postfix equal to the major version like &quot;' .
                        $this-&gt;_packagexml-&gt;getExtends() . $test . '&quot;');
                    return true;
                } elseif (substr($name, 0, strlen($name) - $vlen) !=
                            $this-&gt;_packagexml-&gt;getExtends()) {
                    $this-&gt;_addWarning('package', &quot;package $name extends package &quot; .
                        $this-&gt;_packagexml-&gt;getExtends() . ' and so the name must ' .
                        'be an extension like &quot;' . $this-&gt;_packagexml-&gt;getExtends() .
                        $test . '&quot;');
                    return true;
                }
            }
        }
        if (!$this-&gt;validPackageName($this-&gt;_packagexml-&gt;getPackage())) {
            $this-&gt;_addFailure('name', 'package name &quot;' .
                $this-&gt;_packagexml-&gt;getPackage() . '&quot; is invalid');
            return false;
        }
    }

    /**
     * @access protected
     */
    function validateVersion()
    {
        if ($this-&gt;_state != PEAR_VALIDATE_PACKAGING) {
            if (!$this-&gt;validVersion($this-&gt;_packagexml-&gt;getVersion())) {
                $this-&gt;_addFailure('version',
                    'Invalid version number &quot;' . $this-&gt;_packagexml-&gt;getVersion() . '&quot;');
            }
            return false;
        }
        $version = $this-&gt;_packagexml-&gt;getVersion();
        $versioncomponents = explode('.', $version);
        if (count($versioncomponents) != 3) {
            $this-&gt;_addWarning('version',
                'A version number should have 3 decimals (x.y.z)');
            return true;
        }
        $name = $this-&gt;_packagexml-&gt;getPackage();
        // version must be based upon state
        switch ($this-&gt;_packagexml-&gt;getState()) {
            case 'snapshot' :
                return true;
            case 'devel' :
                if ($versioncomponents[0] . 'a' == '0a') {
                    return true;
                }
                if ($versioncomponents[0] == 0) {
                    $versioncomponents[0] = '0';
                    $this-&gt;_addWarning('version',
                        'version &quot;' . $version . '&quot; should be &quot;' .
                        implode('.' ,$versioncomponents) . '&quot;');
                } else {
                    $this-&gt;_addWarning('version',
                        'packages with devel stability must be &lt; version 1.0.0');
                }
                return true;
            break;
            case 'alpha' :
            case 'beta' :
                // check for a package that extends a package,
                // like Foo and Foo2
                if ($this-&gt;_state == PEAR_VALIDATE_PACKAGING) {
                    if (substr($versioncomponents[2], 1, 2) == 'rc') {
                        $this-&gt;_addFailure('version', 'Release Candidate versions ' .
                            'must have capital RC, not lower-case rc');
                        return false;
                    }
                }
                if (!$this-&gt;_packagexml-&gt;getExtends()) {
                    if ($versioncomponents[0] == '1') {
                        if ($versioncomponents[2][0] == '0') {
                            if ($versioncomponents[2] == '0') {
                                // version 1.*.0000
                                $this-&gt;_addWarning('version',
                                    'version 1.' . $versioncomponents[1] .
                                        '.0 probably should not be alpha or beta');
                                return true;
                            } elseif (strlen($versioncomponents[2]) &gt; 1) {
                                // version 1.*.0RC1 or 1.*.0beta24 etc.
                                return true;
                            } else {
                                // version 1.*.0
                                $this-&gt;_addWarning('version',
                                    'version 1.' . $versioncomponents[1] .
                                        '.0 probably should not be alpha or beta');
                                return true;
                            }
                        } else {
                            $this-&gt;_addWarning('version',
                                'bugfix versions (1.3.x where x &gt; 0) probably should ' .
                                'not be alpha or beta');
                            return true;
                        }
                    } elseif ($versioncomponents[0] != '0') {
                        $this-&gt;_addWarning('version',
                            'major versions greater than 1 are not allowed for packages ' .
                            'without an &lt;extends&gt; tag or an identical postfix (foo2 v2.0.0)');
                        return true;
                    }
                    if ($versioncomponents[0] . 'a' == '0a') {
                        return true;
                    }
                    if ($versioncomponents[0] == 0) {
                        $versioncomponents[0] = '0';
                        $this-&gt;_addWarning('version',
                            'version &quot;' . $version . '&quot; should be &quot;' .
                            implode('.' ,$versioncomponents) . '&quot;');
                    }
                } else {
                    $vlen = strlen($versioncomponents[0] . '');
                    $majver = substr($name, strlen($name) - $vlen);
                    while ($majver &amp;&amp; !is_numeric($majver[0])) {
                        $majver = substr($majver, 1);
                    }
                    if (($versioncomponents[0] != 0) &amp;&amp; $majver != $versioncomponents[0]) {
                        $this-&gt;_addWarning('version', 'first version number &quot;' .
                            $versioncomponents[0] . '&quot; must match the postfix of ' .
                            'package name &quot;' . $name . '&quot; (' .
                            $majver . ')');
                        return true;
                    }
                    if ($versioncomponents[0] == $majver) {
                        if ($versioncomponents[2][0] == '0') {
                            if ($versioncomponents[2] == '0') {
                                // version 2.*.0000
                                $this-&gt;_addWarning('version',
                                    &quot;version $majver.&quot; . $versioncomponents[1] .
                                        '.0 probably should not be alpha or beta');
                                return false;
                            } elseif (strlen($versioncomponents[2]) &gt; 1) {
                                // version 2.*.0RC1 or 2.*.0beta24 etc.
                                return true;
                            } else {
                                // version 2.*.0
                                $this-&gt;_addWarning('version',
                                    &quot;version $majver.&quot; . $versioncomponents[1] .
                                        '.0 cannot be alpha or beta');
                                return true;
                            }
                        } else {
                            $this-&gt;_addWarning('version',
                                &quot;bugfix versions ($majver.x.y where y &gt; 0) should &quot; .
                                'not be alpha or beta');
                            return true;
                        }
                    } elseif ($versioncomponents[0] != '0') {
                        $this-&gt;_addWarning('version',
                            &quot;only versions 0.x.y and $majver.x.y are allowed for alpha/beta releases&quot;);
                        return true;
                    }
                    if ($versioncomponents[0] . 'a' == '0a') {
                        return true;
                    }
                    if ($versioncomponents[0] == 0) {
                        $versioncomponents[0] = '0';
                        $this-&gt;_addWarning('version',
                            'version &quot;' . $version . '&quot; should be &quot;' .
                            implode('.' ,$versioncomponents) . '&quot;');
                    }
                }
                return true;
            break;
            case 'stable' :
                if ($versioncomponents[0] == '0') {
                    $this-&gt;_addWarning('version', 'versions less than 1.0.0 cannot ' .
                    'be stable');
                    return true;
                }
                if (!is_numeric($versioncomponents[2])) {
                    if (preg_match('/\d+(rc|a|alpha|b|beta)\d*/i',
                          $versioncomponents[2])) {
                        $this-&gt;_addWarning('version', 'version &quot;' . $version . '&quot; or any ' .
                            'RC/beta/alpha version cannot be stable');
                        return true;
                    }
                }
                // check for a package that extends a package,
                // like Foo and Foo2
                if ($this-&gt;_packagexml-&gt;getExtends()) {
                    $vlen = strlen($versioncomponents[0] . '');
                    $majver = substr($name, strlen($name) - $vlen);
                    while ($majver &amp;&amp; !is_numeric($majver[0])) {
                        $majver = substr($majver, 1);
                    }
                    if (($versioncomponents[0] != 0) &amp;&amp; $majver != $versioncomponents[0]) {
                        $this-&gt;_addWarning('version', 'first version number &quot;' .
                            $versioncomponents[0] . '&quot; must match the postfix of ' .
                            'package name &quot;' . $name . '&quot; (' .
                            $majver . ')');
                        return true;
                    }
                } elseif ($versioncomponents[0] &gt; 1) {
                    $this-&gt;_addWarning('version', 'major version x in x.y.z may not be greater than ' .
                        '1 for any package that does not have an &lt;extends&gt; tag');
                }
                return true;
            break;
            default :
                return false;
            break;
        }
    }

    /**
     * @access protected
     */
    function validateMaintainers()
    {
        // maintainers can only be truly validated server-side for most channels
        // but allow this customization for those who wish it
        return true;
    }

    /**
     * @access protected
     */
    function validateDate()
    {
        if ($this-&gt;_state == PEAR_VALIDATE_NORMAL ||
              $this-&gt;_state == PEAR_VALIDATE_PACKAGING) {

            if (!preg_match('/(\d\d\d\d)\-(\d\d)\-(\d\d)/',
                  $this-&gt;_packagexml-&gt;getDate(), $res) ||
                  count($res) &lt; 4
                  || !checkdate($res[2], $res[3], $res[1])
                ) {
                $this-&gt;_addFailure('date', 'invalid release date &quot;' .
                    $this-&gt;_packagexml-&gt;getDate() . '&quot;');
                return false;
            }

            if ($this-&gt;_state == PEAR_VALIDATE_PACKAGING &amp;&amp;
                  $this-&gt;_packagexml-&gt;getDate() != date('Y-m-d')) {
                $this-&gt;_addWarning('date', 'Release Date &quot;' .
                    $this-&gt;_packagexml-&gt;getDate() . '&quot; is not today');
            }
        }
        return true;
    }

    /**
     * @access protected
     */
    function validateTime()
    {
        if (!$this-&gt;_packagexml-&gt;getTime()) {
            // default of no time value set
            return true;
        }

        // packager automatically sets time, so only validate if pear validate is called
        if ($this-&gt;_state = PEAR_VALIDATE_NORMAL) {
            if (!preg_match('/\d\d:\d\d:\d\d/',
                  $this-&gt;_packagexml-&gt;getTime())) {
                $this-&gt;_addFailure('time', 'invalid release time &quot;' .
                    $this-&gt;_packagexml-&gt;getTime() . '&quot;');
                return false;
            }

            $result = preg_match('|\d{2}\:\d{2}\:\d{2}|', $this-&gt;_packagexml-&gt;getTime(), $matches);
            if ($result === false || empty($matches)) {
                $this-&gt;_addFailure('time', 'invalid release time &quot;' .
                    $this-&gt;_packagexml-&gt;getTime() . '&quot;');
                return false;
            }
        }

        return true;
    }

    /**
     * @access protected
     */
    function validateState()
    {
        // this is the closest to &quot;final&quot; php4 can get
        if (!PEAR_Validate::validState($this-&gt;_packagexml-&gt;getState())) {
            if (strtolower($this-&gt;_packagexml-&gt;getState() == 'rc')) {
                $this-&gt;_addFailure('state', 'RC is not a state, it is a version ' .
                    'postfix, use ' . $this-&gt;_packagexml-&gt;getVersion() . 'RC1, state beta');
            }
            $this-&gt;_addFailure('state', 'invalid release state &quot;' .
                $this-&gt;_packagexml-&gt;getState() . '&quot;, must be one of: ' .
                implode(', ', PEAR_Validate::getValidStates()));
            return false;
        }
        return true;
    }

    /**
     * @access protected
     */
    function validateStability()
    {
        $ret = true;
        $packagestability = $this-&gt;_packagexml-&gt;getState();
        $apistability = $this-&gt;_packagexml-&gt;getState('api');
        if (!PEAR_Validate::validState($packagestability)) {
            $this-&gt;_addFailure('state', 'invalid release stability &quot;' .
                $this-&gt;_packagexml-&gt;getState() . '&quot;, must be one of: ' .
                implode(', ', PEAR_Validate::getValidStates()));
            $ret = false;
        }
        $apistates = PEAR_Validate::getValidStates();
        array_shift($apistates); // snapshot is not allowed
        if (!in_array($apistability, $apistates)) {
            $this-&gt;_addFailure('state', 'invalid API stability &quot;' .
                $this-&gt;_packagexml-&gt;getState('api') . '&quot;, must be one of: ' .
                implode(', ', $apistates));
            $ret = false;
        }
        return $ret;
    }

    /**
     * @access protected
     */
    function validateSummary()
    {
        return true;
    }

    /**
     * @access protected
     */
    function validateDescription()
    {
        return true;
    }

    /**
     * @access protected
     */
    function validateLicense()
    {
        return true;
    }

    /**
     * @access protected
     */
    function validateNotes()
    {
        return true;
    }

    /**
     * for package.xml 2.0 only - channels can't use package.xml 1.0
     * @access protected
     */
    function validateDependencies()
    {
        return true;
    }

    /**
     * for package.xml 1.0 only
     * @access private
     */
    function _validateFilelist()
    {
        return true; // placeholder for now
    }

    /**
     * for package.xml 2.0 only
     * @access protected
     */
    function validateMainFilelist()
    {
        return true; // placeholder for now
    }

    /**
     * for package.xml 2.0 only
     * @access protected
     */
    function validateReleaseFilelist()
    {
        return true; // placeholder for now
    }

    /**
     * @access protected
     */
    function validateChangelog()
    {
        return true;
    }

    /**
     * @access protected
     */
    function validateFilelist()
    {
        return true;
    }

    /**
     * @access protected
     */
    function validateDeps()
    {
        return true;
    }
}</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fopt%2Fcpanel%2Fea-php80%2Froot%2Fusr%2Fshare%2Fpear%2FPEAR'>Back to Directory</a>