<h2>Editing File: /usr/local/lsws/add-ons/webcachemgr/src/CliController.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php

/** ******************************************
 * LiteSpeed Web Server Cache Manager
 *
 * @author Michael Alegre
 * @copyright (c) 2018-2023 LiteSpeed Technologies, Inc.
 * ******************************************* */

namespace Lsc\Wp;

use Exception;
use Lsc\Wp\Context\Context;
use Lsc\Wp\Panel\ControlPanel;
use Lsc\Wp\Panel\CPanel;

class CliController
{

    /**
     * @since 1.13.5
     * @var string
     */
    const SPECIAL_CMD_CPANEL_PLUGIN_AUTOINSTALL_OFF = 'cpanelPluginAutoInstallOff';

    /**
     * @since 1.13.5
     * @var string
     */
    const SPECIAL_CMD_CPANEL_PLUGIN_AUTOINSTALL_ON = 'cpanelPluginAutoInstallOn';

    /**
     * @since 1.13.5
     * @var string
     */
    const SPECIAL_CMD_CPANEL_PLUGIN_AUTOINSTALL_STATUS = 'cpanelPluginAutoInstallStatus';

    /**
     * @since 1.13.5
     * @var string
     */
    const SPECIAL_CMD_CPANEL_PLUGIN_FIX_CONF = 'cpanelPluginFixConf';

    /**
     * @since 1.13.5
     * @var string
     */
    const SPECIAL_CMD_CPANEL_PLUGIN_INSTALL = 'cpanelPluginInstall';

    /**
     * @since 1.13.5
     * @var string
     */
    const SPECIAL_CMD_CPANEL_PLUGIN_UNINSTALL = 'cpanelPluginUninstall';

    /**
     * @var string[]
     */
    private $cacheRootCmds = array();

    /**
     * @var string[]
     */
    private $commands = array();

    /**
     * @var string
     */
    private $svrCacheRootParam = '';

    /**
     * @var string
     */
    private $vhCacheRootParam = '';

    /**
     * @var bool
     */
    private $displayCacheRoots = false;

    /**
     * @var null|string
     */
    private $currWpPath;

    /**
     * @var null|string
     */
    private $versionCmd;

    /**
     * @var null|string
     */
    private $specialCmd;

    /**
     * Holds any additional command input for use after parseCommands().
     *
     * @var null|array
     */
    private $input;

    /**
     *
     * @throws LSCMException  Thrown when script argument count is less than
     *     expected.
     */
    public function __construct()
    {
        if ( empty($_SERVER['argv']) || $_SERVER['argc'] &lt; 3 ) {
            throw new LSCMException('Cli Illegal entrance!');
        }

        $args = $_SERVER['argv'];

        /**
         * shift out script name
         */
        array_shift($args);

        $this-&gt;parseCommands($args);
    }

    /**
     * Checks if current $wpInstallStorage object is capable of having the
     * given non-scan action performed.
     *
     * @param string           $action
     * @param WPInstallStorage $wpInstallStorage
     *
     * @return void
     *
     * @throws LSCMException  Thrown when scan data cannot be read.
     * @throws LSCMException  Thrown when expected scan data format has changed.
     * @throws LSCMException  Thrown when attempting to execute a &quot;mass&quot;
     *     operation without any discovered installations.
     */
    private function checkDataFile(
                         $action,
        WPInstallStorage $wpInstallStorage )
    {
        if ( $action == WPInstallStorage::CMD_SCAN2 ) {

            /**
             * Always allowed.
             */
            return;
        }

        if ( ($err = $wpInstallStorage-&gt;getError()) ) {

            switch ($err) {

                case WPInstallStorage::ERR_NOT_EXIST:
                case WPInstallStorage::ERR_CORRUPTED:
                case WPInstallStorage::ERR_VERSION_HIGH:
                    throw new LSCMException(
                        'Scan data could not be read! Please scan again '
                            . '(without the \'-n\' flag) before attempting any '
                            . &quot;cache operations.\n&quot;
                    );

                case WPInstallStorage::ERR_VERSION_LOW:
                    throw new LSCMException(
                        'Scan data file format has been changed for this '
                            . 'version. Please scan again (without the \'-n\' '
                            . &quot;flag) before attempting any cache operations.\n&quot;
                    );

                //no default
            }
        }
        elseif ( strpos($action,'mass_') === 0
                &amp;&amp; $wpInstallStorage-&gt;getCount() == 0 ) {

            throw new LSCMException(
                'No WordPress installations discovered in the previous scan. '
                    . 'If you have any newly installed WordPress '
                    . 'installations, please scan again or add them with '
                    . &quot;command 'addinstalls'.\n&quot;
            );
        }
    }

    /**
     *
     * @param WPInstall $wpInstall
     */
    private function printStatusMsg( WPInstall $wpInstall )
    {
        $msg = &quot;$this-&gt;currWpPath - Status: &quot;;

        $status = $wpInstall-&gt;getStatus();

        if ( $status &amp; WPInstall::ST_PLUGIN_ACTIVE ) {
            $msg .= 'enabled';

            if ( !$status &amp; WPInstall::ST_LSC_ADVCACHE_DEFINED ) {
                $msg .= ', not caching';
            }
        }
        else {
            $msg .= 'disabled';
        }

        $msg .= ' | Flagged: ';
        $msg .= ($status &amp; WPInstall::ST_FLAGGED) ? 'yes' : 'no';

        $msg .= ' | Error: ';

        if ( $status &amp; WPInstall::ST_ERR_SITEURL ) {
            $msg .= 'Could not retrieve WordPress siteURL.';
        }
        elseif ( $status &amp; WPInstall::ST_ERR_DOCROOT ) {
            $msg .= 'Could not match WordPress siteURL to a known control '
                . 'panel docroot.';
        }
        elseif ( $status &amp; WPInstall::ST_ERR_EXECMD ) {
            $msg .= 'WordPress fatal error encountered during action '
                . 'execution. This is most likely caused by custom code in '
                . 'this WordPress installation.';
        }
        elseif ( $status &amp; WPInstall::ST_ERR_EXECMD_DB ) {
            $msg .= 'Error establishing WordPress database connection.';
        }
        elseif ( $status &amp; WPInstall::ST_ERR_TIMEOUT ) {
            $msg .= 'Timeout occurred during action execution.';
        }
        elseif ( $status &amp; WPInstall::ST_ERR_WPCONFIG ) {
            $msg .= 'Could not find a valid wp-config.php file.';
        }

        echo &quot;$msg\n\n&quot;;
    }

    /**
     *
     * @param string[] $args
     *
     * @return void
     *
     * @throws LSCMException  Thrown when -svr parameter is passed without a
     *     value.
     * @throws LSCMException  Thrown when -svr parameter value points to a
     *     non-empty directory.
     * @throws LSCMException  Thrown when -vh parameter is passed without a
     *     value.
     * @throws LSCMException  Thrown when -vh parameter value contains invalid
     *     character '$'.
     * @throws LSCMException  Thrown when -vh parameter value points to a
     *     non-empty directory.
     * @throws LSCMException  Thrown indirectly by
     *     ControlPanel::getClassInstance() call.
     * @throws LSCMException  Thrown indirectly by
     *     $controlPanel-&gt;getServerCacheRoot() call.
     * @throws LSCMException  Thrown indirectly by
     *     $controlPanel-&gt;getVHCacheRoot() call.
     */
    private function handleSetCacheRootInput( array &amp;$args )
    {
        if ( empty($args) ) {
            $this-&gt;cacheRootCmds[] = 'listCacheRoots';
            return;
        }

        $controlPanel = ControlPanel::getClassInstance();

        if ( ($key = array_search('-svr', $args)) !== false ) {

            if ( empty($args[$key + 1])
                    || ($this-&gt;svrCacheRootParam = trim($args[$key + 1])) == '' ) {

                throw new LSCMException(
                    'Invalid Command, missing server cache root value.'
                );
            }

            if ( !Util::isSafeAbsPath($this-&gt;svrCacheRootParam) ) {
                throw new LSCMException(
                    'Invalid Command, server cache root must be an absolute path '
                        . 'containing only [A-Za-z0-9_./-] characters and no '
                        . '\'..\' segments.'
                );
            }

            $currSvrCacheRoot = $controlPanel-&gt;getServerCacheRoot();

            if ( $this-&gt;svrCacheRootParam != $currSvrCacheRoot ) {

                if ( !Util::is_dir_empty($this-&gt;svrCacheRootParam) ) {
                    throw new LSCMException(
                        'Provided server level cache root must be an empty '
                            . 'directory.'
                    );
                }

                $this-&gt;cacheRootCmds[] = 'setSvrCacheRoot';
            }

            unset($args[$key], $args[$key + 1]);
        }

        if ( ($key = array_search('-vh', $args)) !== false ) {
            $setvhCacheRoot = false;

            if ( empty($args[$key + 1])
                    || ($this-&gt;vhCacheRootParam = trim($args[$key + 1])) == '' ) {

                throw new LSCMException(
                    'Invalid Command, missing virtual host cache root value.'
                );
            }

            if ( strpos($this-&gt;vhCacheRootParam, '$') !== false ) {
                throw new LSCMException(
                    'Invalid Command, virtual host cache root value cannot '
                        . 'contain any \'$\' characters. \'$vh_user\' will be '
                        . 'automatically added to the end of virtual host '
                        . 'cache root values starting with a \'/\'.'
                );
            }

            if ( $this-&gt;vhCacheRootParam[0] === '/' ) {
                if ( !Util::isSafeAbsPath($this-&gt;vhCacheRootParam) ) {
                    throw new LSCMException(
                        'Invalid Command, absolute virtual host cache root must '
                            . 'contain only [A-Za-z0-9_./-] characters and no '
                            . '\'..\' segments.'
                    );
                }
            }
            elseif ( !preg_match('#^[A-Za-z0-9_\-]+$#', $this-&gt;vhCacheRootParam) ) {
                throw new LSCMException(
                    'Invalid Command, non-absolute virtual host cache root must '
                        . 'contain only [A-Za-z0-9_-] characters.'
                );
            }

            $currVHCacheRoot = $controlPanel-&gt;getVHCacheRoot();

            if ( $this-&gt;vhCacheRootParam[0] === '/' ) {
                $updatedVhCacheRoot =
                    rtrim($this-&gt;vhCacheRootParam, '/') . '/$vh_user';

                if ( $updatedVhCacheRoot != $currVHCacheRoot
                        &amp;&amp; ! Util::is_dir_empty($this-&gt;vhCacheRootParam) ) {

                    throw new LSCMException(
                        'Provided absolute path for virtual host level cache '
                            . 'root must be an empty directory.'
                    );
                }

                $this-&gt;vhCacheRootParam = $updatedVhCacheRoot;
                $setvhCacheRoot = true;
            }
            elseif ( $this-&gt;vhCacheRootParam != $currVHCacheRoot ) {
                $setvhCacheRoot = true;
            }

            unset($args[$key], $args[$key + 1]);

            if ( $setvhCacheRoot ) {
                $this-&gt;cacheRootCmds[] = 'setVHCacheRoot';
            }
        }
    }

    /**
     *
     * @param string[] $args
     *
     * @return void
     *
     * @throws LSCMException  Thrown when passed version set value is invalid.
     */
    private function handleSetVersionInput( array &amp;$args )
    {
        if ( ($key = array_search('--list', $args)) !== false ) {
            unset($args[$key]);
            $this-&gt;versionCmd = 'list';
            return;
        }

        if ( ($key = array_search('--latest', $args)) !== false ) {
            unset($args[$key]);
            $this-&gt;versionCmd = 'latest';
            return;
        }

        if ( empty($args) ) {
            $this-&gt;versionCmd = 'active';
            return;
        }

        $v = array_shift($args);

        if ( preg_match('/[1-9]\.\d(?:\.\d)*(?:\.\d)*/', $v) !== 1 ) {
            throw new LSCMException(&quot;Invalid version number ($v).&quot;);
        }

        $this-&gt;versionCmd = $v;
    }

    /**
     *
     * @param string[] $args
     */
    private function handleScanInput( array &amp;$args )
    {
        if ( ($key = array_search('-n', $args)) !== false ) {
            unset($args[$key]);
            $this-&gt;commands[] = WPInstallStorage::CMD_DISCOVER_NEW2;
        }
        else {
            $this-&gt;commands[] = WPInstallStorage::CMD_SCAN2;
        }

        if ( ($key = array_search('-e', $args)) !== false ) {
            unset($args[$key]);
            $this-&gt;commands[] = UserCommand::CMD_MASS_ENABLE;
        }
    }

    /**
     *
     * @param string[] $args
     */
    private function handleScanNewInput( array &amp;$args )
    {
        if ( ($key = array_search('-en', $args)) !== false ) {
            unset($args[$key]);
            $this-&gt;commands[] = WPInstallStorage::CMD_DISCOVER_NEW_AND_ENABLE;
        }
        else {
            $this-&gt;commands[] = WPInstallStorage::CMD_DISCOVER_NEW2;
        }
    }

    /**
     *
     * @param string[] $args
     *
     * @return bool
     */
    private function isMassOperation( array &amp;$args )
    {
        if ( ($key = array_search('-m', $args)) !== false ) {
            unset($args[$key]);
            return true;
        }

        return false;
    }

    /**
     *
     * @param string   $cmd
     * @param string[] $args
     *
     * @throws LSCMException  Thrown when expected WP path value is not
     *     provided.
     * @throws LSCMException  Thrown when provided an invalid WP path value.
     */
    private function handleSingleOperationInput( $cmd, array &amp;$args )
    {
        $path = array_shift($args);

        if ( $path == null ) {
            throw new LSCMException('Invalid Command, missing WP path.');
        }

        $wpInstall = new WPInstall($path);

        if ( !$wpInstall-&gt;hasValidPath() ) {
            throw new LSCMException(&quot;Invalid WP Path: $path.&quot;);
        }

        $this-&gt;commands[] = $cmd;
        $this-&gt;currWpPath = rtrim($path, '/');
    }

    /**
     *
     * @param string   $cmdType
     * @param string[] $args
     *
     * @throws LSCMException  Thrown when neither -m nor -wppath parameters are
     *     provided in notify command.
     * @throws LSCMException  Thrown when -wppath parameter is passed without a
     *     value in notify command.
     * @throws LSCMException  Thrown when provided -wppath parameter value is
     *     invalid in notify command.
     * @throws LSCMException  Thrown when -msgfile parameter is passed without a
     *     value in notify command.
     * @throws LSCMException  Thrown when provided -msgfile parameter value
     *     points to a non-existent file in notify command.
     * @throws LSCMException  Thrown when unable to get file contents of the
     *     file pointed to by provided -msgfile value in notify command.
     * @throws LSCMException  Thrown when neither -msgfile nor -msg parameters
     *     are provided in notify command.
     * @throws LSCMException  Thrown when parameter -msg is passed without a
     *     value in notify command.
     * @throws LSCMException  Thrown when expected -plugin parameter is not
     *     provided in notify command.
     * @throws LSCMException  Thrown when provided -plugin parameter value does
     *     not a known plugin slug in notify command.
     * @throws LSCMException  Thrown when neither -m flag nor WP path value are
     *     provided in remove command.
     * @throws LSCMException  Thrown when provided WP path value is invalid in
     *     remove command.
     */
    private function handleDashNotifyInput( $cmdType, array &amp;$args )
    {
        if ( $cmdType == 'notify' ) {

            if ( ($key = array_search('-m', $args)) !== false ) {
                unset($args[$key]);
                $this-&gt;commands[] = UserCommand::CMD_MASS_DASH_NOTIFY;
            }
            else {

                if ( ($key = array_search('-wppath', $args)) === false ) {
                    throw new LSCMException(
                        'Invalid Command, missing required \'-m\' or '
                            . '\'-wppath\' parameter.'
                    );
                }

                if ( empty($args[$key + 1]) ) {
                    throw new LSCMException(
                        'Invalid Command, missing \'-wppath\' value.'
                    );
                }

                $path = $args[$key + 1];

                $wpInstall = new WPInstall($path);

                if ( !$wpInstall-&gt;hasValidPath() ) {
                    throw new LSCMException(&quot;Invalid WP Path: $path.&quot;);
                }

                $this-&gt;commands[] = UserCommand::CMD_DASH_NOTIFY;
                $this-&gt;currWpPath = rtrim($path, '/');

                unset($args[$key], $args[$key + 1]);
            }

            if ( ($key = array_search('-msgfile', $args)) !== false ) {

                if ( empty($args[$key + 1]) ) {
                    throw new LSCMException(
                        'Invalid Command, missing \'-msgfile\' value.'
                    );
                }

                $msgFilePath = $args[$key + 1];

                if ( !file_exists($msgFilePath) ) {
                    throw new LSCMException(
                        'Provided message file does not exist.'
                    );
                }

                if ( ($message = file_get_contents($msgFilePath)) === false ) {
                    throw new LSCMException(
                        'Unable to retrieve provided message file content.'
                    );
                }
            }
            else {

                if ( ($key = array_search('-msg', $args)) === false ) {
                    throw new LSCMException(
                        'Invalid Command, missing required \'-msgfile\' or '
                            . '\'-msg\' parameter.'
                    );
                }

                if ( empty($args[$key + 1]) ) {
                    throw new LSCMException(
                        'Invalid Command, missing \'-msg\' value.'
                    );
                }

                $message = $args[$key + 1];
            }

            $dashInput = array( 'msg' =&gt; $message );

            unset($args[$key], $args[$key + 1]);

            if ( ($key = array_search('-plugin', $args)) !== false ) {

                if ( empty($args[$key + 1]) ) {
                    throw new LSCMException(
                        'Invalid Command, missing \'-plugin\' value.'
                    );
                }

                $slug = $args[$key + 1];

                $pluginInfoJSON = Util::get_url_contents(
                    &quot;https://api.wordpress.org/plugins/info/1.0/$slug.json&quot;
                );

                $pluginInfo = json_decode($pluginInfoJSON, true);

                if ( empty($pluginInfo['name']) ) {
                    throw new LSCMException(
                        'Could not find a plugin matching the provided plugin '
                            . 'slug.'
                    );
                }

                $dashInput['slug'] = $slug;

                unset($args[$key], $args[$key + 1]);
            }

            $this-&gt;input = $dashInput;
        }
        elseif ( $cmdType == 'remove' ) {
            $arg1 = array_shift($args);

            if ( $arg1 == '-m' ) {
                $this-&gt;commands[] = UserCommand::CMD_MASS_DASH_DISABLE;
            }
            else {
                $path = $arg1;

                if ( $path == null ) {
                    throw new LSCMException(
                        'Invalid Command, missing \'-m\' flag or WP path value.'
                    );
                }

                $wpInstall = new WPInstall($path);

                if ( !$wpInstall-&gt;hasValidPath() ) {
                    throw new LSCMException(&quot;Invalid WP Path: $path.&quot;);
                }

                $this-&gt;commands[] = UserCommand::CMD_DASH_DISABLE;
                $this-&gt;currWpPath = rtrim($path, '/');
            }
        }
    }

    /**
     *
     * @param string[] $args
     *
     * @throws LSCMException  Thrown when command 'cpanelplugin' is used in a
     *     non-cPanel environment.
     * @throws LSCMException  Thrown indirectly by
     *     ControlPanel::getClassInstance() call.
     */
    private function handleCpanelPluginInput( array &amp;$args )
    {
        $controlPanel = ControlPanel::getClassInstance();

        if ( !($controlPanel instanceof CPanel) ) {
            throw new LSCMException(
                'Command \'cpanelplugin\' cannot be used in a non-cPanel '
                    . 'environment.'
            );
        }

        switch ($args[0]) {

            case '--install':
                $this-&gt;specialCmd = self::SPECIAL_CMD_CPANEL_PLUGIN_INSTALL;
                unset($args[0]);
                break;

            case '--uninstall':
                $this-&gt;specialCmd = self::SPECIAL_CMD_CPANEL_PLUGIN_UNINSTALL;
                unset($args[0]);
                break;

            case '-autoinstall':

                if ( !isset($args[1]) ) {
                    $this-&gt;specialCmd =
                        self::SPECIAL_CMD_CPANEL_PLUGIN_AUTOINSTALL_STATUS;
                }
                elseif ( &quot;$args[1]&quot; === '1' ) {
                    $this-&gt;specialCmd =
                        self::SPECIAL_CMD_CPANEL_PLUGIN_AUTOINSTALL_ON;
                    unset($args[1]);
                }
                elseif ( &quot;$args[1]&quot; === '0' ) {
                    $this-&gt;specialCmd =
                        self::SPECIAL_CMD_CPANEL_PLUGIN_AUTOINSTALL_OFF;
                    unset($args[1]);
                }

                unset($args[0]);
                break;

            case '--fixconf':
                $this-&gt;specialCmd = self::SPECIAL_CMD_CPANEL_PLUGIN_FIX_CONF;
                unset($args[0]);
                break;

            //no default
        }
    }

    /**
     *
     * @param string[] $args
     *
     * @throws LSCMException  Thrown when -wpinstall parameter is passed without
     *     a value.
     * @throws LSCMException  Thrown when expected 'docroot' value is not
     *     provided when using parameter -wpinstall.
     * @throws LSCMException  Thrown when expected 'server name' value is not
     *     provided when using parameter -wpinstall.
     * @throws LSCMException  Thrown when expected 'site url' value is not
     *     provided when using parameter -wpinstall.
     * @throws LSCMException  Thrown when -wpinstallsfile parameter is passed
     *     without a value.
     * @throws LSCMException  Thrown when provided -wpinstallsfile parameter
     *     value points to a non-existent file.
     * @throws LSCMException  Thrown when unable to get file contents of the
     *     file pointed to by provided -wpinstallsfile parameter value.
     */
    private function handleAddInstallsInput( array &amp;$args )
    {
        switch ($args[0]) {

            case '-wpinstall':

                if ( empty($args[1]) ) {
                    throw new LSCMException(
                        'Invalid Command, missing \'&lt;wp path&gt;\' value.'
                    );
                }

                $wpInstallsInfo = &quot;$args[1]&quot;;

                if ( empty($args[2]) ) {
                    throw new LSCMException(
                        'Invalid Command, missing \'&lt;docroot&gt;\' value.'
                    );
                }

                $wpInstallsInfo .= &quot; $args[2]&quot;;

                if ( empty($args[3]) ) {
                    throw new LSCMException(
                        'Invalid Command, missing \'&lt;server name&gt;\' value.'
                    );
                }

                $wpInstallsInfo .= &quot; $args[3]&quot;;

                if ( empty($args[4]) ) {
                    throw new LSCMException(
                        'Invalid Command, missing \'&lt;site url&gt;\' value.'
                    );
                }

                $wpInstallsInfo .= &quot; $args[4]&quot;;

                $this-&gt;commands[] = WPInstallStorage::CMD_ADD_CUST_WPINSTALLS;

                $this-&gt;input =
                    array( 'addInstallsInfo' =&gt; array($wpInstallsInfo) );

                unset($args[0], $args[1], $args[2], $args[3], $args[4]);
                break;

            case '-wpinstallsfile':

                if ( empty($args[1]) ) {
                    throw new LSCMException(
                        'Invalid Command, missing \'-wpinstallsfile\' value.'
                    );
                }

                $wpInstallsFile = $args[1];

                if ( !file_exists($wpInstallsFile) ) {
                    throw new LSCMException(
                        'Provided wpinstalls file does not exist.'
                    );
                }

                $fileContent = file_get_contents($wpInstallsFile);

                if ( $fileContent === false ) {
                    throw new LSCMException(
                        'Could not read wpinstalls file content.'
                    );
                }

                $this-&gt;commands[] = WPInstallStorage::CMD_ADD_CUST_WPINSTALLS;

                $this-&gt;input = array(
                    'addInstallsInfo' =&gt; explode(&quot;\n&quot;, trim($fileContent))
                );

                unset($args[0], $args[1]);
                break;

            // no default
        }
    }

    /**
     *
     * @throws LSCMException  Thrown indirectly by
     *     ControlPanel::getClassInstance() call.
     * @throws LSCMException  Thrown indirectly by
     *     $controlPanel-&gt;getServerCacheRoot() call.
     * @throws LSCMException  Thrown indirectly by
     *     $controlPanel-&gt;getVHCacheRoot() call.
     */
    private function displayCacheRoots()
    {
       $controlPanel = ControlPanel::getClassInstance();

       $svrCacheRoot = $controlPanel-&gt;getServerCacheRoot();
       $vhCacheRoot = $controlPanel-&gt;getVHCacheRoot();

       if ( $svrCacheRoot == ControlPanel::NOT_SET ) {
           $svrCacheRoot = 'Not Set';
       }

       if ( $vhCacheRoot == ControlPanel::NOT_SET) {
           $vhCacheRoot = 'Not Set';
       }

       echo &lt;&lt;&lt;EOF

Server Cache Root:        $svrCacheRoot
Virtual Host Cache Root:  $vhCacheRoot


EOF;
    }

    /**
     *
     * @param string[] $args
     *
     * @throws LSCMException  Thrown when command setcacheroot is used in the
     *     CustomPanel context.
     * @throws LSCMException  Thrown when an unrecognized command is provided.
     * @throws LSCMException  Thrown when not all provided command arguments are
     *     recognized or used when provided with a valid command.
     * @throws LSCMException  Thrown indirectly by
     *     ControlPanel::getClassInstance() call.
     * @throws LSCMException  Thrown indirectly by
     *     $this-&gt;handleSetCacheRootInput() call.
     * @throws LSCMException  Thrown indirectly by
     *     $this-&gt;handleSetVersionInput() call.
     * @throws LSCMException  Thrown indirectly by
     *     $this-&gt;handleSingleOperationInput() call.
     * @throws LSCMException  Thrown indirectly by
     *     $this-&gt;handleDashNotifyInput() call.
     * @throws LSCMException  Thrown indirectly by
     *     $this-&gt;handleDashNotifyInput() call.
     * @throws LSCMException  Thrown indirectly by
     *     $this-&gt;handleCpanelPluginInput() call.
     * @throws LSCMException  Thrown indirectly by
     *     $this-&gt;handleAddInstallsInput() call.
     */
    private function parseCommands( array $args )
    {
        $panelClassName = array_shift($args);

        /**
         * Initialize ControlPanel instance.
         */
        ControlPanel::getClassInstance($panelClassName);

        $cmd = array_shift($args);

        switch ( $cmd ) {

            case 'setcacheroot':

                if ( $panelClassName == 'custom' ) {
                    throw new LSCMException(
                        'Command \'setcacheroot\' cannot be used in the '
                            . 'CustomPanel context.'
                    );
                }

                $this-&gt;handleSetCacheRootInput($args);
                break;

            case 'setversion':
                $this-&gt;handleSetVersionInput($args);
                break;

            case 'scan':
                $this-&gt;handleScanInput($args);
                break;

            case 'scannew':
                $this-&gt;handleScanNewInput($args);
                break;

            case 'enable':
            case 'disable':
            case 'upgrade':
            /** @noinspection PhpMissingBreakStatementInspection */
            case 'unflag':

                if ( $this-&gt;isMassOperation($args) ) {
                    $this-&gt;commands[] = &quot;mass_$cmd&quot;;
                    break;
                }

            //fall through

            case 'flag':
            case 'status':
                $this-&gt;handleSingleOperationInput($cmd, $args);
                break;

            case 'dashnotify':
                $this-&gt;handleDashNotifyInput('notify', $args);
                break;

            case 'dashnotifyremove':
                $this-&gt;handleDashNotifyInput('remove', $args);
                break;

            case 'cpanelplugin':
                $this-&gt;handleCpanelPluginInput($args);
                break;

            case 'addinstalls':
                $this-&gt;handleAddInstallsInput($args);
                break;

            default:
                throw new LSCMException('Invalid Command, Try --help.');
        }

        if ( !empty($args) ) {
            throw new LSCMException('Invalid Command, Try --help.');
        }
    }

    /**
     *
     * @param string $action
     *
     * @throws LSCMException  Thrown indirectly by
     *     ControlPanel::getClassInstance() call.
     * @throws LSCMException  Thrown indirectly by
     *     $controlPanel-&gt;setServerCacheRoot() call.
     * @throws LSCMException  Thrown indirectly by
     *     $controlPanel-&gt;setVHCacheRoot() call.
     * @throws LSCMException  Thrown indirectly by Util::restartLsws() call.
     * @throws LSCMException  Thrown indirectly by
     *     $controlPanel-&gt;getVHCacheRoot() call.
     */
    private function doCacheRootCommand( $action )
    {
        $restartRequired = false;

        $controlPanel = ControlPanel::getClassInstance();

        switch ( $action ) {

            case 'setSvrCacheRoot':
                $controlPanel-&gt;setServerCacheRoot($this-&gt;svrCacheRootParam);
                $restartRequired = true;
                break;

            case 'setVHCacheRoot':
                $controlPanel-&gt;setVHCacheRoot($this-&gt;vhCacheRootParam);
                $restartRequired = true;
                break;

            case 'listCacheRoots':
                /**
                 * Wait until after verifyCacheSetup() has been run.
                 */
                $this-&gt;displayCacheRoots = true;
                break;

            //no default
        }

        if ( $restartRequired ) {
            Util::restartLsws();
        }

        Util::ensureVHCacheRootInCage($controlPanel-&gt;getVHCacheRoot());
    }

    /**
     *
     * @throws LSCMException  Thrown indirectly by
     *     ControlPanel::getClassInstance() call.
     * @throws LSCMException  Thrown indirectly by
     *     $controlPanel-&gt;installCpanelPlugin() call.
     * @throws LSCMException  Thrown indirectly by
     *     CPanel::uninstallCpanelPlugin() call.
     * @throws LSCMException  Thrown indirectly by
     *     $controlPanel-&gt;updateCoreCpanelPluginConfSettings() call.
     */
    private function doSpecialCommand()
    {
        $controlPanel = ControlPanel::getClassInstance();

        switch($this-&gt;specialCmd) {

            case self::SPECIAL_CMD_CPANEL_PLUGIN_INSTALL:
                /* @var $controlPanel CPanel */

                switch ( $controlPanel-&gt;installCpanelPlugin() ) {

                    case 'update':
                        echo 'Updated LiteSpeed cPanel plugin to current '
                            . &quot;version\n\n&quot;;
                        break;

                    case 'new':
                        echo 'LiteSpeed cPanel plugin installed. Auto install '
                            . &quot;policy unchanged (use 'cpanelplugin -autoinstall&quot;
                            . &quot; {0|1}' to manage).\n\n&quot;;
                        break;

                    //no default
                }

                break;

            case self::SPECIAL_CMD_CPANEL_PLUGIN_UNINSTALL:
                CPanel::uninstallCpanelPlugin();

                echo 'LiteSpeed cPanel plugin uninstalled successfully, auto '
                    . &quot;install turned off.\n\n&quot;;
                break;

            case self::SPECIAL_CMD_CPANEL_PLUGIN_AUTOINSTALL_STATUS:
                $state = (CPanel::isCpanelPluginAutoInstallOn()) ? 'On' : 'Off';

                echo &quot;Auto install is currently $state for the LiteSpeed &quot;
                    . &quot;cPanel plugin.\n&quot;;
                echo 'Note: if the plugin is already installed, it will '
                    . &quot;continue to be refreshed on WHM plugin upgrades\n&quot;
                    . 'regardless of this setting. Use \'cpanelplugin '
                    . &quot;--uninstall' to stop updates entirely.\n&quot;;
                echo 'Use command \'cpanelplugin -autoinstall {0 | 1}\' to '
                    . &quot;enable/disable fresh installation respectively.\n\n&quot;;
                break;

            case self::SPECIAL_CMD_CPANEL_PLUGIN_AUTOINSTALL_ON:

                if ( CPanel::turnOnCpanelPluginAutoInstall() ) {
                    echo 'Auto install is now On for LiteSpeed cPanel plugin.'
                        . &quot;\n\n&quot;;
                }
                else {
                    echo 'Failed to turn on auto install for LiteSpeed cPanel '
                        . &quot;plugin.\n\n&quot;;
                }

                break;

            case self::SPECIAL_CMD_CPANEL_PLUGIN_AUTOINSTALL_OFF:

                if ( CPanel::turnOffCpanelPluginAutoInstall() ) {
                    echo 'Auto install is now Off for LiteSpeed cPanel plugin.'
                        . ' (Already-installed plugin files will still be'
                        . &quot; refreshed on WHM plugin upgrades;\n&quot;
                        . &quot;use 'cpanelplugin --uninstall' to stop updates&quot;
                        . &quot; entirely.)\n\n&quot;;
                }
                else {
                    echo 'Failed to turn off auto install for LiteSpeed cPanel '
                        . &quot;plugin.\n\n&quot;;
                }

                break;

            case self::SPECIAL_CMD_CPANEL_PLUGIN_FIX_CONF:
                /* @var $controlPanel CPanel */
                $controlPanel-&gt;updateCoreCpanelPluginConfSettings();

                echo &quot;Attempted to fix user-end cPanel Plugin conf.\n\n&quot;;
                break;

            //no default
        }
    }

    /**
     *
     * @throws LSCMException  Thrown indirectly by PluginVersion::getInstance()
     *     call.
     * @throws LSCMException  Thrown indirectly by
     *     $pluginVerInstance-&gt;getAllowedVersions() call.
     * @throws LSCMException  Thrown indirectly by
     *     $pluginVerInstance-&gt;getLatestVersion() call.
     * @throws LSCMException  Thrown indirectly by
     *     $pluginVerInstance-&gt;setActiveVersion() call.
     * @throws LSCMException  Thrown indirectly by
     *     $pluginVerInstance-&gt;getCurrentVersion() call.
     * @throws LSCMException  Thrown indirectly by
     *     $pluginVerInstance-&gt;setActiveVersion() call.
     */
    private function doVersionCommand()
    {
        $pluginVerInstance = PluginVersion::getInstance();

        switch ( $this-&gt;versionCmd ) {

            case 'list':

                echo &quot;Available versions are: \n&quot;
                    . implode(&quot;\n&quot;,$pluginVerInstance-&gt;getAllowedVersions())
                    . &quot;\n&quot;;
                break;

            case 'latest':
                $latest = $pluginVerInstance-&gt;getLatestVersion();

                try {
                    $currVer = $pluginVerInstance-&gt;getCurrentVersion();
                }
                catch ( LSCMException $e ) {
                    $currVer = '';
                }

                if ( $latest == $currVer ) {
                    echo &quot;Current version, $latest, is already the latest &quot;
                        . &quot;version.\n&quot;;
                }
                else {
                    $pluginVerInstance-&gt;setActiveVersion($latest);
                }

                break;

            case 'active':

                echo &quot;Current active version is &quot;
                    . $pluginVerInstance-&gt;getCurrentVersion()
                    .  &quot;.\n&quot;;
                break;

            default:
                $pluginVerInstance-&gt;setActiveVersion($this-&gt;versionCmd);
        }
    }

    /**
     *
     * @throws LSCMException  Thrown indirectly by Context::getLSCMDataFiles()
     *     call.
     * @throws LSCMException  Thrown indirectly by &quot;new WPInstallStorage()&quot;
     *     call.
     * @throws LSCMException  Thrown indirectly by $this-&gt;checkDataFile() call.
     * @throws LSCMException  Thrown indirectly by PluginVersion::getInstance()
     *     call.
     * @throws LSCMException  Thrown indirectly by
     *     $pluginVerInstance-&gt;getShortVersions() call.
     * @throws LSCMException  Thrown indirectly by
     *     $pluginVerInstance-&gt;getCurrentVersion() call.
     * @throws LSCMException  Thrown indirectly by
     *     DashNotifier::prepLocalDashPluginFiles() call.
     * @throws LSCMException  Thrown indirectly by
     *     ControlPanel::getClassInstance() call.
     * @throws LSCMException  Thrown indirectly by
     *     ControlPanel::getClassInstance()-&gt;getDocRoots() call.
     * @throws LSCMException  Thrown indirectly by $wpInstallStorage-&gt;scan2()
     *     call.
     * @throws LSCMException  Thrown indirectly by $wpInstallStorage-&gt;doAction()
     *     call.
     */
    private function doWPInstallStorageAction()
    {
        $extraArgs = array();
        $list = null;
        $originalAction = null;

        $lscmDataFiles = Context::getLSCMDataFiles();

        $wpInstallStorage = new WPInstallStorage(
            $lscmDataFiles['dataFile'],
            $lscmDataFiles['custDataFile']
        );

        if ( $this-&gt;currWpPath ) {
            $list = array( $this-&gt;currWpPath );
        }

        foreach ( $this-&gt;commands as $action ) {
            $this-&gt;checkDataFile($action, $wpInstallStorage);

            echo &quot;\nPerforming $action operation. Please be patient...\n\n&quot;;

            switch ( $action ) {

                case UserCommand::CMD_UPGRADE:
                case UserCommand::CMD_MASS_UPGRADE:
                    $pluginVerInstance = PluginVersion::getInstance();

                    $extraArgs[] = implode(
                        ',',
                        $pluginVerInstance-&gt;getShortVersions()
                    );
                    $extraArgs[] = $pluginVerInstance-&gt;getCurrentVersion();

                    break;

                case UserCommand::CMD_DASH_NOTIFY:
                case UserCommand::CMD_MASS_DASH_NOTIFY:
                    DashNotifier::prepLocalDashPluginFiles();

                    $slug = '';

                    if ( isset($this-&gt;input['slug']) ) {
                        $slug = $this-&gt;input['slug'];
                    }

                    $msgInfoJSON = json_encode(
                        array(
                            'msg' =&gt; $this-&gt;input['msg'],
                            'plugin' =&gt; $slug,
                            'plugin_name' =&gt; ''
                        )
                    );

                    $extraArgs[] = base64_encode($msgInfoJSON);

                    break;

                case WPInstallStorage::CMD_ADD_CUST_WPINSTALLS:
                    $list = array();
                    $extraArgs[] = $this-&gt;input['addInstallsInfo'];

                    break;

                case WPInstallStorage::CMD_SCAN2:
                case WPInstallStorage::CMD_DISCOVER_NEW2:
                case WPInstallStorage::CMD_DISCOVER_NEW_AND_ENABLE:
                    $wpPaths = array();
                    $docroots = ControlPanel::getClassInstance()-&gt;getDocRoots();

                    foreach ( $docroots as $docroot ) {
                        $wpPaths = array_merge(
                            $wpPaths,
                            WPInstallStorage::scan2($docroot)
                        );
                    }

                    $list = array();

                    if ( $action == WPInstallStorage::CMD_DISCOVER_NEW2
                            || $action == WPInstallStorage::CMD_DISCOVER_NEW_AND_ENABLE ) {

                        foreach( $wpPaths as $wpPath ) {

                            if ( $wpInstallStorage-&gt;getWPInstall($wpPath) == null ) {
                                $list[] = $wpPath;
                            }
                        }
                    }
                    else {
                        $list = array_merge($list, $wpPaths);
                    }

                    $originalAction = $action;
                    $action = WPInstallStorage::CMD_ADD_NEW_WPINSTALL;

                    break;

                // no default case
            }

            $wpInstallStorage-&gt;doAction($action, $list, $extraArgs);

            if ( $originalAction == WPInstallStorage::CMD_DISCOVER_NEW_AND_ENABLE ) {
                $wpInstallStorage-&gt;doAction(
                    UserCommand::CMD_MASS_ENABLE,
                    $list
                );
            }

            if ( $action == UserCommand::CMD_STATUS ) {
                $wpInstall = $wpInstallStorage-&gt;getWPInstall($this-&gt;currWpPath);

                $this-&gt;printStatusMsg($wpInstall);
            }

            if ( $originalAction != null ) {
                $action = $originalAction;
            }

            echo &quot;\n$action complete!\n\n&quot;;
        }
    }

    /**
     *
     * @throws LSCMException  Thrown indirectly by $this-&gt;doCacheRootCommand()
     *     call.
     * @throws LSCMException  Thrown indirectly by
     *     ControlPanel::getClassInstance() call.
     * @throws LSCMException  Thrown indirectly by
     *     $controlPanel-&gt;verifyCacheSetup() call.
     * @throws LSCMException  Thrown indirectly by $this-&gt;displayCacheRoots()
     *     call.
     * @throws LSCMException  Thrown indirectly by $this-&gt;doSpecialCommand()
     *     call.
     * @throws LSCMException  Thrown indirectly by $this-&gt;doVersionCommand()
     *     call.
     * @throws LSCMException  Thrown indirectly by
     *     $this-&gt;doWPInstallStorageAction() call.
     */
    private function runCommand()
    {
        foreach ( $this-&gt;cacheRootCmds as $action ) {
            $this-&gt;doCacheRootCommand($action);
        }

        $controlPanel = ControlPanel::getClassInstance();
        $controlPanel-&gt;verifyCacheSetup();

        if ( $this-&gt;displayCacheRoots ) {
            $this-&gt;displayCacheRoots();
        }

        if ( $this-&gt;specialCmd ) {
            $this-&gt;doSpecialCommand();
        }
        elseif ( $this-&gt;versionCmd ) {
            $this-&gt;doVersionCommand();
        }
        else {
            $this-&gt;doWPInstallStorageAction();
        }
    }

    public static function run()
    {
        try {
            $cli = new self();
            $cli-&gt;runCommand();
        }
        catch ( Exception $e ) {
            echo &quot;[ERROR] {$e-&gt;getMessage()}\n\n&quot;;
            exit(1);
        }
    }

}
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flocal%2Flsws%2Fadd-ons%2Fwebcachemgr%2Fsrc'>Back to Directory</a>