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

(

)

Definition at line 26 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 36 of file class.win32ps.php.

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

References $result.

Referenced by getStatProc().

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 122 of file class.win32ps.php.

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

References findByPid().

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 155 of file class.win32ps.php.

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

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

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 133 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().

getCurrentPid()

getCurrentPid ( )

static

Retrieves the current process ID.

Returns

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

Definition at line 68 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().

getKeys()

getKeys ( )

static

Retrieves the keys used for process information.

Returns

array An array of keys used for process information.

Definition at line 52 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 79 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(), killBins(), Root\register(), and ActionQuit\terminatePhpProcesses().

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 102 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().

kill()

kill ( $pid )

static

Terminates a process by its PID.

Parameters

int

$pid

The process ID to terminate.

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

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

References Win32Native\killProcess().

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

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 192 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 = UtilPath::formatUnixPath($proc[self::EXECUTABLE_PATH]);
                $unixCommandPath = UtilPath::formatUnixPath($proc[self::COMMAND_LINE]);
 
                // Not kill current PID (PHP)
                if ($proc[self::PROCESS_ID] == self::getCurrentPid()) {
                    continue;
                }
 
                // Not kill bearsampp
                if ($unixExePath == $bearsamppRoot->getExeFilePath()) {
                    continue;
                }
 
                // Not kill inside www
                if (UtilString::startWith($unixExePath, $bearsamppRoot->getWwwPath() . '/') || UtilString::contains($unixCommandPath, $bearsamppRoot->getWwwPath() . '/')) {
                    continue;
                }
 
                // Not kill external process
                if (!UtilString::startWith($unixExePath, $bearsamppRoot->getRootPath() . '/') && !UtilString::contains($unixCommandPath, $bearsamppRoot->getRootPath() . '/')) {
                    continue;
                }
 
                self::kill($proc[self::PROCESS_ID]);
                $killed[] = $proc;
            }
        }
 
        return $killed;
    }

References $bearsamppRoot, $proc, UtilString\contains(), UtilPath\formatUnixPath(), getListProcs(), kill(), and UtilString\startWith().

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

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