Win32Ps Class Reference

Public Member Functions
	__construct ()

Static Public Member Functions
static	exists ($pid)
static	findByPath ($path)
static	findByPid ($pid)
static	getCurrentPid ()
static	getKeys ()
static	getListProcs ()
static	getStatProc ()
static	kill ($pid)
static	killBins ($refreshProcs=false)

Data Fields
const	CAPTION = 'Caption'
const	COMMAND_LINE = 'CommandLine'
const	EXECUTABLE_PATH = 'ExecutablePath'
const	NAME = 'Name'
const	PROCESS_ID = 'ProcessID'

Static Private Member Functions
static	callWin32Ps ($function)

Detailed Description

Class Win32Ps

This class provides various utility functions for interacting with Windows processes. It includes methods for retrieving process information, checking process existence, finding processes by PID or path, and terminating processes.

Definition at line 18 of file class.win32ps.php.

Constructor & Destructor Documentation

__construct()

__construct

(

)

Constructs a Win32Ps instance.

Definition at line 29 of file class.win32ps.php.

    {
    }

Member Function Documentation

callWin32Ps()

callWin32Ps ( $function )

staticprivate

Calls a specified function if it exists.

Parameters

string

$function

The name of the function to call.

Returns

mixed The result of the function call, or false if the function does not exist.

Definition at line 40 of file class.win32ps.php.

    {
        $result = false;
 
        if (function_exists($function)) {
            $result = @call_user_func($function);
        }
 
        return $result;
    }

References $result.

Referenced by getStatProc().

Here is the caller graph for this function:

exists()

exists ( $pid )

static

Checks if a process with the specified PID exists.

Parameters

int

$pid

The process ID to check.

Returns

bool True if the process exists, false otherwise.

Definition at line 129 of file class.win32ps.php.

    {
        return self::findByPid($pid) !== false;
    }

References findByPid().

Here is the call graph for this function:

findByPath()

findByPath ( $path )

static

Finds a process by its executable path.

Parameters

string

$path

The path to the executable.

Returns

array|false An array of process information, or false if not found.

Definition at line 164 of file class.win32ps.php.

    {
        $path = Path::formatUnixPath($path);
        if (!empty($path) && is_file($path)) {
            $procs = self::getListProcs();
            if ($procs !== false) {
                foreach ($procs as $proc) {
                    $unixExePath = Path::formatUnixPath($proc[self::EXECUTABLE_PATH]);
                    if ($unixExePath == $path) {
                        return $proc;
                    }
                }
            }
        }
 
        return false;
    }

References $proc, Path\formatUnixPath(), and getListProcs().

Here is the call graph for this function:

findByPid()

findByPid ( $pid )

static

Finds a process by its PID.

Parameters

int

$pid

The process ID to find.

Returns

array|false An array of process information, or false if not found.

Definition at line 141 of file class.win32ps.php.

    {
        if (!empty($pid)) {
            $procs = self::getListProcs();
            if ($procs !== false) {
                foreach ($procs as $proc) {
                    if ($proc[self::PROCESS_ID] == $pid) {
                        return $proc;
                    }
                }
            }
        }
 
        return false;
    }

References $proc, and getListProcs().

Referenced by exists().

Here is the call graph for this function:

Here is the caller graph for this function:

getCurrentPid()

getCurrentPid ( )

static

Retrieves the current process ID.

Returns

int The current process ID, or 0 if not found.

Definition at line 72 of file class.win32ps.php.

    {
        $procInfo = self::getStatProc();
 
        return isset($procInfo[self::PROCESS_ID]) ? intval($procInfo[self::PROCESS_ID]) : 0;
    }

References getStatProc().

Referenced by ActionLoading\__construct(), ActionQuit\checkForOrphanedProcesses(), WinBinder\destroyWindow(), ActionLoading\processLoading(), ActionQuit\processWindow(), and ActionQuit\terminatePhpProcesses().

Here is the call graph for this function:

Here is the caller graph for this function:

getKeys()

getKeys ( )

static

Retrieves the keys used for process information.

Returns

array An array of keys used for process information.

Definition at line 56 of file class.win32ps.php.

    {
        return array(
            self::NAME,
            self::PROCESS_ID,
            self::EXECUTABLE_PATH,
            self::CAPTION,
            self::COMMAND_LINE
        );
    }

getListProcs()

getListProcs ( )

static

Retrieves a list of running processes.

Returns

array|false An array of process information, or false on failure.

Definition at line 84 of file class.win32ps.php.

    {
        $procs = Win32Native::getProcessList(self::getKeys());
 
        // Filter out processes without ExecutablePath (same behavior as old VBS version)
        if ($procs !== false && is_array($procs)) {
            $filtered = array();
            foreach ($procs as $proc) {
                if (!empty($proc[self::EXECUTABLE_PATH])) {
                    $filtered[] = $proc;
                }
            }
 
            return $filtered;
        }
 
        return $procs;
    }

References $proc, and Win32Native\getProcessList().

Referenced by ActionQuit\checkForOrphanedProcesses(), findByPath(), findByPid(), Root\getProcs(), killBins(), and ActionQuit\terminatePhpProcesses().

Here is the call graph for this function:

Here is the caller graph for this function:

getStatProc()

getStatProc ( )

static

Retrieves the status of the current process.

Returns

array|null An array containing the process ID and executable path, or null on failure.

Definition at line 108 of file class.win32ps.php.

    {
        $statProc = self::callWin32Ps('win32_ps_stat_proc');
 
        if ($statProc !== false) {
            return array(
                self::PROCESS_ID      => $statProc['pid'],
                self::EXECUTABLE_PATH => $statProc['exe']
            );
        }
 
        return null;
    }

References callWin32Ps().

Referenced by getCurrentPid().

Here is the call graph for this function:

Here is the caller graph for this function:

kill()

kill ( $pid )

static

Terminates a process by its PID.

Parameters

int

$pid

The process ID to terminate.

Definition at line 187 of file class.win32ps.php.

    {
        $pid = intval($pid);
        if (!empty($pid)) {
            Win32Native::killProcess($pid);
        }
    }

References Win32Native\killProcess().

Referenced by ActionLoading\__construct(), ActionQuit\checkForOrphanedProcesses(), killBins(), ActionLoading\processLoading(), Util\stopLoading(), and ActionQuit\terminatePhpProcesses().

Here is the call graph for this function:

Here is the caller graph for this function:

killBins()

killBins ( $refreshProcs = false )

static

Terminates all Bearsampp-related processes except the current one.

Parameters

bool

$refreshProcs

Whether to refresh the list of processes before terminating.

Returns

array An array of terminated processes.

Definition at line 202 of file class.win32ps.php.

    {
        global $bearsamppRoot;
        $killed = array();
 
        $procs = $bearsamppRoot->getProcs();
        if ($refreshProcs || $procs === null) {
            $procs = self::getListProcs();
        }
 
        if ($procs !== false && $procs !== null) {
            foreach ($procs as $proc) {
                $unixExePath     = Path::formatUnixPath($proc[self::EXECUTABLE_PATH]);
                $unixCommandPath = Path::formatUnixPath($proc[self::COMMAND_LINE]);
 
                // Not kill current PID (PHP)
                if ($proc[self::PROCESS_ID] == self::getCurrentPid()) {
                    continue;
                }
 
                // Not kill bearsampp
                if ($unixExePath == Path::getExeFilePath()) {
                    continue;
                }
 
                // Not kill inside www
                if (UtilString::startWith($unixExePath, Path::getWwwPath() . '/') || UtilString::contains($unixCommandPath, Path::getWwwPath() . '/')) {
                    continue;
                }
 
                // Not kill external process
                if (!UtilString::startWith($unixExePath, Path::getRootPath() . '/') && !UtilString::contains($unixCommandPath, Path::getRootPath() . '/')) {
                    continue;
                }
 
                self::kill($proc[self::PROCESS_ID]);
                $killed[] = $proc;
            }
        }
 
        return $killed;
    }

References $bearsamppRoot, $proc, UtilString\contains(), Path\formatUnixPath(), Path\getExeFilePath(), getListProcs(), Path\getRootPath(), Path\getWwwPath(), kill(), and UtilString\startWith().

Referenced by ActionManualRestart\__construct(), Win32Service\delete(), Batch\exitApp(), ServiceHelper\forceKillService(), ActionStartup\killOldInstances(), ActionStartup\prepareService(), ActionQuit\processWindow(), and ActionExt\procReload().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

CAPTION

const CAPTION = 'Caption'

Definition at line 23 of file class.win32ps.php.

COMMAND_LINE

const COMMAND_LINE = 'CommandLine'

Definition at line 24 of file class.win32ps.php.

EXECUTABLE_PATH

const EXECUTABLE_PATH = 'ExecutablePath'

Definition at line 22 of file class.win32ps.php.

Referenced by ActionQuit\checkForOrphanedProcesses(), ActionStartup\killOldInstances(), ActionStartup\processWindow(), and ActionQuit\terminatePhpProcesses().

NAME

const NAME = 'Name'

Definition at line 20 of file class.win32ps.php.

PROCESS_ID

const PROCESS_ID = 'ProcessID'

Definition at line 21 of file class.win32ps.php.

Referenced by ActionQuit\checkForOrphanedProcesses(), ActionStartup\killOldInstances(), ActionStartup\processWindow(), and ActionQuit\terminatePhpProcesses().

---

The documentation for this class was generated from the following file:

• E:/Bearsampp-development/sandbox/core/classes/class.win32ps.php