Da

✏️ Editing: LscntrUtil.php

<?php

/** ******************************************
 * LiteSpeed Web Server Plugin for Plesk
 *
 * @author    Robert Perper
 * @copyright 2024-2025 LiteSpeed Technologies, Inc.
 * ******************************************* */

use Modules_Litespeed_PleskEscalate as PleskEscalate;
use Modules_Litespeed_PleskExtensionException as PleskExtensionException;
use Modules_Litespeed_PleskPluginLogger as PleskPluginLogger;
use Modules_Litespeed_Util as Util;

/**
 * @since 2.0.0
 */
class Modules_Litespeed_LscntrUtil
{

/**
     * @since 2.0.0
     * @var string
     */
    public static $lscntr_userMgr_act = 'pkgList';

/**
     * @since 2.0.0
     * @var bool
     */
    private static $lsns_ok = false;

/**
     * @since 2.0.0
     * @var bool
     */
    private static $lsns_fixable = false;

/**
     * @since 2.0.0
     * @var string
     */
    private static $lsns_msg = '';

/**
     * @since 2.0.0
     * @var string
     */
    private static $lscntr_file;

/**
     * @since 2.0.0
     * @var string
     */
    private static $lsnsctl;

/**
     * @since 2.0.0
     * @var string
     */
    private static $lscgctl;

/**
     * @since 2.0.0
     * @var string
     */
    private static $lspkgctl;

/**
     * @since 2.0.0
     * @var string
     */
    private static $lscgstats;

/**
     * @since 2.0.0
     * @var string
     */
    private static $lssetup;

/**
     * @since 2.0.0
     * @var string
     */
    private static $ls_rehook_file;

/**
     * @since 2.1.1
     * @var string
     */
    private static $ls_rehook_file_install;

/**
     * @since 5.0.0
     * @var string  Default Prometheus address
     */
    private static $prometheus_addr = "http://localhost:9090";

/**
     * @since 2.0.0
     * @var string  Either most recent number of seconds or time_t:time_t
     */
    private static $time_range = "0";

/**
     * @since 2.0.0
     * @var int  Number of seconds difference from UTC to the current time.
     */
    private static $time_diff;

/**
     * @since 2.0.0
     * @var string  time_range meaning that there's no Prometheus
     */
    const TIME_RANGE_NO_PROMETHEUS = "0";

/**
     * @since 2.0.0
     * @var string  time_range meaning to use Prometheus for today's stats.
     */
    const TIME_RANGE_TODAY = "86400";

/**
     * @since 2.0.0
     * @var string  time_range meaning to use Prometheus for yesterday's
     *     stats.
     */
    const TIME_RANGE_YESTERDAY = "-1";

/**
     * @since 2.0.0
     * @var null|array[]  A JSON decoded array.
     */
    private static $uids = array();

/**
     * @since 2.0.0
     * @var array[]  A JSON decoded array (for sorting).
     */
    private static $uidsData = array();

/**
     * @since 2.0.0
     * @var array  A JSON decoded array.
     */
    private static $mounts = array();

/**
     * @since 2.0.0
     * @var array  A  domains read array.
     */
    private static $domains = array();

/**
     * @since 2.0.0
     * @var array  A packages read array.
     */
    private static $packages = array();

/**
     * @since 2.0.0
     * @var int[]|string[]  A packages read array.
     */
    private static $uid_packages = array();

/**
     * @since 2.0.0
     * @var array[] A packages read array[][]
     */
    private static $package_data = array();

/**
     * @since 2.0.0
     * @var array  A disabled_ns_uids read array.
     */
    private static $disabled_ns_uids = array();

/**
     * @since 2.0.0
     * @var array  A uid_update read array (from user).
     */
    private static $uid_update = array();

/**
     * @since 2.0.0
     * @var string[]  A uid_titles array.
     */
    private static $uid_titles = [ "cpu", "mem", "io", "iops", "tasks" ];

/**
     * @since 2.0.0
     * @var array[]  A stats read array[uid][title].
     */
    private static $stats = array();

/**
     * @since 2.0.0
     * @var array[]  read array[uid][title]
     */
    private static $stats_data = array();

/**
     * @since 2.0.0
     * @var array[]  read array[uid][title]
     */
    private static $noprom_raw_stats = array();

/**
     * @since 2.0.0
     * @var int|float|false  hrtime of last noprom_raw_stats
     */
    private static $noprom_raw_stats_time = 0;

/**
     * @since 2.0.0
     * @var int|float  microseconds since last noprom_raw_stats
     */
    private static $noprom_stats_interval = 0;

/**
     * @since 2.0.0
     * @var bool  Whether the stats could be obtained (yet)
     */
    private static $stats_ok = false;

/**
     *
     * @since 2.0.0
     *
     * @param string  $lswsHome
     *
     * @throws PleskExtensionException                Thrown indirectly by
     *     self::set_lsns_status() call.
     * @throws Zend_Db_Table_Exception                Thrown indirectly by
     *     self::set_lsns_status() call.
     * @throws Zend_Db_Table_Row_Exception            Thrown indirectly by
     *     self::set_lsns_status() call.
     * @throws pm_Exception_InvalidArgumentException  Thrown indirectly by
     *     self::set_lsns_status() call.
     */
    public static function Init( $lswsHome )
    {
        self::$lscntr_file            = "$lswsHome/lsns/conf/lscntr.txt";
        self::$lscgctl                = "$lswsHome/lsns/bin/lscgctl";
        self::$lsnsctl                = "$lswsHome/lsns/bin/lsnsctl";
        self::$lspkgctl               = "$lswsHome/lsns/bin/lspkgctl";
        self::$lscgstats              = "$lswsHome/lsns/bin/lscgstats";
        self::$lssetup                = "$lswsHome/lsns/bin/lssetup";
        self::$ls_rehook_file         = "$lswsHome/lsns/conf/lsRehook";
        self::$ls_rehook_file_install = 'lscntrRehook';

self::set_lsns_status($lswsHome);

self::$time_diff              = intval(date('Z'));
    }

/**
     * Get whether the controllers are available.
     *
     * @since 2.0.0
     * @since 2.1.1  Added required parameter $lswsHome.
     *
     * @param string $lswsHome
     *
     * @return bool  True if ok, false if a script will fix it.
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     */
    private static function getControllersOk( $lswsHome )
    {
        if ( file_exists("$lswsHome/lsns/conf/packages") ) {
            PleskPluginLogger::debug('Skip ControllersOk, because of packages');
            return true;
        }

$controllers = [
            //'cpuset' => true,
            'cpu'    => true,
            'io'     => true,
            'memory' => true,
            'pids'   => true
        ];

// Note the contents of this file can be flaky
        $filename = '/sys/fs/cgroup/cgroup.subtree_control';
        $line     = file_get_contents($filename);

if ( $line === false ) {
            PleskPluginLogger::debug("Error reading: $filename");
            return false;
        }

foreach ( explode(' ', str_replace("\n", '', $line)) as $controller ) {

if ( array_key_exists($controller, $controllers) ) {
                $controllers[$controller] = false;
            }
        }

foreach ( $controllers as $controller => $found ) {

if ( $found ) {
                PleskPluginLogger::debug("Missing controller: $controller");
                return false;
            }
        }

PleskPluginLogger::debug('ControllersOk');
        return true;
    }

/**
     * Set LiteSpeed Containers status
     *
     * @since 2.0.0
     *
     * @param string $lswsHome  What I think the home directory is.
     *
     * @throws PleskExtensionException                Thrown indirectly by
     *     self::getControllersOk() call.
     * @throws PleskExtensionException                Thrown indirectly by
     *     Util::setHooks() call.
     * @throws PleskExtensionException                Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws Zend_Db_Table_Exception                Thrown indirectly by
     *     Util::setHooks() call.
     * @throws Zend_Db_Table_Row_Exception            Thrown indirectly by
     *     Util::setHooks() call.
     * @throws pm_Exception_InvalidArgumentException  Thrown indirectly by
     *     Util::setHooks() call.
     */
    public static function set_lsns_status( $lswsHome )
    {
        self::$lsns_ok = self::$lsns_fixable = false;

if ( !is_dir($lswsHome) ) {
            self::$lsns_msg = 'LiteSpeed must be installed and active to run '
                . 'LiteSpeed Containers';
        } elseif ( !Util::getLSPID() > 0 ) {
            self::$lsns_msg =
                'LiteSpeed must be running to manage LiteSpeed Containers';
        } elseif ( file_exists('/etc/cloudlinux-release') ) {
            self::$lsns_msg = 'Not a LiteSpeed Containers capable system; '
                . 'CloudLinux and LiteSpeed Containers are incompatible';
        } elseif ( !file_exists('/sys/fs/cgroup/cgroup.controllers') ) {
            self::$lsns_msg = 'Not a LiteSpeed Containers capable system; it '
                . 'must provide a /sys/fs/cgroup/cgroup.controllers file '
                . 'indicating support for cgroups v2.  '
                . '<a href="https://docs.litespeedtech.com/lsws/cgroups/'
                . '#using-cgroups-with-litespeed-web-server">For details.</a>';
        } elseif ( !is_dir("$lswsHome/lsns") ) {
            self::$lsns_msg = 'LiteSpeed must be upgraded to run LiteSpeed '
                . 'Containers; must be v6.3 or higher';
        } elseif ( !file_exists(self::$lscntr_file) ) {
            self::$lsns_msg     = 'LiteSpeed is not configured for LiteSpeed '
                . 'Containers. Run the script below to turn on Namespaces.';
            self::$lsns_fixable = true;
        } elseif ( !self::getControllersOk($lswsHome) ) {
            self::$lsns_msg     = 'LiteSpeed Containers needs the cgroups '
                . 'controllers activated. Run the script below to activate the '
                . 'controllers on your machine.';
            self::$lsns_fixable = true;
        } else {
            Util::setHooks(
                'LSNS_HOOKS',
                self::$ls_rehook_file,
                self::$ls_rehook_file_install,
                [
                    'phys_hosting_create',
                    'phys_hosting_delete',
                    'phys_hosting_update',
                    'plesk_component_upgrade',
                    'plesk_component_install',
                    'plesk_component_uninstall'
                ],
                'lsns_validate'
            );
            self::$lsns_ok = true;
        }
        PleskPluginLogger::debug('Final lsns_msg: ' . self::$lsns_msg);
    }

/**
     * Runs the LS Containers setup script
     *
     * @since 2.0.0
     *
     * @return mixed|null  A string error, if any.
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskEscalate::escalate() call.
     */
    public static function runSetup()
    {
        return PleskEscalate::escalate(
            PleskEscalate::CMD_LSCNTR_API,
            [ 'cmdLine' => self::$lssetup ]
        );
    }

/**
     * Returns if lsns is possible on this version.
     *
     * @since 2.0.0
     *
     * @return bool
     */
    public static function ok()
    {
        return self::$lsns_ok;
    }

/**
     * Returns if lsns can be fixed with the script
     *
     * @since 2.0.0
     *
     * @return bool
     */
    public static function fixable()
    {
        return self::$lsns_fixable;
    }

/**
     * Returns a reason why lsns can't run.
     *
     * @since 2.0.0
     *
     * @return string
     */
    public static function lsns_msg()
    {
        return self::$lsns_msg;
    }

/**
     * Reads domain list into the domains array (by user).  
     * Don't call until self::$uids has been initialized.
     *
     * @since 2.0.0
     *
     * @throws PleskExtensionException  Thrown when self::$uids count is 0.
     * @throws PleskExtensionException  Thrown when an unexpected password entry
     *     is provided for a uid.
     */
    private static function read_domains()
    {
        PleskPluginLogger::debug('read_domains()');
        if (count(self::$domains) > 0) {
            return;
        }
        if (count(self::$uids) == 0)  {
            throw new PleskExtensionException(
                'You should create uids array before read_domains()'
            );
        }
        $home_prefix = '/var/www/vhosts/';
        $home_prefix_len = strlen($home_prefix);
        foreach ( array_keys(self::$uids) as $uid ) {
            $passwd = posix_getpwuid((int)$uid);
            if (!$passwd || !array_key_exists('dir', $passwd)) {
                throw new PleskExtensionException(
                    "Unexpected passwd entry for uid: $uid"
                );
            }
            if ( strpos($passwd['dir'], $home_prefix) !== 0 ) {
                continue;
            }
            self::$domains[$uid] = substr($passwd['dir'], $home_prefix_len);
            PleskPluginLogger::debug("uid: $uid has domain: " . self::$domains[$uid]);
        }
    }

/**
     *
     * @since 2.0.0
     *
     * @return void
     *
     * @throws PleskExtensionException  Thrown when no valid users are found.
     * @throws PleskExtensionException  Thrown when unable to json_decode()
     *     $output.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskEscalate::escalate() call.
     */
    private static function ValidateUids()
    {
        if ( !empty(self::$uids) ) {
            return;
        }

$output = PleskEscalate::escalate(
            PleskEscalate::CMD_LSCNTR_API,
            [ 'cmdLine' => self::$lscgctl . ' list-all -q' ]
        );

self::$uids = json_decode($output, true);

if ( self::$uids == null && json_last_error_msg() == 'No error' ) {
            throw new PleskExtensionException(
                'No valid users found in Plesk; when you create accounts you '
                    . 'can return to this screen to manage users'
            );
        }

if ( self::$uids == null || json_last_error_msg() != 'No error' ) {
            throw new PleskExtensionException(
                "json error decoding lscgctl list-all: $output: "
                    . json_last_error_msg()
            );
        }
    }

/**
     *
     * @since 2.0.0
     *
     * @param string|string[] $uids  To update.
     *
     * @return array  To execute.
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     */
    public static function LsCntrCgUpdate( $uids )
    {
        $arr = [ self::$lscgctl, '-q' ];

foreach ( self::$uid_titles as $title ) {
            $val   = Util::get_request_var($title);
            $arr[] = "--$title";

if (
                    $val != ''
                    &&
                    strcasecmp($val, '&#8734')
                    &&
                    strcasecmp($val, 'unlimited')
            ) {
                $arr[] = $val;
            } else {
                $arr[] = "-1";
            }
        }

$arr[] = "set";

if ( is_array($uids) ) {

foreach ( $uids as $uid ) {
                $arr[] = $uid;
            }
        } else {
            $arr[] = "$uids";
        }

PleskPluginLogger::debug('CgUpdate cmd: ' . implode(' ', $arr));
        return $arr;
    }

/**
     *
     * @since 2.0.0
     *
     * @param string $output  From escalate.
     *
     * @throws PleskExtensionException  Thrown when "lspkgctl list-all" output
     *     cannot be decoded.
     */
    private static function PkgsParse( $output )
    {
        $package_obj = json_decode($output, true);
        $last_error  = json_last_error_msg();

if ( $last_error != 'No error' ) {
            throw new PleskExtensionException(
                'Error decoding lspkgctl list-all output: '
                    . htmlspecialchars($output)
                    . " :$last_error"
            );
        } else if ( $package_obj == null ) {
            PleskPluginLogger::debug('pkgList gets an empty array');
        } else {
            PleskPluginLogger::debug('packages: ' . json_encode($package_obj));
            self::$packages = $package_obj["packages"];
            PleskPluginLogger::debug(
                'packages: ' . json_encode(self::$packages)
            );

foreach ( self::$packages as $name => $details ) {
                PleskPluginLogger::debug("   package: $name");

foreach ( $details['uids'] as $uid ) {
                    PleskPluginLogger::debug("      uid: $uid");
                    self::$uid_packages[$uid] = $name;
                }
            }
        }
    }

/**
     *
     * @since 2.0.0
     *
     * @return void
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskEscalate::escalate() call.
     */
    private static function ValidatePkgs()
    {
        if ( self::$packages != null && count(self::$packages) > 0 ) {
            return;
        }

PleskPluginLogger::debug('ValidatePkgs, nothing there, reacquire');
        self::PkgsParse(
            PleskEscalate::escalate(
                PleskEscalate::CMD_LSCNTR_API,
                [ 'cmdLine' => self::$lspkgctl . ' list-all -q' ]
            )
        );
    }

/**
     *
     * @return array
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidatePkgs() call.
     */
    public static function getLsCntrPackages()
    {
        self::ValidatePkgs();
        return self::$packages;
    }

/**
     *
     * @since 2.0.0
     *
     * @return array[]  package_data
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidatePkgs() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::IntMagnitude() call.
     */
    public static function getLsCntrPackageData()
    {
        if ( !empty(self::$package_data) ) {
            return self::$package_data;
        }

self::ValidatePkgs();

foreach ( self::$packages as $name => $details ) {
            self::$package_data[$name] = [];

foreach ( $details as $title => $value ) {

if ( $title == 'uids' ) {
                    self::$package_data[$name][$title] = count($value);
                } else {
                    self::$package_data[$name][$title] =
                        self::IntMagnitude($value);

switch ( self::$package_data[$name][$title] ) {

case '':
                        case 'unlimited':
                        case -1:
                            self::$package_data[$name][$title] = PHP_INT_MAX;
                            break;
                    }
                }
            }
        }

return self::$package_data;
    }

/**
     *
     * @since 2.0.0
     *
     * @param string $uids  Space separated list of UIDs to set to package
     *     defaults.
     *
     * @return array  To execute.
     *
     * @throws PleskExtensionException  Thrown when UID has no valid elements.
     * @throws PleskExtensionException  Thrown when no valid UIDs are found.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidatePkgs() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskEscalate::escalate() call.
     */
    public static function LsCntrCgDefaults( $uids )
    {
        self::ValidatePkgs();
        $uid_arr = explode(' ', $uids);

if ( count($uid_arr) == 0 ) {
            throw new PleskExtensionException(
                "UID has no valid elements: $uids"
            );
        }

$arr = [];

while ( count($uid_arr) > 0 ) {
            $uid_arr_valid = [];
            $i             = 0;
            $run_early     = false;

while ( $i < count($uid_arr) ) {
                $uid        = $uid_arr[$i];
                $rm_element = false;

if ( !array_key_exists($uid, self::$uid_packages) ) {
                    PleskPluginLogger::debug(
                        "CgDefaults skip uid: $uid for no package"
                    );
                    $rm_element = true;
                } else {

if ( count($uid_arr_valid) == 0 ) {
                        $package = self::$uid_packages[$uid];
                    }

if (
                            isset($package)
                            &&
                            $package == self::$uid_packages[$uid]
                    ) {
                        $uid_arr_valid[] = "$uid";
                        $rm_element      = true;
                        PleskPluginLogger::debug("CgDefaults consume uid $uid");
                    } else {
                        PleskPluginLogger::debug(
                            'CgDefaults skip package: '
                                . self::$uid_packages[$uid]
                                . '(for now) run early'
                        );
                        $run_early = true;
                    }
                }

if ( $rm_element ) {
                    array_splice($uid_arr, $i, 1);
                } else {
                    $i++;
                }
            }

if ( count($uid_arr_valid) != 0 ) {
                $arr = [ self::$lscgctl, "-q" ];

foreach ( self::$uid_titles as $title ) {
                    $arr[] = "--$title";

if (
                            isset($package)
                            &&
                            array_key_exists($title, self::$packages[$package])
                            &&
                            self::$packages[$package][$title] != ''
                    ) {
                        $arr[] = self::$packages[$package][$title];
                    } else {
                        $arr[] = "-1";
                    }
                }

$arr[] = 'set';
                $arr   = array_merge($arr, $uid_arr_valid);
                PleskPluginLogger::debug(
                    'CgDefaults cmd: ' . implode(' ', $arr)
                );

if ( $run_early ) {
                    PleskPluginLogger::debug(
                        'CgDefaults run early: ' . implode(' ', $arr)
                    );
                    $output = PleskEscalate::escalate(
                        PleskEscalate::CMD_LSCNTR_API, 
                        [ 'cmdLine' => implode(' ', $arr) ]
                    );
                    PleskPluginLogger::debug(
                        'cmd: '
                            . implode(' ', $arr)
                            . " output: $output"
                    );
                }
            }
        }

if ( count($arr) == 0 ) {
            throw new PleskExtensionException(
                'No valid UIDs to set to defaults'
            );
        }

return $arr;
    }

/**
     *
     * @since 2.0.0
     *
     * @param string $act
     * @param string $actId
     *
     * @throws PleskExtensionException  Thrown when "lsnsctl list-mount" output
     *     cannot be decoded.
     * @throws PleskExtensionException  Thrown when unable to decode
     *     "lsnsctl list-disabled-uids" output.
     * @throws PleskExtensionException  Thrown when no valid Plesk user is found
     *     in listUids command.
     * @throws PleskExtensionException  Thrown when lscgctl output cannot be
     *     decoded.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidateUids() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LsCntrCgUpdate() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LsCntrCgDefaults() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskEscalate::escalate() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::uiSuccess() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrUserManage() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::uiSuccess() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrUserManage() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::uiSuccess() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrUserManage() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::uiSuccess() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrUserManage() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::uiSuccess() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::uiSuccess() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrUserManage() call.
     * @throws PleskExtensionException  Thrown indirectly by self::PkgsParse()
     *     call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrUserManage() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrUserManage() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrUserManage() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrUserManage() call.
     */
    public static function LscntrUserManage( $act, $actId )
    {
        PleskPluginLogger::debug("LscntrUserManage: act: $act actId: $actId");

switch ( $act ) {

case 'cgEdit':
                self::ValidateUids();
                self::$uid_update = self::$uids[$actId];
                return;

case 'cgUpdate':
                $arr = self::LsCntrCgUpdate($actId);
                break;

case 'cgDefaults':
            case 'cgDefaultsMass':
                $arr = self::LsCntrCgDefaults($actId);
                break;

case 'listDisabled':
                $arr = [ self::$lsnsctl, 'list-disabled-uids', '-q' ];
                break;

case 'listMounts':
                $arr = [ self::$lsnsctl, 'list-mount', '-q' ];
                break;

case 'listUids':
                $arr = [ self::$lscgctl, 'list-all', '-q' ];
                break;

case 'nsEnable':
                $arr =
                    [ self::$lsnsctl, 'enable-uid', '-q', '--uid', $actId ];
                break;

case 'nsDisable':
                $arr =
                    [ self::$lsnsctl, 'disable-uid', '-q', '--uid', $actId ];
                break;

case 'nsUnmount':
                if ( $actId == 'all' ) {
                    $arr = [ self::$lsnsctl, 'unmount-all', '-q' ];
                } else {
                    $arr = [ self::$lsnsctl, 'unmount', '-q', '--uid', $actId ];
                }

break;

case 'pkgList':
            default:
                $act = 'pkgList';
                $arr = [ self::$lspkgctl, 'list-all', '-q' ];
                break;
        }

$output = PleskEscalate::escalate(
            PleskEscalate::CMD_LSCNTR_API,
            [ 'cmdLine' => implode(' ', $arr) ]
        );
        PleskPluginLogger::debug(
            'cmd: ' . implode(' ', $arr) . " output:$output"
        );

switch ( $act ) {

case 'cgUpdate':
                PleskPluginLogger::uiSuccess(
                    "Successfully updated cgroups for UID: $actId"
                );
                self::LscntrUserManage(self::$lscntr_userMgr_act, '');
                return;

case 'cgDefaults':
            case 'cgDefaultsMass':
                PleskPluginLogger::uiSuccess(
                    'Successfully set cgroups to package defaults for UID(s): '
                        . $actId
                );
                self::LscntrUserManage(self::$lscntr_userMgr_act, '');
                return;

case 'nsEnable':
                PleskPluginLogger::uiSuccess(
                    "Successfully enabled UID: $actId"
                );
                self::LscntrUserManage(self::$lscntr_userMgr_act, '');
                return;

case 'nsDisable':
                PleskPluginLogger::uiSuccess(
                    "Successfully disabled UID: $actId"
                );
                self::LscntrUserManage(self::$lscntr_userMgr_act, '');
                return;

case 'nsUnmount':
                if ( $actId == 'all' ) {
                    PleskPluginLogger::uiSuccess('Successfully unmounted all');
                } else {
                    PleskPluginLogger::uiSuccess(
                        "Successfully unmounted for UID: $actId"
                    );
                }

self::LscntrUserManage(self::$lscntr_userMgr_act, '');
                return;

case 'pkgList' :
                self::PkgsParse($output);
                self::LscntrUserManage('listMounts', '');
                return;

case 'listMounts':
                self::$mounts = json_decode($output, true);
                $last_error   = json_last_error_msg();

if ( $last_error != 'No error' ) {
                    throw new PleskExtensionException(
                        'Error decoding lsnsctl list-mount output: '
                            . htmlspecialchars($output)
                            . " :$last_error"
                    );
                } elseif ( self::$mounts == null ) {
                    PleskPluginLogger::debug('mounts gets an empty array');
                    self::$mounts = array();
                }

self::LscntrUserManage('listDisabled', '');
                return;

case 'listDisabled':
                self::$disabled_ns_uids = json_decode($output, true);
                $last_error             = json_last_error_msg();

if ( $last_error != 'No error' ) {
                    throw new PleskExtensionException(
                        'Error decoding lsnsctl list-disabled-uids output: '
                            . htmlspecialchars($output)
                            . " :$last_error"
                    );
                } elseif ( self::$disabled_ns_uids == null ) {
                    PleskPluginLogger::debug(
                        'disabled_ns_uids get an empty array'
                    );
                    self::$disabled_ns_uids = array();
                }

self::LscntrUserManage('listUids', '');
                return;

case 'listUids':
                self::$uids = json_decode($output, true);

if (
                        self::$uids == null
                        &&
                        json_last_error_msg() == 'No error'
                ) {
                    throw new PleskExtensionException(
                        'No valid users found in Plesk; when you create '
                            . 'accounts you can return to this screen to '
                            . 'manage users'
                    );
                }

if (
                    self::$uids == null
                    ||
                    json_last_error_msg() != 'No error'
                ) {
                    throw new PleskExtensionException(
                        'Error decoding lscgctl output: '
                            . htmlspecialchars($output)
                    );
                }

return;
        }

self::LscntrUserManage(self::$lscntr_userMgr_act, '');
    }

/**
     *
     * @since 2.0.0
     *
     * @param string|null $magnitude
     *
     * @return int  Result converted to bytes.
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     */
    public static function IntMagnitude( $magnitude )
    {
        if ( $magnitude == '' || $magnitude == '-1' ) {
            return -1;
        }
        elseif ( ctype_digit($magnitude) ) {
            return (int)$magnitude;
        }
        elseif ( strlen($magnitude) < 2 ) {
            return -1;
        }

$suffix = substr($magnitude, -1);
        $prefix = substr($magnitude, 0 , -1);

switch ( $suffix ) {

case 't':
            case 'T':
                $multiplier = 1099511627776;
                break;

case 'g':
            case 'G':
                $multiplier = 1073741824;
                break;

case 'm':
            case 'M':
                $multiplier = 1048576;
                break;

case 'k':
            case 'K':
                $multiplier = 1024;
                break;

default:
                $multiplier = 1;
        }

$res  = (int)$prefix * $multiplier;

PleskPluginLogger::debug(
            "IntMagnitude Prefix: $prefix, Suffix: $suffix, "
                . "Multiplier $multiplier, result: $res"
        );

return $res;
    }

/**
     *
     * @since 2.0.0
     *
     * @param string     $title
     * @param int|string $uid
     * @param string     $package
     *
     * @return bool  True if package default or false if not.
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::IntMagnitude() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::IntMagnitude() call.
     */
    public static function LscntrUidOptDefaults( $title, $uid, $package )
    {
        if ( $package == '' ) {
            return true;
        }

if ( self::$uids == null ) {
            self::ValidateUids();
        }

if (
                array_key_exists($uid, self::$uids)
                &&
                array_key_exists($title, self::$uids[$uid])
        ) {
            $uid_val = self::IntMagnitude(self::$uids[$uid][$title]);
        } else {
            $uid_val = -1;
        }

if ( array_key_exists($title, self::$packages[$package]) ) {
            $package_val =
                self::IntMagnitude(self::$packages[$package][$title]);
        } else {
            $package_val = -1;
        }

return ($uid_val == $package_val);
    }

/**
     *
     * @since 2.0.0
     *
     * @param string|int $uid
     * @param string     $package
     *
     * @return bool  True if package default or false if not.
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidateUids() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidatePkgs() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrUidOptDefaults() call.
     */
    public static function LscntrUidDefaults( $uid, $package )
    {
        self::ValidateUids();
        self::ValidatePkgs();

if ( $package == '' ) {
            return true;
        }

foreach ( self::$uid_titles as $title ) {

if ( !self::LscntrUidOptDefaults($title, $uid, $package) ) {
                return false;
            }
        }

return true;
    }

/**
     *
     * @since 2.0.0
     *
     * @param string $package  To update.
     *
     * @return array  To execute.
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     */
    public static function LsCntrPkgUpdate( $package )
    {
        $arr = [ self::$lspkgctl, ' -q ' ];

foreach ( self::$uid_titles as $title ) {

if (
                    ($val = Util::get_request_var($title)) != ''
                    &&
                    strcasecmp($val, '&#8734')
                    &&
                    strcasecmp($val, 'unlimited')
            ) {
                array_push($arr, "--$title", $val);
            } else {
                array_push($arr, "--$title", '-1');
            }
        }

array_push($arr, 'set', "'$package'");

PleskPluginLogger::debug('PkgUpdate cmd: ' . implode(' ', $arr));

return $arr;
    }

/**
     *
     * @since 2.0.0
     *
     * @param string $act
     * @param string $actId
     *
     * @return void
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidatePkgs() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LsCntrPkgUpdate() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskEscalate::escalate() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by self::PkgsParse()
     *     call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::uiSuccess() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrPackageManage() call.
     */
    public static function LscntrPackageManage( $act, $actId )
    {
        PleskPluginLogger::debug(
            "LscntrPackageManage: act: $act actId: $actId"
        );

switch ( $act ) {

case 'pkgList':
            default:
                $act = 'pkgList';
                $arr = [ self::$lspkgctl, 'list-all', '-q' ];
                break;

case 'pkgEdit':
                self::ValidatePkgs();
                return;

case 'pkgUpdate':
                $arr = self::LsCntrPkgUpdate($actId);
                break;

}

$output = PleskEscalate::escalate(
            PleskEscalate::CMD_LSCNTR_API,
            [ 'cmdLine' => implode(' ', $arr) ]
        );

PleskPluginLogger::debug(
            'cmd: ' . implode(' ', $arr) . " output:$output"
        );

switch ( $act ) {

case 'pkgList' :
                self::PkgsParse($output);
                return;

case 'pkgUpdate':
                PleskPluginLogger::uiSuccess(
                    "Successfully updated package for: $actId"
                );

//fallthrough

default:
                self::LscntrPackageManage('pkgList', '');
        }
    }

/**
     *
     * @since 2.0.0
     *
     * @param $uid
     *
     * @return bool  True if unlimited or false if not.
     */
    public static function LscntrUidUnlimited($uid)
    {
        foreach (self::$uid_titles as $title) {
            if (self::$uids[$uid][$title] != '') {
                return false;
            }
        }
        return true;
    }

/**
     *
     * @since 2.0.0
     *
     * @param array      $limit_arr   The $uid or $package array
     * @param int|string $limit_type  The limit type (cpu, etc.)
     *
     * @return mixed  Value to display
     *
     */
    public static function LsCntrDisplayCgLimit( $limit_arr, $limit_type )
    {
        if (
                !array_key_exists($limit_type, $limit_arr)
                ||
                $limit_arr[$limit_type] == ''
        ) {
            //unlimited
            return '&#8734';
        }
        return $limit_arr[$limit_type];
    }

/**
     *
     * @since 2.0.0
     *
     * @param mixed|string $opt
     *
     * @return string  Value to display.
     *
     */
    public static function LsCntrEditTitle( $opt )
    {
        switch ($opt) {
            case 'cpu':
                return 'CPU Percentage (percentage, &#8734)';
            case 'mem':
                return 'Memory (bytes, K, M, G, &#8734)';
            case 'io':
                return 'IO (bytes, K, M, G, &#8734)';
            case 'iops':
                return 'IOPS (ops, K, M, &#8734)';
            case 'tasks':
                return 'Tasks (tasks, K, &#8734)';
        }
        return '';
    }

/**
     *
     * @since 2.0.0
     *
     * @param string $size  as a full size in bytes or whatever
     *
     * @return string of the size in magnitude.
     *
     */
    public static function StrMagnitude( $size )
    {
        if ( $size == '' || $size == '-1' ) {
            return '';
        }

$val = FloatVal($size);

switch ( true ) {

case ($val >= 1099511627776):
                $divisor   = 1099511627776;
                $qualifier = 'T';
                break;

case ( $val >= 1073741824 ):
                $divisor   = 1073741824;
                $qualifier = 'G';
                break;

case ( $val >= 1048576 ):
                $divisor   = 1048576;
                $qualifier = 'M';
                break;

case ($val >= 1024):
                $divisor   = 1024;
                $qualifier = 'K';
                break;

default:
                return strval(round($val, 1));
        }

return (round($val / $divisor, 1) . $qualifier);
    }

/**
     *
     * @since 2.0.0
     *
     * @return string  A date range for prometheus; does no error validation.
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     */
    private static function ConvertTimeRangeToPrometheus()
    {
        $pos = strpos(self::$time_range, ':');

if ( $pos === false ) {

switch ( self::$time_range ) {

case self::TIME_RANGE_NO_PROMETHEUS:
                    return '';

case self::TIME_RANGE_TODAY:
                    $tr = '[' . (time() + self::$time_diff) % 86400 . 's]';
                    break;

case self::TIME_RANGE_YESTERDAY:
                    $tr =  '[1d] offset '
                        . (time() + self::$time_diff) % 86400
                        . 's';
                    break;

default:
                    $tr = '[' . self::$time_range . 's]';
            }

PleskPluginLogger::debug(
                'ConvertTimeRangeToPrometheus, convert '
                    . self::$time_range
                    . " to $tr diff "
                    . self::$time_diff
            );
            return $tr;
        }

$start = substr(self::$time_range, 0, $pos);
        $end   = substr(self::$time_range, $pos+1);
        $secs  = intval($end) - intval($start);
        $tr    = "[$secs] @ $start";
        PleskPluginLogger::debug(
            'ConvertTimeRangeToPrometheus, convert '
                . self::$time_range
                . " to $tr"
        );

return $tr;
    }

/**
     *
     * @since 2.0.0
     *
     * @param string $title  The UID title.
     *
     * @return string  The prometheus field to query on.
     */
    private static function ConvertTitleToPrometheusQuery( $title )
    {
        switch ($title) {
            case 'cpu':
                return 'cgroups_cpu_percent';
            case 'mem':
                return 'cgroups_memory_bytes';
            case 'io':
                return 'cgroups_io_bytes_per_second';
            case 'iops':
                return 'cgroups_io_op_per_second';
            case 'tasks':
                return 'cgroups_pids_total';
        }
        return '';
    }

/**
     *
     * @since 2.0.0
     * @since 2.1.2  Added required parameter $cmd.
     *
     * @param string $cmd    The command executed
     * @param string $title  The array title
     * @param array  $output from exec imploded
     *
     * @throws PleskExtensionException  Thrown when unable to decode stats
     *     output.
     * @throws PleskExtensionException  Thrown when $cmd query gets an empty
     *     array.
     * @throws PleskExtensionException  Thrown when $cmd output is unexpected.
     * @throws PleskExtensionException  Thrown when stats output is unexpected.
     */
    private static function StatsParse( $cmd, $title, $output )
    {
        $stats_obj  = json_decode(implode($output), true);
        $last_error = json_last_error_msg();

if ( $stats_obj === null && $last_error != 'No error' ) {
            throw new PleskExtensionException(
                "Error decoding stats for : $cmd output: " . implode($output)
                    . " :$last_error"
            );
        } elseif ( $stats_obj === null ) {
            throw new PleskExtensionException(
                "Query of $cmd gets an empty array: $last_error"
            );
        } elseif (
                !array_key_exists('status', $stats_obj)
                ||
                !array_key_exists('data', $stats_obj)
                ||
                !array_key_exists('result', $stats_obj['data'])
        ) {
            throw new PleskExtensionException(
                "Unexpected output for : $cmd output: " . implode($output)
            );
        }

foreach ( array_keys(self::$stats) as $uid ) {
            self::$stats[$uid][$title] = '';
        }

$stats_arr = $stats_obj['data']['result'];

if ( count($stats_arr) == 0 && count(self::$stats) > 0 ) {
            PleskPluginLogger::debug('Query returned nothing; reset');
            return;
        }

foreach ( $stats_arr as $stat ) {

if (
                    !array_key_exists('metric', $stat)
                    ||
                    !array_key_exists('uid', $stat['metric'])
                    ||
                    !array_key_exists('value', $stat)
                    ||
                    !is_array($stat['value'])
                    ||
                    count($stat['value']) != 2
            ) {
                throw new PleskExtensionException(
                    "Unexpected stat output for : $cmd output: "
                        . implode($output)
                );
            }

$uid   = $stat['metric']['uid'];
            $value = $stat['value'][1];

PleskPluginLogger::debug("   For $title, uid: $uid: $value");

self::$stats[$uid][$title] = $value;
        }
    }

/**
     *
     * @since 2.0.0
     *
     * @param null|array $noprom_raw_stats  Passed by reference. The variable to
     *     return $output from exec.
     *
     * @throws PleskExtensionException  Thrown when unable to decode lscgctl
     *     output.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskEscalate::escalate() call.
     */
    private static function ScrapeStats( &$noprom_raw_stats )
    {
        $output = PleskEscalate::escalate(
            PleskEscalate::CMD_LSCNTR_API,
            [ 'cmdLine' => self::$lscgstats . ' -q' ]
        );

$noprom_raw_stats = json_decode($output, true);

if ( self::$uids == null || json_last_error_msg() != 'No error' ) {
            throw new PleskExtensionException(
                "Error decoding lscgctl output: $output"
            );
        }
    }
    
    /**
     * ALWAYS re-gets stats
     *
     * @since 2.0.0
     *
     * @return int  Time in ns.
     *
     */
    public static function getHrTime()
    {
        $times = explode(" ", microtime());
        return intval($times[1] * 1000000000 + $times[0] * 1000);
    }

/**
     * ALWAYS re-gets stats
     *
     * @since 2.0.0
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by self::ScrapeStats()
     *     call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by self::ScrapeStats()
     *     call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     */
    private static function StatsNoPrometheus()
    {
        PleskPluginLogger::debug('StatsNoPrometheus enter');

self::$stats_ok = false;

self::ScrapeStats($noprom_raw_stats_now);

if ( self::$noprom_raw_stats_time == 0 ) {
            PleskPluginLogger::debug(
                'StatsNoPrometheus need to wait a short time and get again for '
                    . 'some values'
            );

self::$noprom_raw_stats_time = self::getHrTime();
            self::$noprom_raw_stats      = $noprom_raw_stats_now;

sleep(2);
            self::ScrapeStats($noprom_raw_stats_now);
        }

self::$noprom_stats_interval =
            (self::getHrTime() - self::$noprom_raw_stats_time);

PleskPluginLogger::debug(
            'StatsNoPrometheus interval (us): '
                . (self::$noprom_stats_interval / 1000)
        );

/* Now calculate the stats */
        foreach ( self::$uids as $uid => $uidVal ) {

if ( !empty(self::$uid_titles) ) {
                self::$stats[$uid] = [];
            }

foreach ( self::$uid_titles as $title ) {

if (
                        !isset(self::$noprom_raw_stats[$uid][$title])
                        ||
                        !isset($noprom_raw_stats_now[$uid][$title])
                ) {
                    PleskPluginLogger::debug("Not set for $uid, $title");
                    self::$stats[$uid][$title] = '';
                } elseif ( $title == 'cpu' ) {
                    $diff = (
                        intval($noprom_raw_stats_now[$uid][$title])
                        -
                        intval(self::$noprom_raw_stats[$uid][$title])
                    );

self::$stats[$uid][$title] = strval(
                        $diff * 100 / (self::$noprom_stats_interval / 1000)
                    );
                } elseif ( $title == 'io' || $title == 'iops' ) {
                    $diff = (
                        intval($noprom_raw_stats_now[$uid][$title])
                        -
                        intval(self::$noprom_raw_stats[$uid][$title])
                    );
                    $secs = (self::$noprom_stats_interval / 1000) / 1000000;

if ( $secs > 0 ) {
                        self::$stats[$uid][$title] = strval($diff / $secs);
                    } else {
                        self::$stats[$uid][$title] = '0';
                    }
                } else {
                    self::$stats[$uid][$title] =
                        $noprom_raw_stats_now[$uid][$title];
                }

PleskPluginLogger::debug(
                    "StatsNoPrometheus[$uid][$title]: "
                        . self::$stats[$uid][$title]
                );
            }
        }

PleskPluginLogger::debug('StatsNoPrometheus normal exit');

self::$stats_ok = true;
    }

/**
     * ALWAYS re-gets stats
     *
     * @since 2.0.0
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ConvertTimeRangeToPrometheus()) call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::uiError() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by self::StatsParse()
     *     call.
     */
    private static function StatsPrometheus()
    {
        $tr = self::ConvertTimeRangeToPrometheus();

foreach ( self::$uid_titles as $title ) {
            $cmd = 'curl -L '
                . self::$prometheus_addr
                . '/api/v1/query --data-urlencode \'query=avg_over_time('
                . self::ConvertTitleToPrometheusQuery($title)
                . "$tr)'";

PleskPluginLogger::debug("ValidateStats, final command: $cmd");

$output = [];
            exec($cmd, $output, $return_var);

if ( $return_var != 0 ) {
                PleskPluginLogger::uiError(
                    "LiteSpeed Containers Failure in $cmd: "
                        . implode(' ', $output)
                );
                self::$stats_ok = false;

return;
            }

PleskPluginLogger::debug('  -> ' . implode($output));
            self::StatsParse($cmd, $title, $output);
        }

self::$stats_ok = true;
    }

/**
     * ALWAYS re-gets stats
     *
     * @since 2.0.0
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidateUids() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::StatsNoPrometheus() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::StatsPrometheus() call.
     */
    private static function ValidateStats()
    {
        PleskPluginLogger::debug('ValidateStats, use range: ' . self::$time_range);
        self::$stats_ok = false;
        self::ValidateUids();
        self::$stats = self::$uids;
        if (self::$time_range == self::TIME_RANGE_NO_PROMETHEUS) {
            self::StatsNoPrometheus();
            return;
        }
        self::StatsPrometheus();
    }

/**
     *
     * @since 2.0.0
     *
     * @param $actId
     *
     * @throws PleskExtensionException  Thrown when stats title is missing a
     *     value.
     * @throws PleskExtensionException  Thrown when stats title has an
     *     unexpected value.
     */
    private static function ParseReqVarsActId($actId)
    {
        $pos = 0;
        $newPos = strpos($actId, '|', $pos);
        PleskPluginLogger::debug("ParseReqVarsActId, actId: $actId, newPos: $newPos");
        while ($newPos) {
            $title = substr($actId, $pos, $newPos - $pos);
            $pos   = $newPos + 1;
            if ($pos > strlen($actId)) {
                throw new PleskExtensionException(
                    "Missing value in stats title: $title"
                );
            }
            $newPos = strpos($actId, '|', $pos);
            if (!$newPos) {
                $value = substr($actId, $pos);
            } else {
                $value  = substr($actId, $pos, $newPos - $pos);
                $pos    = $newPos + 1;
                $newPos = strpos($actId, '|', $pos);
            }
            PleskPluginLogger::debug("   title: $title, value: $value");
            switch ( $title ) {

case 'prometheus_addr' :

if ( $value !== false ) {
                        self::setLsCntrPrometheusAddr($value);
                        PleskPluginLogger::debug(
                            '   prometheus_addr set to '
                                . self::$prometheus_addr
                        );
                    }
                    break;

case 'time_range' :

if ( $value !== false ) {
                        self::$time_range = $value;
                        PleskPluginLogger::debug(
                            '   time_range set to ' . self::$time_range
                        );
                    }
                    break;

default:
                    throw new PleskExtensionException(
                        "Unexpected stats title: $title value: $value"
                    );
            }
        }
    }

/**
     *
     * @since 2.0.0
     *
     * @param string $act
     * @param string $actId
     *
     * @return void
     *
     * @throws PleskExtensionException  Thrown when no valid users are found.
     * @throws PleskExtensionException  Thrown when unable to decode lscgctl
     *     output.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::parseReqVarsActId() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidateStats() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskEscalate::escalate() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskPluginLogger::debug() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrStatsManage() call.
     * @throws PleskExtensionException  Thrown indirectly by self::PkgsParse()
     *     call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LsCntrStatsManage() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::LscntrStatsManage() call.
     */
    public static function LscntrStatsManage( $act, $actId )
    {
        PleskPluginLogger::debug("LscntrStatsManage: act: $act actId: $actId");

if ( strpos($actId, '|') >= 0 ) {
            self::parseReqVarsActId($actId);
        }

switch ( $act ) {

case 'pkgList':
                $arr = [ self::$lspkgctl, 'list-all', '-q' ];
                break;

case 'statsList':
                if ( $actId == 'noStats' ) {
                    return;
                }

self::ValidateStats();
                return;

case 'listUids':
            default:
                $act = 'listUids';
                $arr = [ self::$lscgctl, 'list-all', '-q' ];
                break;
        }

$output = PleskEscalate::escalate(
            PleskEscalate::CMD_LSCNTR_API,
            [ 'cmdLine' => implode(' ', $arr) ]
        );

PleskPluginLogger::debug(
            'cmd: ' . implode(' ', $arr) . " output:$output"
        );

switch ( $act ) {

case 'listUids':
                self::$uids = json_decode($output, true);

if (
                        self::$uids == null
                        &&
                        json_last_error_msg() == 'No error'
                ) {
                    throw new PleskExtensionException(
                        'No valid users found in Plesk; '
                            . 'when you create accounts you can return to this '
                            . 'screen to view stats'
                    );
                }

if (
                        self::$uids == null
                        ||
                        json_last_error_msg() != 'No error'
                ) {
                    throw new PleskExtensionException(
                        "Error decoding lscgctl output: $output"
                    );
                }

self::LscntrStatsManage('pkgList', $actId);
                return;

case 'pkgList' :
                self::PkgsParse($output);
                self::LsCntrStatsManage('statsList', $actId);
                return;
        }

self::LscntrStatsManage('listUids', $actId);
    }

/**
     *
     * @since 2.0.0
     *
     * @return array uids
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidateUids() call.
     */
    public static function getLscntrUids()
    {
        self::ValidateUids();
        return self::$uids;
    }

/**
     *
     * @since 2.0.0
     *
     * @return array[]  uids
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidateUids() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::IntMagnitude() call.
     */
    public static function getLscntrUidsData()
    {
        if ( self::$uidsData != null && count(self::$uidsData) > 0 ) {
            return self::$uidsData;
        }

self::ValidateUids();

foreach ( self::$uids as $uid => $uidVal ) {

foreach ( $uidVal as $title => $value ) {

if ( $title == 'name' ) {
                    continue;
                }

self::$uidsData[$uid][$title] = self::IntMagnitude($value);

switch ( self::$uidsData[$uid][$title] ) {

case '':
                    case 'unlimited':
                    case -1:
                        self::$uidsData[$uid][$title] = PHP_INT_MAX;
                        break;
                }
            }
        }

return self::$uidsData;
    }

/**
     *
     * @since 2.0.0
     *
     * @return void
     *
     * @throws PleskExtensionException  Thrown when unable to decode
     *     "lsnsctl list-mount" output.
     * @throws PleskExtensionException  Thrown indirectly by
     *     PleskEscalate::escalate() call.
     */
    private static function ValidateMounts()
    {
        if (self::$mounts != null && count(self::$mounts) > 0) {
            return;
        }
        $arr = [self::$lsnsctl, "list-mount", "-q"];
        $output = PleskEscalate::escalate(
            PleskEscalate::CMD_LSCNTR_API,
            array( 'cmdLine' => implode(' ', $arr) )
        );
        self::$mounts = json_decode($output, true);
        $last_error = json_last_error_msg();
        if ($last_error != "No error") {
            throw new PleskExtensionException(
                'Error decoding lsnsctl list-mount output: '
                    . "$output :$last_error"
            );
        } else if (self::$mounts == null) {
            PleskPluginLogger::debug('mounts gets an empty array');
            self::$mounts = array();
        }
    }

/**
     *
     * @since 2.0.0
     *
     * @return array mounts
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidateMounts() call.
     */
    public static function getLscntrMounts()
    {
        self::ValidateMounts();
        return self::$mounts;
    }

/**
     *
     * @since 2.0.0
     *
     * @return array domains
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidateUids() call.
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::read_domains() call.
     */
    public static function getLscntrDomains()
    {
        if (count(self::$domains) == 0) {
            self::ValidateUids();
            self::read_domains();
        }
        return self::$domains;
    }

/**
     *
     * @since 2.0.0
     *
     * @return array disabled_ns_uids
     *
     */
    public static function getLsCntrDisabledNsUids()
    {
        return self::$disabled_ns_uids;
    }

/**
     *
     * @since 2.0.0
     *
     * @return array uid_update
     *
     */
    public static function getLsCntrUidUpdate()
    {
        return self::$uid_update;
    }

/**
     *
     * @since 2.0.0
     *
     * @return int[]|string[] uid_packages
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidatePkgs() call.
     */
    public static function getLsCntrUidPackages()
    {
        self::ValidatePkgs();
        return self::$uid_packages;
    }

/**
     *
     * @since 2.0.0
     *
     * @return string[]  uid_titles
     *
     */
    public static function getLsCntrUidTitles()
    {
        return self::$uid_titles;
    }

/**
     *
     * @since 2.0.0
     *
     * @return string  prometheus_addr;
     *
     */
    public static function getLsCntrPrometheusAddr()
    {
        return self::$prometheus_addr;
    }

/**
     *
     * @since 2.0.0
     *
     * @param string $prometheus_addr
     *
     */
    public static function setLsCntrPrometheusAddr( $prometheus_addr )
    {
        while ( substr($prometheus_addr, -1) == '/' ) {
            $prometheus_addr = substr($prometheus_addr, 0, -1);
        }

self::$prometheus_addr = $prometheus_addr;
    }

/**
     *
     * @since 2.0.0
     *
     * @return string  time_range;
     *
     */
    public static function getLsCntrTimeRange()
    {
        return self::$time_range;
    }

/**
     *
     * @since 2.0.0
     *
     * @param $time_range
     *
     */
    public static function setLsCntrTimeRange($time_range)
    {
        self::$time_range = $time_range;
    }

/**
     *
     * @since 2.0.0
     *
     * @return bool  stats_ok
     *
     */
    public static function getLsCntrStatsOk()
    {
        return self::$stats_ok;
    }

/**
     *
     * @since 2.0.0
     *
     * @return array uid_packages
     *
     */
    public static function getLsCntrStats()
    {
        return self::$stats;
    }

/**
     *
     * @since 2.0.0
     *
     * @return array[]  uids
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::IntMagnitude() call.
     */
    public static function getLscntrStatsData()
    {
        if ( self::$stats_data != null && count(self::$stats_data) > 0 ) {
            return self::$stats_data;
        }

foreach ( self::$stats as $uid => $statVal ) {

foreach ( $statVal as $title => $value ) {

if ( $title == 'name' ) {
                    continue;
                }

self::$stats_data[$uid][$title] = self::IntMagnitude($value);

switch ( self::$stats_data[$uid][$title] ) {

case '':
                    case 'unlimited':
                    case -1:
                        // Stats are not definitions!
                        self::$stats_data[$uid][$title] = 0;
                        break;
                }
            }
        }

return self::$stats_data;
    }

/**
     *
     * @since 2.0.0
     *
     * @return int noprom_stats_interval
     *
     */
    public static function getLsCntrNopromStatsInterval()
    {
        return self::$noprom_stats_interval;
    }

/**
     *
     * @since 2.0.0
     *
     * @return array  uid_packages
     *
     * @throws PleskExtensionException  Thrown indirectly by
     *     self::ValidateStats() call.
     */
    public static function ValidateLsCntrStats()
    {
        self::ValidateStats();
        return self::$stats;
    }

}

📁 Sid Gifari File Manager