<h2>Editing File: /usr/local/cpanel/3rdparty/php/84/lib/php/PEAR/Task/Postinstallscript.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php
/**
 * &lt;tasks:postinstallscript&gt;
 *
 * 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
 */
/**
 * Base class
 */
require_once 'PEAR/Task/Common.php';
/**
 * Implements the postinstallscript file task.
 *
 * Note that post-install scripts are handled separately from installation, by the
 * &quot;pear run-scripts&quot; command
 *
 * @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_Task_Postinstallscript extends PEAR_Task_Common
{
    public $type = 'script';
    public $_class;
    public $_params;
    public $_obj;
    /**
     *
     * @var PEAR_PackageFile_v2
     */
    public $_pkg;
    public $_contents;
    public $phase = PEAR_TASK_INSTALL;

    /**
     * Validate the raw xml at parsing-time.
     *
     * This also attempts to validate the script to make sure it meets the criteria
     * for a post-install script
     *
     * @param  PEAR_PackageFile_v2
     * @param  array The XML contents of the &lt;postinstallscript&gt; tag
     * @param  PEAR_Config
     * @param  array the entire parsed &lt;file&gt; tag
     */
    public static function validateXml($pkg, $xml, $config, $fileXml)
    {
        if ($fileXml['role'] != 'php') {
            return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
            $fileXml['name'].'&quot; must be role=&quot;php&quot;', );
        }
        PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
        $file = $pkg-&gt;getFileContents($fileXml['name']);
        if (PEAR::isError($file)) {
            PEAR::popErrorHandling();

            return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                $fileXml['name'].'&quot; is not valid: '.
                $file-&gt;getMessage(), );
        } elseif ($file === null) {
            return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                $fileXml['name'].'&quot; could not be retrieved for processing!', );
        } else {
            $analysis = $pkg-&gt;analyzeSourceCode($file, true);
            if (!$analysis) {
                PEAR::popErrorHandling();
                $warnings = '';
                foreach ($pkg-&gt;getValidationWarnings() as $warn) {
                    $warnings .= $warn['message'].&quot;\n&quot;;
                }

                return array(PEAR_TASK_ERROR_INVALID, 'Analysis of post-install script &quot;'.
                    $fileXml['name'].'&quot; failed: '.$warnings, );
            }
            if (count($analysis['declared_classes']) != 1) {
                PEAR::popErrorHandling();

                return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                    $fileXml['name'].'&quot; must declare exactly 1 class', );
            }
            $class = $analysis['declared_classes'][0];
            if ($class != str_replace(
                array('/', '.php'), array('_', ''),
                $fileXml['name']
            ).'_postinstall') {
                PEAR::popErrorHandling();

                return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                    $fileXml['name'].'&quot; class &quot;'.$class.'&quot; must be named &quot;'.
                    str_replace(
                        array('/', '.php'), array('_', ''),
                        $fileXml['name']
                    ).'_postinstall&quot;', );
            }
            if (!isset($analysis['declared_methods'][$class])) {
                PEAR::popErrorHandling();

                return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                    $fileXml['name'].'&quot; must declare methods init() and run()', );
            }
            $methods = array('init' =&gt; 0, 'run' =&gt; 1);
            foreach ($analysis['declared_methods'][$class] as $method) {
                if (isset($methods[$method])) {
                    unset($methods[$method]);
                }
            }
            if (count($methods)) {
                PEAR::popErrorHandling();

                return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                    $fileXml['name'].'&quot; must declare methods init() and run()', );
            }
        }
        PEAR::popErrorHandling();
        $definedparams = array();
        $tasksNamespace = $pkg-&gt;getTasksNs().':';
        if (!isset($xml[$tasksNamespace.'paramgroup']) &amp;&amp; isset($xml['paramgroup'])) {
            // in order to support the older betas, which did not expect internal tags
            // to also use the namespace
            $tasksNamespace = '';
        }
        if (isset($xml[$tasksNamespace.'paramgroup'])) {
            $params = $xml[$tasksNamespace.'paramgroup'];
            if (!is_array($params) || !isset($params[0])) {
                $params = array($params);
            }
            foreach ($params as $param) {
                if (!isset($param[$tasksNamespace.'id'])) {
                    return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                        $fileXml['name'].'&quot; &lt;paramgroup&gt; must have '.
                        'an '.$tasksNamespace.'id&gt; tag', );
                }
                if (isset($param[$tasksNamespace.'name'])) {
                    if (!in_array($param[$tasksNamespace.'name'], $definedparams)) {
                        return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                            $fileXml['name'].'&quot; '.$tasksNamespace.
                            'paramgroup&gt; id &quot;'.$param[$tasksNamespace.'id'].
                            '&quot; parameter &quot;'.$param[$tasksNamespace.'name'].
                            '&quot; has not been previously defined', );
                    }
                    if (!isset($param[$tasksNamespace.'conditiontype'])) {
                        return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                            $fileXml['name'].'&quot; '.$tasksNamespace.
                            'paramgroup&gt; id &quot;'.$param[$tasksNamespace.'id'].
                            '&quot; must have a '.$tasksNamespace.
                            'conditiontype&gt; tag containing either &quot;=&quot;, '.
                            '&quot;!=&quot;, or &quot;preg_match&quot;', );
                    }
                    if (!in_array(
                        $param[$tasksNamespace.'conditiontype'],
                        array('=', '!=', 'preg_match')
                    )) {
                        return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                            $fileXml['name'].'&quot; '.$tasksNamespace.
                            'paramgroup&gt; id &quot;'.$param[$tasksNamespace.'id'].
                            '&quot; must have a '.$tasksNamespace.
                            'conditiontype&gt; tag containing either &quot;=&quot;, '.
                            '&quot;!=&quot;, or &quot;preg_match&quot;', );
                    }
                    if (!isset($param[$tasksNamespace.'value'])) {
                        return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                            $fileXml['name'].'&quot; '.$tasksNamespace.
                            'paramgroup&gt; id &quot;'.$param[$tasksNamespace.'id'].
                            '&quot; must have a '.$tasksNamespace.
                            'value&gt; tag containing expected parameter value', );
                    }
                }
                if (isset($param[$tasksNamespace.'instructions'])) {
                    if (!is_string($param[$tasksNamespace.'instructions'])) {
                        return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                            $fileXml['name'].'&quot; '.$tasksNamespace.
                            'paramgroup&gt; id &quot;'.$param[$tasksNamespace.'id'].
                            '&quot; '.$tasksNamespace.'instructions&gt; must be simple text', );
                    }
                }
                if (!isset($param[$tasksNamespace.'param'])) {
                    continue; // &lt;param&gt; is no longer required
                }
                $subparams = $param[$tasksNamespace.'param'];
                if (!is_array($subparams) || !isset($subparams[0])) {
                    $subparams = array($subparams);
                }
                foreach ($subparams as $subparam) {
                    if (!isset($subparam[$tasksNamespace.'name'])) {
                        return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                            $fileXml['name'].'&quot; parameter for '.
                            $tasksNamespace.'paramgroup&gt; id &quot;'.
                            $param[$tasksNamespace.'id'].'&quot; must have '.
                            'a '.$tasksNamespace.'name&gt; tag', );
                    }
                    if (!preg_match(
                        '/[a-zA-Z0-9]+/',
                        $subparam[$tasksNamespace.'name']
                    )) {
                        return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                            $fileXml['name'].'&quot; parameter &quot;'.
                            $subparam[$tasksNamespace.'name'].
                            '&quot; for '.$tasksNamespace.'paramgroup&gt; id &quot;'.
                            $param[$tasksNamespace.'id'].
                            '&quot; is not a valid name.  Must contain only alphanumeric characters', );
                    }
                    if (!isset($subparam[$tasksNamespace.'prompt'])) {
                        return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                            $fileXml['name'].'&quot; parameter &quot;'.
                            $subparam[$tasksNamespace.'name'].
                            '&quot; for '.$tasksNamespace.'paramgroup&gt; id &quot;'.
                            $param[$tasksNamespace.'id'].
                            '&quot; must have a '.$tasksNamespace.'prompt&gt; tag', );
                    }
                    if (!isset($subparam[$tasksNamespace.'type'])) {
                        return array(PEAR_TASK_ERROR_INVALID, 'Post-install script &quot;'.
                            $fileXml['name'].'&quot; parameter &quot;'.
                            $subparam[$tasksNamespace.'name'].
                            '&quot; for '.$tasksNamespace.'paramgroup&gt; id &quot;'.
                            $param[$tasksNamespace.'id'].
                            '&quot; must have a '.$tasksNamespace.'type&gt; tag', );
                    }
                    $definedparams[] = $param[$tasksNamespace.'id'].'::'.
                    $subparam[$tasksNamespace.'name'];
                }
            }
        }

        return true;
    }

    /**
     * Initialize a task instance with the parameters
     * @param array       $xml         raw, parsed xml
     * @param array       $fileattribs attributes from the &lt;file&gt; tag containing
     *                                 this task
     * @param string|null $lastversion last installed version of this package,
     *                                 if any (useful for upgrades)
     */
    public function init($xml, $fileattribs, $lastversion)
    {
        $this-&gt;_class = str_replace('/', '_', $fileattribs['name']);
        $this-&gt;_filename = $fileattribs['name'];
        $this-&gt;_class = str_replace('.php', '', $this-&gt;_class).'_postinstall';
        $this-&gt;_params = $xml;
        $this-&gt;_lastversion = $lastversion;
    }

    /**
     * Strip the tasks: namespace from internal params
     *
     * @access private
     */
    public function _stripNamespace($params = null)
    {
        if ($params === null) {
            $params = array();
            if (!is_array($this-&gt;_params)) {
                return;
            }
            foreach ($this-&gt;_params as $i =&gt; $param) {
                if (is_array($param)) {
                    $param = $this-&gt;_stripNamespace($param);
                }
                $params[str_replace($this-&gt;_pkg-&gt;getTasksNs().':', '', $i)] = $param;
            }
            $this-&gt;_params = $params;
        } else {
            $newparams = array();
            foreach ($params as $i =&gt; $param) {
                if (is_array($param)) {
                    $param = $this-&gt;_stripNamespace($param);
                }
                $newparams[str_replace($this-&gt;_pkg-&gt;getTasksNs().':', '', $i)] = $param;
            }

            return $newparams;
        }
    }

    /**
     * Unlike other tasks, the installed file name is passed in instead of the
     * file contents, because this task is handled post-installation
     *
     * @param mixed  $pkg      PEAR_PackageFile_v1|PEAR_PackageFile_v2
     * @param string $contents file name
     * @param string $dest     the eventual final file location (informational only)
     *
     * @return bool|PEAR_Error false to skip this file, PEAR_Error to fail
     *                         (use $this-&gt;throwError)
     */
    public function startSession($pkg, $contents, $dest)
    {
        if ($this-&gt;installphase != PEAR_TASK_INSTALL) {
            return false;
        }
        // remove the tasks: namespace if present
        $this-&gt;_pkg = $pkg;
        $this-&gt;_stripNamespace();
        $this-&gt;logger-&gt;log(
            0, 'Including external post-installation script &quot;'.
            $contents.'&quot; - any errors are in this script'
        );
        include_once $contents;
        if (class_exists($this-&gt;_class)) {
            $this-&gt;logger-&gt;log(0, 'Inclusion succeeded');
        } else {
            return $this-&gt;throwError(
                'init of post-install script class &quot;'.$this-&gt;_class
                .'&quot; failed'
            );
        }
        $this-&gt;_obj = new $this-&gt;_class();
        $this-&gt;logger-&gt;log(1, 'running post-install script &quot;'.$this-&gt;_class.'-&gt;init()&quot;');
        PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
        $res = $this-&gt;_obj-&gt;init($this-&gt;config, $pkg, $this-&gt;_lastversion);
        PEAR::popErrorHandling();
        if ($res) {
            $this-&gt;logger-&gt;log(0, 'init succeeded');
        } else {
            return $this-&gt;throwError(
                'init of post-install script &quot;'.$this-&gt;_class.
                '-&gt;init()&quot; failed'
            );
        }
        $this-&gt;_contents = $contents;

        return true;
    }

    /**
     * No longer used
     *
     * @see    PEAR_PackageFile_v2::runPostinstallScripts()
     * @param  array an array of tasks
     * @param  string install or upgrade
     * @access protected
     */
    public static function run($tasks)
    {
    }
}
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flocal%2Fcpanel%2F3rdparty%2Fphp%2F84%2Flib%2Fphp%2FPEAR%2FTask'>Back to Directory</a>