class.win32service.php

Go to the documentation of this file.

<?php
/*
 *
 *  * Copyright (c) 2022-2025 Bearsampp
 *  * License: GNU General Public License version 3 or later; see LICENSE.txt
 *  * Website: https://bearsampp.com
 *  * Github: https://github.com/Bearsampp
 *
 */

class Win32Service
{
    // Win32Service Service Status Constants
    const WIN32_SERVICE_CONTINUE_PENDING = '5';
    const WIN32_SERVICE_PAUSE_PENDING = '6';
    const WIN32_SERVICE_PAUSED = '7';
    const WIN32_SERVICE_RUNNING = '4';
    const WIN32_SERVICE_START_PENDING = '2';
    const WIN32_SERVICE_STOP_PENDING = '3';
    const WIN32_SERVICE_STOPPED = '1';
    const WIN32_SERVICE_NA = '0';
 
    // Win32 Error Codes
    const WIN32_ERROR_ACCESS_DENIED = '5';
    const WIN32_ERROR_CIRCULAR_DEPENDENCY = '423';
    const WIN32_ERROR_DATABASE_DOES_NOT_EXIST = '429';
    const WIN32_ERROR_DEPENDENT_SERVICES_RUNNING = '41B';
    const WIN32_ERROR_DUPLICATE_SERVICE_NAME = '436';
    const WIN32_ERROR_FAILED_SERVICE_CONTROLLER_CONNECT = '427';
    const WIN32_ERROR_INSUFFICIENT_BUFFER = '7A';
    const WIN32_ERROR_INVALID_DATA = 'D';
    const WIN32_ERROR_INVALID_HANDLE = '6';
    const WIN32_ERROR_INVALID_LEVEL = '7C';
    const WIN32_ERROR_INVALID_NAME = '7B';
    const WIN32_ERROR_INVALID_PARAMETER = '57';
    const WIN32_ERROR_INVALID_SERVICE_ACCOUNT = '421';
    const WIN32_ERROR_INVALID_SERVICE_CONTROL = '41C';
    const WIN32_ERROR_PATH_NOT_FOUND = '3';
    const WIN32_ERROR_SERVICE_ALREADY_RUNNING = '420';
    const WIN32_ERROR_SERVICE_CANNOT_ACCEPT_CTRL = '425';
    const WIN32_ERROR_SERVICE_DATABASE_LOCKED = '41F';
    const WIN32_ERROR_SERVICE_DEPENDENCY_DELETED = '433';
    const WIN32_ERROR_SERVICE_DEPENDENCY_FAIL = '42C';
    const WIN32_ERROR_SERVICE_DISABLED = '422';
    const WIN32_ERROR_SERVICE_DOES_NOT_EXIST = '424';
    const WIN32_ERROR_SERVICE_EXISTS = '431';
    const WIN32_ERROR_SERVICE_LOGON_FAILED = '42D';
    const WIN32_ERROR_SERVICE_MARKED_FOR_DELETE = '430';
    const WIN32_ERROR_SERVICE_NO_THREAD = '41E';
    const WIN32_ERROR_SERVICE_NOT_ACTIVE = '426';
    const WIN32_ERROR_SERVICE_REQUEST_TIMEOUT = '41D';
    const WIN32_ERROR_SHUTDOWN_IN_PROGRESS = '45B';
    const WIN32_NO_ERROR = '0';
 
    const SERVER_ERROR_IGNORE = '0';
    const SERVER_ERROR_NORMAL = '1';
 
    const SERVICE_AUTO_START = '2';
    const SERVICE_DEMAND_START = '3';
    const SERVICE_DISABLED = '4';
 
    const PENDING_TIMEOUT = 20;
    const SLEEP_TIME = 100000;
 
    const VBS_NAME = 'Name';
    const VBS_DISPLAY_NAME = 'DisplayName';
    const VBS_DESCRIPTION = 'Description';
    const VBS_PATH_NAME = 'PathName';
    const SERVICE_STATE = 'State';
 
    private $name;
    private $displayName;
    private $binPath;
    private $params;
    private $startType;
    private $errorControl;
    private $nssm;
 
    private $latestStatus;
    private $latestError;
 
    // Cache for service list to speed up bulk operations
    private static $serviceListCache = null;
 
    // Track which functions have been logged to avoid duplicate log entries
    private static $loggedFunctions = array();

    public function __construct($name)
    {
        Log::initClass( $this );
        $this->name = $name;
    }

    private function writeLog($log): void
    {
        global $bearsamppRoot;
        Log::debug( $log, Path::getServicesLogFilePath() );
    }

    public static function getVbsKeys(): array
    {
        return array(
            self::VBS_NAME,
            self::VBS_DISPLAY_NAME,
            self::VBS_DESCRIPTION,
            self::VBS_PATH_NAME,
            self::SERVICE_STATE
        );
    }

    public static function getServices($forceRefresh = false)
    {
        if (self::$serviceListCache === null || $forceRefresh) {
            Log::trace('Fetching service list from Windows (COM/WMI)');
            $startTime = microtime(true);
            $services = Win32Native::listServices(self::getVbsKeys());
            
            self::$serviceListCache = [];
            if (is_array($services)) {
                foreach ($services as $service) {
                    if (isset($service[self::VBS_NAME])) {
                        self::$serviceListCache[$service[self::VBS_NAME]] = $service;
                    }
                }
            }
            $duration = round(microtime(true) - $startTime, 3);
            Log::trace('Service list fetched in ' . $duration . 's');
        }
        
        return self::$serviceListCache;
    }

    private function callWin32Service($function, $param, $checkError = false): mixed
    {
        $result = false;
        if ( function_exists( $function ) ) {
            if (!isset(self::$loggedFunctions[$function])) {
                Log::trace('Win32 function: ' . $function . ' exists');
                self::$loggedFunctions[$function] = true;
            }
 
            // Special handling for win32_query_service_status to prevent hanging
            if ($function === 'win32_query_service_status') {
                Log::trace("Using enhanced handling for win32_query_service_status");
 
                // Set a shorter timeout for this specific function
                $originalTimeout = ini_get('max_execution_time');
                set_time_limit(5); // 5 seconds timeout
 
                try {
                    // Ensure proper parameter handling for PHP 8.5.7 compatibility
                    $result = call_user_func($function, $param);
 
                    // Reset the timeout
                    set_time_limit($originalTimeout);
 
                    if ($checkError && $result !== null) {
                        // Convert to int before using dechex for PHP 8.5.7 compatibility
                        $resultInt = is_numeric($result) ? (int)$result : 0;
                        if (dechex($resultInt) != self::WIN32_NO_ERROR) {
                            $this->latestError = dechex($resultInt);
                        }
                    }
                } catch (\Win32ServiceException $e) {
                    // Reset the timeout
                    set_time_limit($originalTimeout);
 
                    Log::trace("Win32ServiceException caught: " . $e->getMessage());
 
                    // Handle "service does not exist" exception
                    if (strpos($e->getMessage(), 'service does not exist') !== false) {
                        Log::trace("Service does not exist exception handled for: " . $param);
                        // Return the appropriate error code for "service does not exist"
                        $result = hexdec(self::WIN32_ERROR_SERVICE_DOES_NOT_EXIST);
                    } else {
                        // For other exceptions, log and return false
                        Log::trace("Unhandled Win32ServiceException: " . $e->getMessage());
                        $result = false;
                    }
                } catch (\Exception $e) {
                    // Reset the timeout
                    set_time_limit($originalTimeout);
 
                    // Catch any other exceptions to prevent application freeze
                    Log::trace("Exception caught in callWin32Service: " . $e->getMessage());
                    $result = false;
                } catch (\Throwable $e) {
                    // Reset the timeout
                    set_time_limit($originalTimeout);
 
                    // Catch any other throwable (PHP 7+) to prevent application freeze
                    Log::trace("Throwable caught in callWin32Service: " . $e->getMessage());
                    $result = false;
                }
            } else {
                // Standard handling for other functions
                try {
                    // Ensure proper parameter handling for PHP 8.5.7 compatibility
                    $result = call_user_func($function, $param);
                    if ($checkError && $result !== null) {
                        // Convert to int before using dechex for PHP 8.5.7 compatibility
                        $resultInt = is_numeric($result) ? (int)$result : 0;
                        if (dechex($resultInt) != self::WIN32_NO_ERROR) {
                            $this->latestError = dechex($resultInt);
                        }
                    }
                } catch (\Win32ServiceException $e) {
                    Log::trace("Win32ServiceException caught: " . $e->getMessage());
 
                    // Handle "service does not exist" exception
                    if (strpos($e->getMessage(), 'service does not exist') !== false) {
                        Log::trace("Service does not exist exception handled for: " . $param);
                        // Return the appropriate error code for "service does not exist"
                        $result = hexdec(self::WIN32_ERROR_SERVICE_DOES_NOT_EXIST);
                    } else {
                        // For other exceptions, log and return false
                        Log::trace("Unhandled Win32ServiceException: " . $e->getMessage());
                        $result = false;
                    }
                } catch (\Exception $e) {
                    // Catch any other exceptions to prevent application freeze
                    Log::trace("Exception caught in callWin32Service: " . $e->getMessage());
                    $result = false;
                } catch (\Throwable $e) {
                    // Catch any other throwable (PHP 7+) to prevent application freeze
                    Log::trace("Throwable caught in callWin32Service: " . $e->getMessage());
                    $result = false;
                }
            }
        } else {
            if (!isset(self::$loggedFunctions[$function])) {
                Log::trace('Win32 function: ' . $function . ' missing');
                self::$loggedFunctions[$function] = true;
            }
        }
        return $result;
    }

    public function status($timeout = true): string
    {
        $this->latestStatus = self::WIN32_SERVICE_NA;
        $maxtime            = time() + self::PENDING_TIMEOUT;
 
        Log::trace("Querying status for service: " . $this->getName() . " (timeout: " . ($timeout ? "enabled" : "disabled") . ")");
        if ($timeout) {
            Log::trace("Max timeout time set to: " . date('Y-m-d H:i:s', $maxtime));
        }
 
        // Add a safety counter to prevent infinite loops
        $loopCount = 0;
        $maxLoops = 5; // Maximum number of attempts
        $startTime = microtime(true);
 
        try {
            while ( ($this->latestStatus == self::WIN32_SERVICE_NA || $this->isPending( $this->latestStatus )) && $loopCount < $maxLoops ) {
                $loopCount++;
                Log::trace("Calling win32_query_service_status for service: " . $this->getName() . " (attempt " . $loopCount . " of " . $maxLoops . ")");
 
                // Add a timeout check before making the call
                if (microtime(true) - $startTime > 10) { // 10 seconds overall timeout
                    Log::trace("Overall timeout reached before making service status call");
                    break;
                }
 
                $this->latestStatus = $this->callWin32Service( 'win32_query_service_status', $this->getName() );
 
                if ( is_array( $this->latestStatus ) && isset( $this->latestStatus['CurrentState'] ) ) {
                    // Ensure proper type conversion for PHP 8.5.7 compatibility
                    $stateInt = is_numeric($this->latestStatus['CurrentState']) ? (int)$this->latestStatus['CurrentState'] : 0;
                    $this->latestStatus = dechex( $stateInt );
                    Log::trace("Service status returned as array, CurrentState: " . $this->latestStatus);
                }
                elseif ( $this->latestStatus !== null ) {
                    // Ensure proper type conversion for PHP 8.5.7 compatibility
                    $statusInt = is_numeric($this->latestStatus) ? (int)$this->latestStatus : 0;
                    $statusHex = dechex( $statusInt );
                    Log::trace("Service status returned as value: " . $statusHex);
 
                    if ( $statusHex == self::WIN32_ERROR_SERVICE_DOES_NOT_EXIST ) {
                        $this->latestStatus = $statusHex;
                        Log::trace("Service does not exist, breaking loop");
                        break; // Exit the loop immediately if service doesn't exist
                    }
                } else {
                    Log::trace("Service status query returned null");
                    // If we get a null result, assume service does not exist to avoid hanging
                    if ($loopCount >= 2) // Only do this after at least one retry
                    {
                        Log::trace("Multiple null results, assuming service does not exist");
                        $this->latestStatus = self::WIN32_ERROR_SERVICE_DOES_NOT_EXIST;
                        break;
                    }
                }
 
                if ( $timeout && $maxtime < time() ) {
                    Log::trace("Timeout reached while querying service status");
                    break;
                }
 
                // Only sleep if we're going to loop again
                if ($loopCount < $maxLoops && ($this->latestStatus == self::WIN32_SERVICE_NA || $this->isPending($this->latestStatus))) {
                    Log::trace("Sleeping before next status check attempt");
                    usleep(self::SLEEP_TIME);
                }
            }
        } catch (\Exception $e) {
            Log::trace("Exception in status method: " . $e->getMessage());
            // If an exception occurs, assume service does not exist
            $this->latestStatus = self::WIN32_ERROR_SERVICE_DOES_NOT_EXIST;
        } catch (\Throwable $e) {
            Log::trace("Throwable in status method: " . $e->getMessage());
            // If a throwable occurs, assume service does not exist
            $this->latestStatus = self::WIN32_ERROR_SERVICE_DOES_NOT_EXIST;
        }
 
        if ($loopCount >= $maxLoops) {
            Log::trace("Maximum query attempts reached for service: " . $this->getName());
        }
 
        $elapsedTime = microtime(true) - $startTime;
        Log::trace("Status check completed in " . round($elapsedTime, 2) . " seconds after " . $loopCount . " attempts");
 
        if ( $this->latestStatus == self::WIN32_ERROR_SERVICE_DOES_NOT_EXIST ) {
            $this->latestError  = $this->latestStatus;
            $this->latestStatus = self::WIN32_SERVICE_NA;
            Log::trace("Service does not exist, setting status to NA");
        }
 
        Log::trace("Final status for service " . $this->getName() . ": " . $this->latestStatus);
        return $this->latestStatus;
    }

    public function create(): bool
    {
        global $bearsamppBins;
 
        Log::trace("Starting Win32Service::create for service: " . $this->getName());
 
        if ( $this->getName() == BinPostgresql::SERVICE_NAME ) {
            Log::trace("PostgreSQL service detected - using specialized installation");
            $bearsamppBins->getPostgresql()->rebuildConf();
            Log::trace("PostgreSQL configuration rebuilt");
 
            $bearsamppBins->getPostgresql()->initData();
            Log::trace("PostgreSQL data initialized");
 
            $result = Batch::installPostgresqlService();
            Log::trace("PostgreSQL service installation " . ($result ? "succeeded" : "failed"));
            return $result;
        }
 
        if ( $this->getNssm() instanceof Nssm ) {
            Log::trace("Using NSSM for service installation");
 
            // Ensure Tools are loaded before building environment paths
            global $bearsamppTools;
            if (!isset($bearsamppTools)) {
                Log::trace("Tools not loaded, forcing synchronous load");
                Root::loadTools();
            }
 
            global $bearsamppRegistry;
            $nssmEnvPath = $bearsamppRegistry->getAppBinsRegKey( false );
            Log::trace("NSSM environment path (bins): " . $nssmEnvPath);
 
            $nssmEnvPath .= Path::getNssmEnvPaths();
            Log::trace("NSSM environment path (with additional paths): " . $nssmEnvPath);
 
            $nssmEnvPath .= '%SystemRoot%/system32;';
            $nssmEnvPath .= '%SystemRoot%;';
            $nssmEnvPath .= '%SystemRoot%/system32/Wbem;';
            $nssmEnvPath .= '%SystemRoot%/system32/WindowsPowerShell/v1.0';
            Log::trace("NSSM final environment PATH: " . $nssmEnvPath);
 
            $this->getNssm()->setEnvironmentExtra( 'PATH=' . $nssmEnvPath );
            Log::trace("NSSM service parameters:");
            Log::trace("-> Name: " . $this->getNssm()->getName());
            Log::trace("-> DisplayName: " . $this->getNssm()->getDisplayName());
            Log::trace("-> BinPath: " . $this->getNssm()->getBinPath());
            Log::trace("-> Params: " . $this->getNssm()->getParams());
            Log::trace("-> Start: " . $this->getNssm()->getStart());
            Log::trace("-> Stdout: " . $this->getNssm()->getStdout());
            Log::trace("-> Stderr: " . $this->getNssm()->getStderr());
 
            $result = $this->getNssm()->create();
            Log::trace("NSSM service creation " . ($result ? "succeeded" : "failed"));
            if (!$result) {
                Log::trace("NSSM error: " . $this->getNssm()->getLatestError());
            }
            return $result;
        }
 
        Log::trace("Using win32_create_service for service installation");
        $serviceParams = array(
            'service'       => $this->getName(),
            'display'       => $this->getDisplayName(),
            'description'   => $this->getDisplayName(),
            'path'          => $this->getBinPath(),
            'params'        => $this->getParams(),
            'start_type'    => $this->getStartType() != null ? $this->getStartType() : self::SERVICE_DEMAND_START,
            'error_control' => $this->getErrorControl() != null ? $this->getErrorControl() : self::SERVER_ERROR_NORMAL,
        );
 
        Log::trace("win32_create_service parameters:");
        foreach ($serviceParams as $key => $value) {
            Log::trace("-> $key: $value");
        }
 
        $result = $this->callWin32Service( 'win32_create_service', $serviceParams, true );
        // Ensure proper type conversion for PHP 8.5.7 compatibility
        $resultInt = is_numeric($result) ? (int)$result : 0;
        $create = $result !== null ? dechex( $resultInt ) : '0';
        Log::trace("win32_create_service result code: " . $create);
 
        // Retry once if the SCM has the service marked for deletion from a recent delete()
        if ( $create == self::WIN32_ERROR_SERVICE_MARKED_FOR_DELETE ) {
            Log::trace("Service marked for delete, waiting 2s before retry: " . $this->getName());
            usleep( 2000000 );
            $result   = $this->callWin32Service( 'win32_create_service', $serviceParams, true );
            $resultInt = is_numeric($result) ? (int)$result : 0;
            $create   = $result !== null ? dechex( $resultInt ) : '0';
            Log::trace("win32_create_service retry result code: " . $create);
        }
 
        $this->writeLog( 'Create service: ' . $create . ' (status: ' . $this->status() . ')' );
        $this->writeLog( '-> service: ' . $this->getName() );
        $this->writeLog( '-> display: ' . $this->getDisplayName() );
        $this->writeLog( '-> description: ' . $this->getDisplayName() );
        $this->writeLog( '-> path: ' . $this->getBinPath() );
        $this->writeLog( '-> params: ' . $this->getParams() );
        $this->writeLog( '-> start_type: ' . ($this->getStartType() != null ? $this->getStartType() : self::SERVICE_DEMAND_START) );
        $this->writeLog( '-> service: ' . ($this->getErrorControl() != null ? $this->getErrorControl() : self::SERVER_ERROR_NORMAL) );
 
        if ( $create != self::WIN32_NO_ERROR ) {
            Log::trace("Service creation failed with error code: " . $create);
            return false;
        }
        elseif ( !$this->isInstalled() ) {
            Log::trace("Service created but not found as installed");
            $this->latestError = self::WIN32_NO_ERROR;
            return false;
        }
 
        Log::trace("Service created successfully: " . $this->getName());
        return true;
    }

    public function delete(): bool
    {
        Log::trace("Starting Win32Service::delete for service: " . $this->getName());
        Log::trace("Checking if service is installed: " . $this->getName());
 
        if ( !$this->isInstalled() ) {
            Log::trace("Service is not installed, skipping deletion: " . $this->getName());
            return true;
        }
 
        Log::trace("Stopping service before deletion: " . $this->getName());
        $this->stop();
 
        if ( $this->getNssm() instanceof Nssm ) {
            $childExe = basename( $this->getNssm()->getBinPath() );
            Log::trace("Killing NSSM child process after stop: " . $childExe);
            Win32Ps::killBins( [$childExe] );
        }
 
        if ( $this->getName() == BinPostgresql::SERVICE_NAME ) {
            Log::trace("PostgreSQL service detected - using specialized uninstallation");
            $result = Batch::uninstallPostgresqlService();
            Log::trace("PostgreSQL service uninstallation " . ($result ? "succeeded" : "failed"));
            return $result;
        }
 
        Log::trace("Calling win32_delete_service for service: " . $this->getName());
        $result = $this->callWin32Service( 'win32_delete_service', $this->getName(), true );
        // Ensure proper type conversion for PHP 8.5.7 compatibility
        $resultInt = is_numeric($result) ? (int)$result : 0;
        $delete = $result !== null ? dechex( $resultInt ) : '0';
        Log::trace("Delete service result code: " . $delete);
        $this->writeLog( 'Delete service ' . $this->getName() . ': ' . $delete . ' (status: ' . $this->status() . ')' );
 
        if ( $delete != self::WIN32_NO_ERROR && $delete != self::WIN32_ERROR_SERVICE_DOES_NOT_EXIST ) {
            return false;
        }
        elseif ( $this->isInstalled() ) {
            $this->latestError = self::WIN32_NO_ERROR;
 
            return false;
        }
 
        return true;
    }

    public function reset(): bool
    {
        if ( $this->delete() ) {
            usleep( self::SLEEP_TIME );
 
            return $this->create();
        }
 
        return false;
    }

    public function start(): bool
    {
        global $bearsamppBins;
 
        Log::info('Attempting to start service: ' . $this->getName());
 
        if ( $this->getName() == BinMysql::SERVICE_NAME ) {
            $bearsamppBins->getMysql()->initData();
        }
        elseif ( $this->getName() == BinMariadb::SERVICE_NAME ) {
            $bearsamppBins->getMariadb()->initData();
        }
        elseif ( $this->getName() == BinMailpit::SERVICE_NAME ) {
            $bearsamppBins->getMailpit()->rebuildConf();
        }
        elseif ( $this->getName() == BinMemcached::SERVICE_NAME ) {
            $bearsamppBins->getMemcached()->rebuildConf();
        }
        elseif ( $this->getName() == BinPostgresql::SERVICE_NAME ) {
            $bearsamppBins->getPostgresql()->rebuildConf();
            $bearsamppBins->getPostgresql()->initData();
        }
        elseif ( $this->getName() == BinXlight::SERVICE_NAME ) {
            $bearsamppBins->getXlight()->rebuildConf();
        }
 
 
        $result = $this->callWin32Service( 'win32_start_service', $this->getName(), true );
        // Ensure proper type conversion for PHP 8.5.7 compatibility
        $resultInt = is_numeric($result) ? (int)$result : 0;
        $start = $result !== null ? dechex( $resultInt ) : '0';
        Log::debug( 'Start service ' . $this->getName() . ': ' . $start . ' (status: ' . $this->status() . ')' );
 
        if ( $start != self::WIN32_NO_ERROR && $start != self::WIN32_ERROR_SERVICE_ALREADY_RUNNING ) {
 
            // Write error to log
            Log::error('Failed to start service: ' . $this->getName() . ' with error code: ' . $start);
 
            if ( $this->getName() == BinApache::SERVICE_NAME ) {
                $cmdOutput = $bearsamppBins->getApache()->getCmdLineOutput( BinApache::CMD_SYNTAX_CHECK );
                if ( !$cmdOutput['syntaxOk'] ) {
                    file_put_contents(
                        $bearsamppBins->getApache()->getErrorLog(),
                        '[' . date( 'Y-m-d H:i:s', time() ) . '] [error] ' . $cmdOutput['content'] . PHP_EOL,
                        FILE_APPEND
                    );
                }
            }
            elseif ( $this->getName() == BinMysql::SERVICE_NAME ) {
                $cmdOutput = $bearsamppBins->getMysql()->getCmdLineOutput( BinMysql::CMD_SYNTAX_CHECK );
                if ( !$cmdOutput['syntaxOk'] ) {
                    file_put_contents(
                        $bearsamppBins->getMysql()->getErrorLog(),
                        '[' . date( 'Y-m-d H:i:s', time() ) . '] [error] ' . $cmdOutput['content'] . PHP_EOL,
                        FILE_APPEND
                    );
                }
            }
            elseif ( $this->getName() == BinMariadb::SERVICE_NAME ) {
                $cmdOutput = $bearsamppBins->getMariadb()->getCmdLineOutput( BinMariadb::CMD_SYNTAX_CHECK );
                if ( !$cmdOutput['syntaxOk'] ) {
                    file_put_contents(
                        $bearsamppBins->getMariadb()->getErrorLog(),
                        '[' . date( 'Y-m-d H:i:s', time() ) . '] [error] ' . $cmdOutput['content'] . PHP_EOL,
                        FILE_APPEND
                    );
                }
            }
 
            return false;
        }
 
        // Wait for the service to actually start before checking if it's running
        // We use a timeout to avoid hanging if the service fails to start properly
        $maxtime = time() + self::PENDING_TIMEOUT;
        while ($this->isPending($this->status(false)) && time() < $maxtime) {
            usleep(self::SLEEP_TIME);
        }
 
        if ( !$this->isRunning() ) {
            $this->latestError = self::WIN32_NO_ERROR;
            Log::error('Service ' . $this->getName() . ' is not running after start attempt (status: ' . $this->status() . ').');
            $this->latestError = null;
            return false;
        }
 
        Log::info('Service ' . $this->getName() . ' started successfully.');
        return true;
    }

    public function stop(): bool
    {
        Log::trace("Starting Win32Service::stop for service: " . $this->getName());
 
        Log::trace("Calling win32_stop_service for service: " . $this->getName());
        $result = $this->callWin32Service( 'win32_stop_service', $this->getName(), true );
 
        // Ensure proper type conversion for PHP 8.5.7 compatibility
        $resultInt = is_numeric($result) ? (int)$result : 0;
        $stop = $result !== null ? dechex( $resultInt ) : '0';
        Log::trace("Stop service result code: " . $stop);
 
        Log::trace("Checking current status after stop attempt");
        $currentStatus = $this->status();
        Log::trace("Current status: " . $currentStatus);
 
        $this->writeLog( 'Stop service ' . $this->getName() . ': ' . $stop . ' (status: ' . $currentStatus . ')' );
 
        if ( $stop != self::WIN32_NO_ERROR ) {
            return false;
        }
 
        // Wait for the service to actually stop before checking if it's stopped
        $maxtime = time() + self::PENDING_TIMEOUT;
        while ($this->isPending($this->status(false)) && time() < $maxtime) {
            usleep(self::SLEEP_TIME);
        }
 
        if ( !$this->isStopped() ) {
            $this->latestError = self::WIN32_NO_ERROR;
            Log::error('Service ' . $this->getName() . ' is still running after stop attempt (status: ' . $this->status() . ').');
            $this->latestError = null;
            return false;
        }
 
        return true;
    }

    public function restart(): bool
    {
        if ( $this->stop() ) {
            return $this->start();
        }
 
        return false;
    }

    public function fastServiceCheck()
    {
        Log::trace("Starting fastServiceCheck for service: " . $this->getName());
 
        $startTime = microtime(true);
 
        // Use sc.exe to query service - this is very fast and reliable
        // Execute with hidden window to prevent command prompt flash
        Log::trace("Executing: sc query " . $this->getName());
 
        $output = CommandRunner::execCombined('sc', ['query', $this->getName()]);
        $duration = round(microtime(true) - $startTime, 3);
 
        Log::trace("sc.exe query completed in " . $duration . "s");
 
        if ($output === null || $output === false) {
            Log::trace("sc.exe returned null/false, service likely doesn't exist");
            return false;
        }
 
        // Check if service doesn't exist
        if (stripos($output, 'does not exist') !== false ||
            stripos($output, 'FAILED') !== false ||
            stripos($output, '1060') !== false) {  // Error code 1060 = service doesn't exist
            Log::trace("Service doesn't exist: " . $this->getName());
            return false;
        }
 
        // Service exists - parse basic info
        $serviceInfo = [];
 
        // Extract service name
        if (preg_match('/SERVICE_NAME:\s*(.+)/i', $output, $matches)) {
            $serviceInfo[self::VBS_NAME] = trim($matches[1]);
        }
 
        // Extract display name
        if (preg_match('/DISPLAY_NAME:\s*(.+)/i', $output, $matches)) {
            $serviceInfo[self::VBS_DISPLAY_NAME] = trim($matches[1]);
        }
 
        // Extract state
        if (preg_match('/STATE\s*:\s*\d+\s+(\w+)/i', $output, $matches)) {
            $state = trim($matches[1]);
            $serviceInfo[self::SERVICE_STATE] = $state;
            Log::trace("Service state: " . $state);
        }
 
        // If we have basic info, service exists - get full details if needed
        if (!empty($serviceInfo)) {
            Log::trace("Service exists, getting full details");
 
            // Use sc qc to get configuration details (including path)
            $configOutput = CommandRunner::execCombined('sc', ['qc', $this->getName()]);
 
            if ($configOutput !== null && $configOutput !== false && preg_match('/BINARY_PATH_NAME\s*:\s*(.+)/i', $configOutput, $matches)) {
                $serviceInfo[self::VBS_PATH_NAME] = trim($matches[1]);
                Log::trace("Service path: " . $serviceInfo[self::VBS_PATH_NAME]);
            }
 
            // Get description if available
            if ($configOutput !== null && $configOutput !== false && preg_match('/DISPLAY_NAME\s*:\s*(.+)/i', $configOutput, $matches)) {
                $serviceInfo[self::VBS_DESCRIPTION] = trim($matches[1]);
            }
 
            Log::trace("Fast service check successful for: " . $this->getName());
            return $serviceInfo;
        }
 
        Log::trace("Could not parse service info from sc.exe output");
        return false;
    }

    public function infos()
    {
        Log::trace("Starting Win32Service::infos for service: " . $this->getName());
 
        try {
            // Set a timeout for the entire operation
            $startTime = microtime(true);
            $timeout = 10; // 10 seconds timeout for the entire operation
 
            if ($this->getNssm() instanceof Nssm) {
                Log::trace("Using NSSM to get service info");
                $result = $this->getNssm()->infos();
                Log::trace("NSSM info retrieval completed in " . round(microtime(true) - $startTime, 2) . " seconds");
                return $result;
            }
 
            // Performance optimization: Try fast sc.exe check first
            Log::trace("Attempting fast service check using sc.exe");
            $fastResult = $this->fastServiceCheck();
 
            if ($fastResult !== false) {
                $duration = round(microtime(true) - $startTime, 3);
                Log::trace("Fast service check succeeded in " . $duration . "s (saved 5-10s)");
                Log::debug("Performance: Fast service check used for " . $this->getName() . ", saved 5-10 seconds");
                return $fastResult;
            }
 
            // Fast check returned false - service doesn't exist
            if ($fastResult === false) {
                $duration = round(microtime(true) - $startTime, 3);
                Log::trace("Fast service check determined service doesn't exist in " . $duration . "s");
                return false;
            }
 
            // Fallback to VBS (should rarely be needed now)
            Log::trace("Falling back to VBS for service info");
 
            // Use set_time_limit to prevent PHP script timeout
            $originalTimeout = ini_get('max_execution_time');
            set_time_limit(15); // 15 seconds timeout
 
            // Create a separate process to get service info with a timeout
            $result = Win32Native::getServiceInfo($this->getName());
 
            // Reset the timeout
            set_time_limit($originalTimeout);
 
            // Check if we've exceeded our timeout
            if (microtime(true) - $startTime > $timeout) {
                Log::trace("Timeout exceeded in infos() method, returning false");
                return false;
            }
 
            Log::trace("VBS info retrieval completed in " . round(microtime(true) - $startTime, 2) . " seconds");
            return $result;
        } catch (\Exception $e) {
            Log::trace("Exception in infos() method: " . $e->getMessage() . ", returning false");
            return false;
        } catch (\Throwable $e) {
            Log::trace("Throwable in infos() method: " . $e->getMessage() . ", returning false");
            return false;
        }
    }

    public function isInstalled(): bool
    {
        Log::trace("Checking if service is installed: " . $this->getName());
 
        try {
            // Set a timeout for the entire operation
            $startTime = microtime(true);
            $timeout = 15; // 15 seconds timeout for the entire operation
 
            // Call status() with a try-catch to ensure we don't get stuck
            $status = $this->status();
 
            // Check if we've exceeded our timeout
            if (microtime(true) - $startTime > $timeout) {
                Log::trace("Timeout exceeded in isInstalled() method, assuming service is not installed");
                $this->writeLog('isInstalled ' . $this->getName() . ': NO (timeout exceeded)');
                return false;
            }
 
            $isInstalled = $status != self::WIN32_SERVICE_NA;
 
            Log::trace("Service " . $this->getName() . " installation status: " . ($isInstalled ? "YES" : "NO") . " (status code: " . $status . ")");
            $this->writeLog('isInstalled ' . $this->getName() . ': ' . ($isInstalled ? 'YES' : 'NO') . ' (status: ' . $status . ')');
 
            return $isInstalled;
        } catch (\Exception $e) {
            Log::trace("Exception in isInstalled() method: " . $e->getMessage() . ", assuming service is not installed");
            $this->writeLog('isInstalled ' . $this->getName() . ': NO (exception: ' . $e->getMessage() . ')');
            return false;
        } catch (\Throwable $e) {
            Log::trace("Throwable in isInstalled() method: " . $e->getMessage() . ", assuming service is not installed");
            $this->writeLog('isInstalled ' . $this->getName() . ': NO (throwable: ' . $e->getMessage() . ')');
            return false;
        }
    }

    public function isRunning(): bool
    {
        Log::trace("Checking if service is running: " . $this->getName());
 
        $status = $this->status();
        $isRunning = $status == self::WIN32_SERVICE_RUNNING;
 
        Log::trace("Service " . $this->getName() . " running status: " . ($isRunning ? "YES" : "NO") . " (status code: " . $status . ")");
        $this->writeLog( 'isRunning ' . $this->getName() . ': ' . ($isRunning ? 'YES' : 'NO') . ' (status: ' . $status . ')' );
 
        return $isRunning;
    }

    public function isStopped(): bool
    {
        Log::trace("Checking if service is stopped: " . $this->getName());
 
        $status = $this->status();
        $isStopped = $status == self::WIN32_SERVICE_STOPPED;
 
        Log::trace("Service " . $this->getName() . " stopped status: " . ($isStopped ? "YES" : "NO") . " (status code: " . $status . ")");
        $this->writeLog( 'isStopped ' . $this->getName() . ': ' . ($isStopped ? 'YES' : 'NO') . ' (status: ' . $status . ')' );
 
        return $isStopped;
    }

    public function isPaused(): bool
    {
        Log::trace("Checking if service is paused: " . $this->getName());
 
        $status = $this->status();
        $isPaused = $status == self::WIN32_SERVICE_PAUSED;
 
        Log::trace("Service " . $this->getName() . " paused status: " . ($isPaused ? "YES" : "NO") . " (status code: " . $status . ")");
        $this->writeLog( 'isPaused ' . $this->getName() . ': ' . ($isPaused ? 'YES' : 'NO') . ' (status: ' . $status . ')' );
 
        return $isPaused;
    }

    public function isPending($status): bool
    {
        $isPending = $status == self::WIN32_SERVICE_START_PENDING || $status == self::WIN32_SERVICE_STOP_PENDING
            || $status == self::WIN32_SERVICE_CONTINUE_PENDING || $status == self::WIN32_SERVICE_PAUSE_PENDING;
 
        Log::trace("Checking if status is pending: " . $status . " - Result: " . ($isPending ? "YES" : "NO"));
 
        if ($isPending) {
            if ($status == self::WIN32_SERVICE_START_PENDING) {
                Log::trace("Service is in START_PENDING state");
            } else if ($status == self::WIN32_SERVICE_STOP_PENDING) {
                Log::trace("Service is in STOP_PENDING state");
            } else if ($status == self::WIN32_SERVICE_CONTINUE_PENDING) {
                Log::trace("Service is in CONTINUE_PENDING state");
            } else if ($status == self::WIN32_SERVICE_PAUSE_PENDING) {
                Log::trace("Service is in PAUSE_PENDING state");
            }
        }
 
        return $isPending;
    }

    private function getWin32ServiceStatusDesc($status): ?string
    {
        switch ( $status ) {
            case self::WIN32_SERVICE_CONTINUE_PENDING:
                return 'The service continue is pending.';
 
            case self::WIN32_SERVICE_PAUSE_PENDING:
                return 'The service pause is pending.';
 
            case self::WIN32_SERVICE_PAUSED:
                return 'The service is paused.';
 
            case self::WIN32_SERVICE_RUNNING:
                return 'The service is running.';
 
            case self::WIN32_SERVICE_START_PENDING:
                return 'The service is starting.';
 
            case self::WIN32_SERVICE_STOP_PENDING:
                return 'The service is stopping.';
 
            case self::WIN32_SERVICE_STOPPED:
                return 'The service is not running.';
 
            case self::WIN32_SERVICE_NA:
                return 'Cannot retrieve service status.';
 
            default:
                return null;
        }
    }

    private function getWin32ErrorCodeDesc($code): ?string
    {
        switch ( $code ) {
            case self::WIN32_ERROR_ACCESS_DENIED:
                return 'The handle to the SCM database does not have the appropriate access rights.';
            // ... other cases ...
            default:
                return null;
        }
    }

    public function getName(): string
    {
        return $this->name;
    }

    public function setName($name): void
    {
        $this->name = $name;
    }

    public function getDisplayName(): string
    {
        return $this->displayName;
    }

    public function setDisplayName($displayName): void
    {
        $this->displayName = $displayName;
    }

    public function getBinPath(): string
    {
        return $this->binPath;
    }

    public function setBinPath($binPath): void
    {
        $this->binPath = str_replace( '"', '', Path::formatWindowsPath( $binPath ) );
    }

    public function getParams(): string
    {
        return $this->params;
    }

    public function setParams($params): void
    {
        $this->params = $params;
    }

    public function getStartType(): string
    {
        return $this->startType;
    }

    public function setStartType($startType): void
    {
        $this->startType = $startType;
    }

    public function getErrorControl(): string
    {
        return $this->errorControl;
    }

    public function setErrorControl($errorControl): void
    {
        $this->errorControl = $errorControl;
    }

    public function getNssm()
    {
        return $this->nssm;
    }

    public function setNssm($nssm)
    {
        if ( $nssm instanceof Nssm ) {
            $this->setDisplayName( $nssm->getDisplayName() );
            $this->setBinPath( $nssm->getBinPath() );
            $this->setParams( $nssm->getParams() );
            $this->setStartType( $nssm->getStart() );
            $this->nssm = $nssm;
        }
    }

    public function getLatestStatus()
    {
        return $this->latestStatus;
    }

    public function getLatestError()
    {
        return $this->latestError;
    }

    public function getError()
    {
        global $bearsamppLang;
        if ( $this->latestError != self::WIN32_NO_ERROR ) {
            // Ensure proper type conversion for PHP 8.5.7 compatibility
            $errorInt = is_numeric($this->latestError) ? hexdec( $this->latestError ) : 0;
            return $bearsamppLang->getValue( Lang::ERROR ) . ' ' .
                $this->latestError . ' (' . $errorInt . ' : ' . $this->getWin32ErrorCodeDesc( $this->latestError ) . ')';
        }
        elseif ( $this->latestStatus != self::WIN32_SERVICE_NA ) {
            // Ensure proper type conversion for PHP 8.5.7 compatibility
            $statusInt = is_numeric($this->latestStatus) ? hexdec( $this->latestStatus ) : 0;
            return $bearsamppLang->getValue( Lang::STATUS ) . ' ' .
                $this->latestStatus . ' (' . $statusInt . ' : ' . $this->getWin32ServiceStatusDesc( $this->latestStatus ) . ')';
        }
 
        return null;
    }

    public function waitForServiceDeletion($maxWaitTime = 30): bool
    {
        $startTime = time();
        $maxTime = $startTime + $maxWaitTime;
        $checkCount = 0;
 
        Log::trace("Waiting for service deletion: " . $this->getName() . " (max wait: " . $maxWaitTime . "s)");
 
        while (time() < $maxTime) {
            $checkCount++;
            $status = $this->status(false);
            Log::trace("Service deletion check #" . $checkCount . " - Status: " . $status . " at " . date('Y-m-d H:i:s'));
 
            // Service doesn't exist or is definitely not there
            if ($status == self::WIN32_SERVICE_NA ||
                $status == self::WIN32_ERROR_SERVICE_DOES_NOT_EXIST) {
                $elapsedTime = time() - $startTime;
                Log::trace("Service deletion confirmed after " . $elapsedTime . " seconds");
                return true;
            }
 
            // Wait a bit before checking again
            usleep(500000); // 0.5 seconds
        }
 
        $totalWaitTime = time() - $startTime;
        Log::trace("Service deletion timeout after " . $totalWaitTime . " seconds - service still exists: " . $this->getName());
        return false;
    }

    public function ensureReset(): bool
    {
        Log::trace("Starting ensureReset for service: " . $this->getName());
 
        // First, make sure service is stopped
        if ($this->isRunning()) {
            Log::trace("Service is still running, stopping it first");
            if (!$this->stop()) {
                Log::trace("Failed to stop service during ensureReset");
                return false;
            }
            usleep(1000000); // 1 second wait after stop
        }
 
        // Delete the service
        Log::trace("Deleting service");
        if (!$this->delete()) {
            Log::trace("Service deletion failed, but continuing with wait");
        }
 
        // Wait for the service to be completely removed
        if (!$this->waitForServiceDeletion(30)) {
            Log::trace("Service deletion did not complete within timeout, but continuing");
            // Even if we timeout, give it a moment and try to create anyway
            usleep(2000000); // 2 seconds
        }
 
        Log::trace("ensureReset completed for service: " . $this->getName());
        return true;
    }
}