Static Public Member Functions
static	getAllServiceNames ()
static	getBinFromServiceName ($serviceName, $bearsamppBins)
static	getServiceDisplayName ($bin, $service)
static	getServicePort ($serviceName, $bearsamppBins)
static	getSyntaxCheckCmd ($serviceName, $bearsamppBins=null)
static	hasSyntaxCheck ($serviceName)
static	installService ($bin, $port, $syntaxCheckCmd, $showWindow=false)
static	isPortInUse ($port)
static	processServices ($bearsamppBins, callable $callback)
static	removeService ($service, $name)
static	startAllServicesParallel ($serviceInfos, ?callable $progressCallback=null, $startupTimeout=30)
static	startService ($bin, $syntaxCheckCmd=null, $showWindow=false)
static	stopAllServicesParallel ($bearsamppBins, ?callable $progressCallback=null, $shutdownTimeout=15)
static	stopService ($service)

Static Private Member Functions
static	allServicesRunning ($serviceInfos)
static	allServicesStopped ($services)
static	forceKillService ($serviceName)
static	initializeMappings ($bearsamppBins)
static	shutdownServicesParallel ($services, ?callable $progressCallback=null, $shutdownTimeout=15)
static	shutdownServicesSequential ($services, ?callable $progressCallback=null)
static	startServicesParallel ($serviceInfos, ?callable $progressCallback=null, $startupTimeout=30)
static	startServicesSequential ($serviceInfos, ?callable $progressCallback=null)

Static Private Attributes
static	$serviceMap = null
static	$syntaxCheckMap = null

Detailed Description

Class ServiceHelper

Utility class for service management operations. Provides centralized methods for service lookup, syntax check commands, and common service operations to eliminate code duplication.

Definition at line 17 of file class.servicehelper.php.

Member Function Documentation

◆ allServicesRunning()

allServicesRunning ( $serviceInfos )

staticprivate

Check if all services are running

Parameters

array $serviceInfos Array of service information

Returns: bool True if all services are running

Definition at line 778 of file class.servicehelper.php.

    {
        foreach ($serviceInfos as $serviceName => $serviceInfo) {
            $service = $serviceInfo['service'];
            if (!$service->isRunning()) {
                return false;
            }
        }
 
        return true;
    }

Referenced by startServicesParallel(), and startServicesSequential().

Here is the caller graph for this function:

◆ allServicesStopped()

allServicesStopped ( $services )

staticprivate

Check if all services are stopped

Parameters

array $services Array of services

Returns: bool True if all services are stopped

Definition at line 588 of file class.servicehelper.php.

    {
        foreach ($services as $serviceName => $service) {
            if (!$service->isStopped()) {
                return false;
            }
        }
 
        return true;
    }

Referenced by shutdownServicesParallel(), and shutdownServicesSequential().

Here is the caller graph for this function:

◆ forceKillService()

forceKillService ( $serviceName )

staticprivate

Force kill a service by process name

Parameters

string $serviceName The service name

Returns: bool True if force kill was executed

Definition at line 558 of file class.servicehelper.php.

    {
        $processMap = [
            BinApache::SERVICE_NAME     => 'httpd.exe',
            BinMysql::SERVICE_NAME      => 'mysqld.exe',
            BinMariadb::SERVICE_NAME    => 'mysqld.exe',
            BinMailpit::SERVICE_NAME    => 'mailpit.exe',
            BinMemcached::SERVICE_NAME  => 'memcached.exe',
            BinPostgresql::SERVICE_NAME => 'postgres.exe',
            BinXlight::SERVICE_NAME     => 'xlightftpd.exe',
            'nodejs'                    => 'node.exe',  // NodeJS - not a Windows service but needs to be killed on exit
        ];
 
        if (isset($processMap[$serviceName])) {
            Log::trace('Killing process: ' . $processMap[$serviceName]);
            Win32Ps::killBins([$processMap[$serviceName]]);
 
            return true;
        }
 
        return false;
    }

References Win32Ps\killBins(), BinApache\SERVICE_NAME, BinMailpit\SERVICE_NAME, BinMariadb\SERVICE_NAME, BinMemcached\SERVICE_NAME, BinMysql\SERVICE_NAME, BinPostgresql\SERVICE_NAME, BinXlight\SERVICE_NAME, and Log\trace().

Referenced by shutdownServicesParallel(), and shutdownServicesSequential().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAllServiceNames()

getAllServiceNames ( )

static

Get all service names

Returns: array Array of service name constants

Definition at line 340 of file class.servicehelper.php.

    {
        return [
            BinApache::SERVICE_NAME,
            BinMysql::SERVICE_NAME,
            BinMariadb::SERVICE_NAME,
            BinMailpit::SERVICE_NAME,
            BinMemcached::SERVICE_NAME,
            BinPostgresql::SERVICE_NAME,
            BinXlight::SERVICE_NAME,
        ];
    }

References BinApache\SERVICE_NAME, BinMailpit\SERVICE_NAME, BinMariadb\SERVICE_NAME, BinMemcached\SERVICE_NAME, BinMysql\SERVICE_NAME, BinPostgresql\SERVICE_NAME, and BinXlight\SERVICE_NAME.

◆ getBinFromServiceName()

getBinFromServiceName	(		$serviceName,
			$bearsamppBins )

static

Get binary instance from service name

Parameters

string	$serviceName	The service name
object	$bearsamppBins	The bins object

Returns: object|null The binary instance or null if not found

Definition at line 71 of file class.servicehelper.php.

    {
        self::initializeMappings($bearsamppBins);
 
        return isset(self::$serviceMap[$serviceName]) ? self::$serviceMap[$serviceName] : null;
    }

References $bearsamppBins, and initializeMappings().

Referenced by getServicePort(), processServices(), and ActionRestartAllServices\processWindow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getServiceDisplayName()

getServiceDisplayName	(		$bin,
			$service )

static

Get service display name (Name + Version + Service Name)

Parameters

object	$bin	The binary instance
object	$service	The service instance

Returns: string The formatted service name

Definition at line 103 of file class.servicehelper.php.

    {
        return $bin->getName() . ' ' . $bin->getVersion() . ' (' . $service->getName() . ')';
    }

Referenced by ActionRestartAllServices\processWindow(), and ActionStartAllServices\processWindow().

Here is the caller graph for this function:

◆ getServicePort()

getServicePort	(		$serviceName,
			$bearsamppBins )

static

Get port for a service

Parameters

string	$serviceName	The service name
object	$bearsamppBins	The bins object

Returns: int The port number or 0 if not applicable

Definition at line 382 of file class.servicehelper.php.

    {
        $bin = self::getBinFromServiceName($serviceName, $bearsamppBins);
        if ($bin === null) {
            return 0;
        }
 
        // Different services have different methods to get port
        if (method_exists($bin, 'getPort')) {
            return $bin->getPort();
        } elseif (method_exists($bin, 'getSmtpPort')) {
            return $bin->getSmtpPort();
        }
 
        return 0;
    }

References $bearsamppBins, and getBinFromServiceName().

Here is the call graph for this function:

◆ getSyntaxCheckCmd()

getSyntaxCheckCmd	(		$serviceName,
			$bearsamppBins = null )

static

Get syntax check command for a service

Parameters

string	$serviceName	The service name
object	$bearsamppBins	The bins object (for initialization)

Returns: string|null The syntax check command or null if not applicable

Definition at line 86 of file class.servicehelper.php.

    {
        if ($bearsamppBins !== null) {
            self::initializeMappings($bearsamppBins);
        }
 
        return isset(self::$syntaxCheckMap[$serviceName]) ? self::$syntaxCheckMap[$serviceName] : null;
    }

References $bearsamppBins, and initializeMappings().

Referenced by processServices(), and ActionRestartAllServices\processWindow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasSyntaxCheck()

hasSyntaxCheck ( $serviceName )

static

Check if a service has syntax check capability

Parameters

string $serviceName The service name

Returns: bool True if service supports syntax check

Definition at line 360 of file class.servicehelper.php.

    {
        if (self::$syntaxCheckMap === null) {
            // Initialize with dummy bins object if needed
            self::$syntaxCheckMap = [
                BinApache::SERVICE_NAME  => BinApache::CMD_SYNTAX_CHECK,
                BinMysql::SERVICE_NAME   => BinMysql::CMD_SYNTAX_CHECK,
                BinMariadb::SERVICE_NAME => BinMariadb::CMD_SYNTAX_CHECK,
            ];
        }
 
        return isset(self::$syntaxCheckMap[$serviceName]);
    }

References BinApache\CMD_SYNTAX_CHECK, BinMariadb\CMD_SYNTAX_CHECK, BinMysql\CMD_SYNTAX_CHECK, BinApache\SERVICE_NAME, BinMariadb\SERVICE_NAME, and BinMysql\SERVICE_NAME.

◆ initializeMappings()

initializeMappings ( $bearsamppBins )

staticprivate

Initialize service mappings

Parameters

object $bearsamppBins The bins object

Returns: void

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

    {
        if (self::$serviceMap === null) {
            self::$serviceMap = [
                BinApache::SERVICE_NAME     => $bearsamppBins->getApache(),
                BinMysql::SERVICE_NAME      => $bearsamppBins->getMysql(),
                BinMariadb::SERVICE_NAME    => $bearsamppBins->getMariadb(),
                BinMailpit::SERVICE_NAME    => $bearsamppBins->getMailpit(),
                BinMemcached::SERVICE_NAME  => $bearsamppBins->getMemcached(),
                BinPostgresql::SERVICE_NAME => $bearsamppBins->getPostgresql(),
                BinXlight::SERVICE_NAME     => $bearsamppBins->getXlight(),
            ];
        }
 
        if (self::$syntaxCheckMap === null) {
            self::$syntaxCheckMap = [
                BinApache::SERVICE_NAME  => BinApache::CMD_SYNTAX_CHECK,
                BinMysql::SERVICE_NAME   => BinMysql::CMD_SYNTAX_CHECK,
                BinMariadb::SERVICE_NAME => BinMariadb::CMD_SYNTAX_CHECK,
            ];
        }
    }

References $bearsamppBins, BinApache\CMD_SYNTAX_CHECK, BinMariadb\CMD_SYNTAX_CHECK, BinMysql\CMD_SYNTAX_CHECK, BinApache\SERVICE_NAME, BinMailpit\SERVICE_NAME, BinMariadb\SERVICE_NAME, BinMemcached\SERVICE_NAME, BinMysql\SERVICE_NAME, BinPostgresql\SERVICE_NAME, and BinXlight\SERVICE_NAME.

Referenced by getBinFromServiceName(), getSyntaxCheckCmd(), and processServices().

Here is the caller graph for this function:

◆ installService()

installService	(	$bin,
		$port,
		$syntaxCheckCmd,
		$showWindow = false )

static

Attempts to install and start a service on a specific port, with optional syntax checking and user notifications.

Parameters

object	$bin	An object containing the binary information and methods related to the service.
int	$port	The port number on which the service should run.
string	$syntaxCheckCmd	The command to execute for syntax checking of the service configuration.
bool	$showWindow	Optional. Whether to show message boxes for information, warnings, and errors. Defaults to false.

Returns: bool Returns true if the service is successfully installed and started, false otherwise.

Definition at line 227 of file class.servicehelper.php.

    {
        global $bearsamppLang, $bearsamppWinbinder;
 
        if (method_exists($bin, 'initData')) {
            $bin->initData();
        }
 
        $name     = $bin->getName();
        $service  = $bin->getService();
        $boxTitle = sprintf($bearsamppLang->getValue(Lang::INSTALL_SERVICE_TITLE), $name);
 
        $isPortInUse = self::isPortInUse($port);
        if ($isPortInUse === false) {
            if (!$service->isInstalled()) {
                $service->create();
                if ($service->start()) {
                    Log::info(sprintf('%s service successfully installed. (name: %s ; port: %s)', $name, $service->getName(), $port));
                    if ($showWindow) {
                        $bearsamppWinbinder->messageBoxInfo(
                            sprintf($bearsamppLang->getValue(Lang::SERVICE_INSTALLED), $name, $service->getName(), $port),
                            $boxTitle
                        );
                    }
 
                    return true;
                } else {
                    $serviceError    = sprintf($bearsamppLang->getValue(Lang::SERVICE_INSTALL_ERROR), $name);
                    $serviceErrorLog = sprintf('Error during the installation of %s service', $name);
                    if (!empty($syntaxCheckCmd)) {
                        $cmdSyntaxCheck = $bin->getCmdLineOutput($syntaxCheckCmd);
                        if (!$cmdSyntaxCheck['syntaxOk']) {
                            $serviceError    .= PHP_EOL . sprintf($bearsamppLang->getValue(Lang::STARTUP_SERVICE_SYNTAX_ERROR), $cmdSyntaxCheck['content']);
                            $serviceErrorLog .= sprintf(' (conf errors detected : %s)', $cmdSyntaxCheck['content']);
                        }
                    }
                    Log::error($serviceErrorLog);
                    if ($showWindow) {
                        $bearsamppWinbinder->messageBoxError($serviceError, $boxTitle);
                    }
                }
            } else {
                Log::warning(sprintf('%s service already installed', $name));
                if ($showWindow) {
                    $bearsamppWinbinder->messageBoxWarning(
                        sprintf($bearsamppLang->getValue(Lang::SERVICE_ALREADY_INSTALLED), $name),
                        $boxTitle
                    );
                }
 
                return true;
            }
        } elseif ($service->isRunning()) {
            Log::warning(sprintf('%s service already installed and running', $name));
            if ($showWindow) {
                $bearsamppWinbinder->messageBoxWarning(
                    sprintf($bearsamppLang->getValue(Lang::SERVICE_ALREADY_INSTALLED), $name),
                    $boxTitle
                );
            }
 
            return true;
        } else {
            Log::error(sprintf('Port %s is used by an other application : %s', $port, $isPortInUse));
            if ($showWindow) {
                $bearsamppWinbinder->messageBoxError(
                    sprintf($bearsamppLang->getValue(Lang::PORT_NOT_USED_BY), $port, $isPortInUse),
                    $boxTitle
                );
            }
        }
 
        return false;
    }

References $bearsamppLang, $port, Log\error(), Log\info(), Lang\INSTALL_SERVICE_TITLE, isPortInUse(), Lang\PORT_NOT_USED_BY, Lang\SERVICE_ALREADY_INSTALLED, Lang\SERVICE_INSTALL_ERROR, Lang\SERVICE_INSTALLED, Lang\STARTUP_SERVICE_SYNTAX_ERROR, and Log\warning().

Referenced by ActionService\install(), BinApache\setEnable(), BinMailpit\setEnable(), BinMariadb\setEnable(), BinMemcached\setEnable(), BinMysql\setEnable(), BinPostgresql\setEnable(), and BinXlight\setEnable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isPortInUse()

isPortInUse ( $port )

static

Checks if a specific port is in use.

Parameters

int $port The port number to check

Returns: mixed False if the port is not in use, otherwise returns the process using the port

Definition at line 191 of file class.servicehelper.php.

    {
        // Set localIP statically
        $localIP = APP_LOCALHOST;
 
        // Save current error reporting level
        $errorReporting = error_reporting();
 
        // Disable error reporting temporarily
        error_reporting(0);
 
        $connection = @fsockopen($localIP, $port);
 
        // Restore original error reporting level
        error_reporting($errorReporting);
 
        if (is_resource($connection)) {
            fclose($connection);
            $process = Batch::getProcessUsingPort($port);
 
            return $process != null ? $process : 'N/A';
        }
 
        return false;
    }

References $port, APP_LOCALHOST, and Batch\getProcessUsingPort().

Referenced by BinApache\changePort(), BinMailpit\changePort(), BinMariadb\changePort(), BinMemcached\changePort(), BinMysql\changePort(), BinPostgresql\changePort(), BinXlight\changePort(), BinPostgresql\handleNonPostgresUsage(), installService(), and ActionStartup\prepareService().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ processServices()

processServices	(		$bearsamppBins,
		callable	$callback )

static

Process all services with a callback function

Parameters

object	$bearsamppBins	The bins object
callable	$callback	Function to call for each service: function($serviceName, $service, $bin, $syntaxCheckCmd)

Returns: void

Definition at line 116 of file class.servicehelper.php.

    {
        self::initializeMappings($bearsamppBins);
 
        foreach ($bearsamppBins->getServices() as $serviceName => $service) {
            $bin            = self::getBinFromServiceName($serviceName, $bearsamppBins);
            $syntaxCheckCmd = self::getSyntaxCheckCmd($serviceName);
 
            if ($bin !== null) {
                $callback($serviceName, $service, $bin, $syntaxCheckCmd);
            }
        }
    }

References $bearsamppBins, getBinFromServiceName(), getSyntaxCheckCmd(), and initializeMappings().

Referenced by ActionStartAllServices\processWindow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeService()

removeService	(		$service,
			$name )

static

Removes a service if it is installed.

Parameters

Win32Service	$service	The service object to be removed.
string	$name	The name of the service.

Returns: bool Returns true if the service is successfully removed, false otherwise.

Definition at line 310 of file class.servicehelper.php.

    {
        if (!($service instanceof Win32Service)) {
            Log::error('$service not an instance of Win32Service');
 
            return false;
        }
 
        if ($service->isInstalled()) {
            if ($service->delete()) {
                Log::info(sprintf('%s service successfully removed', $name));
 
                return true;
            } else {
                Log::error(sprintf('Error during the uninstallation of %s service', $name));
 
                return false;
            }
        } else {
            Log::warning(sprintf('%s service does not exist', $name));
        }
 
        return true;
    }

References Log\error(), Log\info(), and Log\warning().

Referenced by ActionService\remove(), BinApache\setEnable(), BinMailpit\setEnable(), BinMariadb\setEnable(), BinMemcached\setEnable(), BinMysql\setEnable(), BinPostgresql\setEnable(), and BinXlight\setEnable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ shutdownServicesParallel()

shutdownServicesParallel	(		$services,
		?callable	$progressCallback = null,
			$shutdownTimeout = 15 )

staticprivate

Shutdown services in parallel (non-blocking)

Phase 1: Send stop commands to all services (non-blocking) Phase 2: Monitor their status until all stopped or timeout Phase 3: Force kill any services still running

Parameters

array	$services	Array of services
callable \| null	$progressCallback	Optional progress callback
int	$shutdownTimeout	Timeout in seconds

Returns: bool True if all services stopped

Definition at line 460 of file class.servicehelper.php.

    {
        Log::trace('Phase 1: Sending stop commands to all services');
        $totalServices = count($services);
        $currentIndex  = 0;
 
        // Phase 1: Send stop commands (non-blocking)
        foreach ($services as $serviceName => $service) {
            $currentIndex++;
            if ($progressCallback) {
                $progressCallback($currentIndex, $totalServices, $serviceName);
            }
 
            Log::trace('Sending stop to: ' . $serviceName);
            $service->stop();
        }
 
        // Phase 2: Monitor status
        Log::trace('Phase 2: Monitoring service status');
        $monitorStartTime = microtime(true);
        $monitorTimeout   = $shutdownTimeout;
        $checkInterval    = 0.5;
        $allStopped       = false;
 
        while ((microtime(true) - $monitorStartTime) < $monitorTimeout) {
            $allStopped = true;
 
            foreach ($services as $serviceName => $service) {
                if (!$service->isStopped()) {
                    $allStopped = false;
                    break;
                }
            }
 
            if ($allStopped) {
                Log::trace('All services stopped in parallel phase');
 
                return true;
            }
 
            usleep($checkInterval * 1000000);
        }
 
        // Phase 3: Force kill remaining services
        Log::trace('Phase 3: Force killing remaining services');
        foreach ($services as $serviceName => $service) {
            if (!$service->isStopped()) {
                Log::trace('Force killing: ' . $serviceName);
                self::forceKillService($serviceName);
            }
        }
 
        // Final check
        return self::allServicesStopped($services);
    }

References allServicesStopped(), forceKillService(), and Log\trace().

Referenced by stopAllServicesParallel().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ shutdownServicesSequential()

shutdownServicesSequential	(		$services,
		?callable	$progressCallback = null )

staticprivate

Shutdown services sequentially (fallback method)

Stops services one by one, waiting for each to complete. Used as fallback when parallel shutdown fails.

Parameters

array	$services	Array of services
callable \| null	$progressCallback	Optional progress callback

Returns: bool True if all services stopped

Definition at line 527 of file class.servicehelper.php.

    {
        Log::trace('Starting sequential shutdown phase');
        $totalServices = count($services);
        $currentIndex  = 0;
 
        foreach ($services as $serviceName => $service) {
            $currentIndex++;
            if ($progressCallback) {
                $progressCallback($currentIndex, $totalServices, $serviceName);
            }
 
            Log::trace('Sequential stop: ' . $serviceName);
            $service->stop();
 
            if (!$service->isStopped()) {
                Log::trace('Force killing: ' . $serviceName);
                self::forceKillService($serviceName);
            }
        }
 
        return self::allServicesStopped($services);
    }

References allServicesStopped(), forceKillService(), and Log\trace().

Referenced by stopAllServicesParallel().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ startAllServicesParallel()

startAllServicesParallel	(		$serviceInfos,
		?callable	$progressCallback = null,
			$startupTimeout = 30 )

static

Start all services in parallel for optimized startup

Sends start commands to all services simultaneously, then monitors their status. Falls back to sequential startup if parallel fails. Significantly reduces startup time.

Performance: 40-60% faster startup (parallel vs sequential)

Parameters

array	$serviceInfos	Array of service information arrays with 'service', 'bin', 'name' keys
callable \| null	$progressCallback	Optional callback: function($current, $total, $serviceName)
int	$startupTimeout	Timeout in seconds (default: 30)

Returns: bool True if all services started successfully

Definition at line 613 of file class.servicehelper.php.

    {
        Log::trace('ServiceHelper::startAllServicesParallel() starting with ' . count($serviceInfos) . ' services');
        $startTime = microtime(true);
 
        if (empty($serviceInfos)) {
            Log::trace('No services to start');
 
            return true;
        }
 
        Log::trace('Starting parallel startup of ' . count($serviceInfos) . ' services');
 
        // Try parallel startup
        $parallelSuccess = self::startServicesParallel($serviceInfos, $progressCallback, $startupTimeout);
 
        if ($parallelSuccess) {
            $duration = round(microtime(true) - $startTime, 3);
            Log::info('Parallel startup completed successfully in ' . $duration . 's');
 
            return true;
        }
 
        // Fallback to sequential
        Log::info('Parallel startup timed out, falling back to sequential startup');
        $sequentialSuccess = self::startServicesSequential($serviceInfos, $progressCallback);
 
        $totalDuration = round(microtime(true) - $startTime, 3);
        Log::info('Sequential startup completed in ' . $totalDuration . 's');
 
        return $sequentialSuccess;
    }

References Log\info(), startServicesParallel(), startServicesSequential(), and Log\trace().

Referenced by ActionStartup\installServicesSequential().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ startService()

startService	(	$bin,
		$syntaxCheckCmd = null,
		$showWindow = false )

static

Start a service with optional syntax check

Parameters

object	$bin	The binary instance
string \| null	$syntaxCheckCmd	The syntax check command (optional)
bool	$showWindow	Whether to show error messages in a window (default: false)

Returns: bool True if service started successfully, false otherwise

Definition at line 139 of file class.servicehelper.php.

    {
        global $bearsamppLang, $bearsamppWinbinder;
 
        if (method_exists($bin, 'initData')) {
            $bin->initData();
        }
 
        $name     = $bin->getName();
        $service  = $bin->getService();
        $boxTitle = sprintf($bearsamppLang->getValue(Lang::START_SERVICE_TITLE), $name);
 
        if (!$service->start()) {
            $serviceError    = sprintf($bearsamppLang->getValue(Lang::START_SERVICE_ERROR), $name);
            $serviceErrorLog = sprintf('Error while starting the %s service', $name);
            if (!empty($syntaxCheckCmd)) {
                $cmdSyntaxCheck = $bin->getCmdLineOutput($syntaxCheckCmd);
                if (!$cmdSyntaxCheck['syntaxOk']) {
                    $serviceError    .= PHP_EOL . sprintf($bearsamppLang->getValue(Lang::STARTUP_SERVICE_SYNTAX_ERROR), $cmdSyntaxCheck['content']);
                    $serviceErrorLog .= sprintf(' (conf errors detected : %s)', $cmdSyntaxCheck['content']);
                }
            }
            Log::error($serviceErrorLog);
            if ($showWindow) {
                $bearsamppWinbinder->messageBoxError($serviceError, $boxTitle);
            }
 
            return false;
        }
 
        return true;
    }

References $bearsamppLang, Log\error(), Lang\START_SERVICE_ERROR, Lang\START_SERVICE_TITLE, and Lang\STARTUP_SERVICE_SYNTAX_ERROR.

Referenced by ActionRestartAllServices\processWindow(), ActionStartAllServices\processWindow(), BinPhp\setEnable(), and ActionService\start().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ startServicesParallel()

startServicesParallel	(		$serviceInfos,
		?callable	$progressCallback = null,
			$startupTimeout = 30 )

staticprivate

Start services in parallel (non-blocking)

Phase 1: Send start commands to all services (non-blocking) Phase 2: Monitor their status until all running or timeout Phase 3: Retry any services that failed to start

Parameters

array	$serviceInfos	Array of service information
callable \| null	$progressCallback	Optional progress callback
int	$startupTimeout	Timeout in seconds

Returns: bool True if all services started

Definition at line 659 of file class.servicehelper.php.

    {
        Log::trace('Phase 1: Sending start commands to all services');
        $totalServices = count($serviceInfos);
        $currentIndex  = 0;
 
        // Phase 1: Send start commands (non-blocking)
        foreach ($serviceInfos as $serviceName => $serviceInfo) {
            $currentIndex++;
            if ($progressCallback) {
                $progressCallback($currentIndex, $totalServices, $serviceInfo['name']);
            }
 
            Log::trace('Sending start to: ' . $serviceName);
            $service = $serviceInfo['service'];
 
            // Start the service
            $service->start();
        }
 
        // Phase 2: Monitor status
        Log::trace('Phase 2: Monitoring service status');
        $monitorStartTime = microtime(true);
        $monitorTimeout   = $startupTimeout;
        $checkInterval    = 0.5;
        $allRunning       = false;
        $failedServices   = [];
 
        while ((microtime(true) - $monitorStartTime) < $monitorTimeout) {
            $allRunning = true;
 
            foreach ($serviceInfos as $serviceName => $serviceInfo) {
                $service = $serviceInfo['service'];
 
                if (!$service->isRunning()) {
                    $allRunning                   = false;
                    $failedServices[$serviceName] = $serviceInfo;
                }
            }
 
            if ($allRunning) {
                Log::trace('All services running in parallel phase');
 
                return true;
            }
 
            usleep($checkInterval * 1000000);
        }
 
        // Phase 3: Retry failed services
        if (!empty($failedServices)) {
            Log::trace('Phase 3: Retrying ' . count($failedServices) . ' failed services');
 
            foreach ($failedServices as $serviceName => $serviceInfo) {
                $service = $serviceInfo['service'];
 
                if (!$service->isRunning()) {
                    Log::trace('Retrying start for: ' . $serviceName);
                    $service->start();
                    usleep(500000); // 500ms delay between retries
                }
            }
 
            // Final check
            return self::allServicesRunning($serviceInfos);
        }
 
        return true;
    }

References allServicesRunning(), and Log\trace().

Referenced by startAllServicesParallel().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ startServicesSequential()

startServicesSequential	(		$serviceInfos,
		?callable	$progressCallback = null )

staticprivate

Start services sequentially (fallback method)

Starts services one by one, waiting for each to complete. Used as fallback when parallel startup fails.

Parameters

array	$serviceInfos	Array of service information
callable \| null	$progressCallback	Optional progress callback

Returns: bool True if all services started

Definition at line 740 of file class.servicehelper.php.

    {
        Log::trace('Starting sequential startup phase');
        $totalServices = count($serviceInfos);
        $currentIndex  = 0;
 
        foreach ($serviceInfos as $serviceName => $serviceInfo) {
            $currentIndex++;
            if ($progressCallback) {
                $progressCallback($currentIndex, $totalServices, $serviceInfo['name']);
            }
 
            Log::trace('Sequential start: ' . $serviceName);
            $service = $serviceInfo['service'];
 
            $service->start();
 
            // Small delay between service starts
            usleep(200000);
 
            if (!$service->isRunning()) {
                Log::trace('Service failed to start: ' . $serviceName);
                // Retry once
                $service->start();
                usleep(500000);
            }
        }
 
        return self::allServicesRunning($serviceInfos);
    }

References allServicesRunning(), and Log\trace().

Referenced by startAllServicesParallel().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ stopAllServicesParallel()

stopAllServicesParallel	(		$bearsamppBins,
		?callable	$progressCallback = null,
			$shutdownTimeout = 15 )

static

Stop all services in parallel for optimized shutdown

Sends stop commands to all services simultaneously, then monitors their status. Falls back to sequential shutdown if parallel fails. Significantly reduces shutdown time.

Performance: 40-60% faster shutdown (parallel vs sequential)

Parameters

object	$bearsamppBins	The bins object
callable \| null	$progressCallback	Optional callback: function($current, $total, $serviceName)
int	$shutdownTimeout	Timeout in seconds (default: 15)

Returns: bool True if all services stopped successfully

Definition at line 413 of file class.servicehelper.php.

    {
        Log::trace('ServiceHelper::stopAllServicesParallel() starting');
        $startTime = microtime(true);
 
        $services = $bearsamppBins->getServices();
        if (empty($services)) {
            Log::trace('No services to shut down');
 
            return true;
        }
 
        Log::trace('Starting parallel shutdown of ' . count($services) . ' services');
 
        // Try parallel shutdown
        $parallelSuccess = self::shutdownServicesParallel($services, $progressCallback, $shutdownTimeout);
 
        if ($parallelSuccess) {
            $duration = round(microtime(true) - $startTime, 3);
            Log::info('Parallel shutdown completed successfully in ' . $duration . 's');
 
            return true;
        }
 
        // Fallback to sequential
        Log::info('Parallel shutdown timed out, falling back to sequential shutdown');
        $sequentialSuccess = self::shutdownServicesSequential($services, $progressCallback);
 
        $totalDuration = round(microtime(true) - $startTime, 3);
        Log::info('Sequential shutdown completed in ' . $totalDuration . 's');
 
        return $sequentialSuccess;
    }

References $bearsamppBins, Log\info(), shutdownServicesParallel(), shutdownServicesSequential(), and Log\trace().

Referenced by ActionStopAllServices\processWindow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ stopService()

stopService ( $service )

static

Stop a service

Parameters

object $service The service instance

Returns: bool True if service stopped successfully, false otherwise

Definition at line 179 of file class.servicehelper.php.

    {
        return $service->stop();
    }

Referenced by ActionRestartAllServices\processWindow().

Here is the caller graph for this function:

Field Documentation

◆ $serviceMap

$serviceMap = null

staticprivate

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

◆ $syntaxCheckMap

$syntaxCheckMap = null

staticprivate

Definition at line 31 of file class.servicehelper.php.

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

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

Static Public Member Functions

Static Private Member Functions

Static Private Attributes

Detailed Description

Member Function Documentation

◆ allServicesRunning()

◆ allServicesStopped()

◆ forceKillService()

◆ getAllServiceNames()

◆ getBinFromServiceName()

◆ getServiceDisplayName()

◆ getServicePort()

◆ getSyntaxCheckCmd()

◆ hasSyntaxCheck()

◆ initializeMappings()

◆ installService()

◆ isPortInUse()

◆ processServices()

◆ removeService()

◆ shutdownServicesParallel()

◆ shutdownServicesSequential()

◆ startAllServicesParallel()

◆ startService()

◆ startServicesParallel()

◆ startServicesSequential()

◆ stopAllServicesParallel()

◆ stopService()

Field Documentation

◆ $serviceMap

◆ $syntaxCheckMap