Registry Class Reference

Public Member Functions
	__construct ()
	deleteValue ($key, $subkey, $entry)
	exists ($key, $subkey, $entry=null)
	getAppBinsRegKey ($fromRegistry=true)
	getAppPathRegKey ()
	getLatestError ()
	getProcessorRegKey ()
	getSysPathRegKey ()
	getValue ($key, $subkey, $entry=null)
	setAppBinsRegKey ($value)
	setAppPathRegKey ($value)
	setExpandStringValue ($key, $subkey, $entry, $value)
	setStringValue ($key, $subkey, $entry, $value)
	setSysPathRegKey ($value)

Data Fields
const	APP_BINS_REG_ENTRY = 'BEARSAMPP_BINS'
const	APP_PATH_REG_ENTRY = 'BEARSAMPP_PATH'
const	END_PROCESS_STR = 'FINISHED!'
const	ENV_KEY = 'SYSTEM\CurrentControlSet\Control\Session Manager\Environment'
const	HKEY_CLASSES_ROOT = 'HKCR'
const	HKEY_CURRENT_USER = 'HKCU'
const	HKEY_LOCAL_MACHINE = 'HKLM'
const	HKEY_USERS = 'HKEY_USERS'
const	PROCESSOR_REG_ENTRY = 'Identifier'
const	PROCESSOR_REG_SUBKEY = 'HARDWARE\DESCRIPTION\System\CentralProcessor\0'
const	REG_BINARY = 'REG_BINARY'
const	REG_DWORD = 'REG_DWORD'
const	REG_ERROR_ENTRY = 'REG_ERROR_ENTRY'
const	REG_ERROR_SET = 'REG_ERROR_SET'
const	REG_EXPAND_SZ = 'REG_EXPAND_SZ'
const	REG_MULTI_SZ = 'REG_MULTI_SZ'
const	REG_NO_ERROR = 'REG_NO_ERROR'
const	REG_SZ = 'REG_SZ'
const	SYSPATH_REG_ENTRY = 'Path'

Private Member Functions
	setValue ($key, $subkey, $entry, $value, $type)
	writeLog ($log)

Private Attributes
	$latestError

Detailed Description

Class Registry

This class provides methods to interact with the Windows Registry using COM. It includes functionalities to check the existence of registry keys, get and set values, and delete registry entries. The class also logs operations and errors.

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

Constructor & Destructor Documentation

__construct()

__construct

(

)

Registry constructor. Initializes the Registry class and logs the initialization.

Definition at line 57 of file class.registry.php.

    {
        Log::initClass($this);
        $this->latestError = null;
    }

References Log\initClass().

Here is the call graph for this function:

Member Function Documentation

deleteValue()

deleteValue	(		$key,
			$subkey,
			$entry )

Deletes a registry entry.

Parameters

string	$key	The root key (e.g., HKEY_LOCAL_MACHINE).
string	$subkey	The subkey path.
string	$entry	The entry name.

Returns

bool True if the entry was deleted successfully, false otherwise.

Definition at line 167 of file class.registry.php.

    {
        $this->writeLog('delete');
 
        return $this->setValue($key, $subkey, $entry, null, 'DeleteValue');
    }

References setValue(), and writeLog().

Here is the call graph for this function:

exists()

exists	(		$key,
			$subkey,
			$entry = null )

Checks if a registry key or entry exists. Now uses Win32Native COM methods instead of VBScript.

Parameters

string	$key	The root key (e.g., HKEY_LOCAL_MACHINE).
string	$subkey	The subkey path.
string | null	$entry	The entry name (optional).

Returns

bool True if the key or entry exists, false otherwise.

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

    {
        $this->writeLog('Exists ' . $key . '\\' . $subkey . '\\' . $entry);
 
        // Use Win32Native COM implementation
        $result = Win32Native::registryExists($key, $subkey, $entry);
 
        $this->writeLog('-> result: ' . ($result ? '1' : '0'));
 
        return $result;
    }

References $result, Win32Native\registryExists(), and writeLog().

Here is the call graph for this function:

getAppBinsRegKey()

getAppBinsRegKey

(

$fromRegistry = true

)

Retrieves or generates the application binaries registry key.

Parameters

bool

$fromRegistry

Determines whether to retrieve the key from the registry or generate it.

Returns

string|false Returns the application binaries registry key, or false on error.

Definition at line 248 of file class.registry.php.

    {
        if ($fromRegistry) {
            $value = $this->getValue(
                self::HKEY_LOCAL_MACHINE,
                self::ENV_KEY,
                self::APP_BINS_REG_ENTRY
            );
            Log::debug('App reg key from registry: ' . $value);
        } else {
            global $bearsamppBins, $bearsamppTools;
            $value = '';
            if ($bearsamppBins->getApache()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppBins->getApache()) . '/bin;';
            }
            if ($bearsamppBins->getPhp()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppBins->getPhp()) . ';';
                $value .= Path::getModuleSymlinkPath($bearsamppBins->getPhp()) . '/pear;';
                $value .= Path::getModuleSymlinkPath($bearsamppBins->getPhp()) . '/deps;';
                $value .= Path::getModuleSymlinkPath($bearsamppBins->getPhp()) . '/imagick;';
            }
            if ($bearsamppBins->getNodejs()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppBins->getNodejs()) . ';';
            }
            if ($bearsamppBins->getMysql()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppBins->getMysql()) . '/bin;';
            }
            if ($bearsamppBins->getMariadb()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppBins->getMariadb()) . '/bin;';
            }
            if ($bearsamppBins->getPostgresql()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppBins->getPostgresql()) . '/bin;';
            }
            if ($bearsamppTools->getComposer()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppTools->getComposer()) . ';';
                $value .= Path::getModuleSymlinkPath($bearsamppTools->getComposer()) . '/vendor/bin;';
            }
            if ($bearsamppTools->getGhostscript()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppTools->getGhostscript()) . '/bin;';
            }
            if ($bearsamppTools->getGit()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppTools->getGit()) . '/bin;';
            }
            if ($bearsamppTools->getNgrok()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppTools->getNgrok()) . ';';
            }
            if ($bearsamppTools->getPerl()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppTools->getPerl()) . '/perl/site/bin;';
                $value .= Path::getModuleSymlinkPath($bearsamppTools->getPerl()) . '/perl/bin;';
                $value .= Path::getModuleSymlinkPath($bearsamppTools->getPerl()) . '/c/bin;';
            }
            if ($bearsamppTools->getPython()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppTools->getPython()) . '/bin;';
            }
            if ($bearsamppTools->getRuby()->isEnable()) {
                $value .= Path::getModuleSymlinkPath($bearsamppTools->getRuby()) . '/bin;';
            }
            $value = Path::formatWindowsPath($value);
            Log::debug('Generated app bins reg key: ' . $value);
        }
 
        return $value;
    }

References $bearsamppBins, Log\debug(), Path\formatWindowsPath(), Path\getModuleSymlinkPath(), and getValue().

Here is the call graph for this function:

getAppPathRegKey()

getAppPathRegKey

(

)

Retrieves the application path from the registry.

Returns

mixed The value of the application path registry key or false on error.

Definition at line 334 of file class.registry.php.

    {
        return $this->getValue(
            self::HKEY_LOCAL_MACHINE,
            self::ENV_KEY,
            self::APP_PATH_REG_ENTRY
        );
    }

References getValue().

Here is the call graph for this function:

getLatestError()

getLatestError

(

)

Retrieves the latest error message.

Returns

string|null The latest error message, or null if no error occurred.

Definition at line 410 of file class.registry.php.

    {
        return $this->latestError;
    }

References $latestError.

getProcessorRegKey()

getProcessorRegKey

(

)

Retrieves the processor identifier from the registry.

Returns

mixed The value of the processor identifier registry key or false on error.

Definition at line 396 of file class.registry.php.

    {
        return $this->getValue(
            self::HKEY_LOCAL_MACHINE,
            self::PROCESSOR_REG_SUBKEY,
            self::PROCESSOR_REG_ENTRY
        );
    }

References getValue().

Here is the call graph for this function:

getSysPathRegKey()

getSysPathRegKey

(

)

Retrieves the system path from the registry.

Returns

mixed The value of the system path registry key or false on error.

Definition at line 365 of file class.registry.php.

    {
        return $this->getValue(
            self::HKEY_LOCAL_MACHINE,
            self::ENV_KEY,
            self::SYSPATH_REG_ENTRY
        );
    }

References getValue().

Here is the call graph for this function:

getValue()

getValue	(		$key,
			$subkey,
			$entry = null )

Retrieves the value of a registry entry. Now uses Win32Native COM methods instead of VBScript.

Parameters

string	$key	The root key (e.g., HKEY_LOCAL_MACHINE).
string	$subkey	The subkey path.
string | null	$entry	The entry name (optional).

Returns

mixed The value of the registry entry, or false on error.

Definition at line 106 of file class.registry.php.

    {
        global $bearsamppLang;
 
        $this->latestError = null;
 
        $this->writeLog('GetValue ' . $key . '\\' . $subkey . '\\' . $entry);
 
        // Use Win32Native COM implementation
        $result = Win32Native::registryGetValue($key, $subkey, $entry);
 
        $this->writeLog('-> result: ' . $result);
 
        if ($result === null) {
            $this->latestError = $bearsamppLang->getValue(Lang::ERROR) . ' Registry value not found';
 
            return false;
        }
 
        return $result;
    }

References $bearsamppLang, $result, Lang\ERROR, Win32Native\registryGetValue(), and writeLog().

Referenced by getAppBinsRegKey(), getAppPathRegKey(), getProcessorRegKey(), and getSysPathRegKey().

Here is the call graph for this function:

Here is the caller graph for this function:

setAppBinsRegKey()

setAppBinsRegKey

(

$value

)

Sets the application binaries registry key.

Parameters

string

$value

The new value for the application binaries.

Returns

bool True on success, false on failure.

Definition at line 319 of file class.registry.php.

    {
        return $this->setStringValue(
            self::HKEY_LOCAL_MACHINE,
            self::ENV_KEY,
            self::APP_BINS_REG_ENTRY,
            $value
        );
    }

References setStringValue().

Here is the call graph for this function:

setAppPathRegKey()

setAppPathRegKey

(

$value

)

Sets the application path in the registry.

Parameters

string

$value

The new value for the application path.

Returns

bool True on success, false on failure.

Definition at line 350 of file class.registry.php.

    {
        return $this->setStringValue(
            self::HKEY_LOCAL_MACHINE,
            self::ENV_KEY,
            self::APP_PATH_REG_ENTRY,
            $value
        );
    }

References setStringValue().

Here is the call graph for this function:

setExpandStringValue()

setExpandStringValue	(		$key,
			$subkey,
			$entry,
			$value )

Sets an expanded string value in the registry.

Parameters

string	$key	The root key (e.g., HKEY_LOCAL_MACHINE).
string	$subkey	The subkey path.
string	$entry	The entry name.
string	$value	The value to set.

Returns

bool True if the value was set successfully, false otherwise.

Definition at line 153 of file class.registry.php.

    {
        return $this->setValue($key, $subkey, $entry, $value, 'SetExpandedStringValue');
    }

References setValue().

Referenced by setSysPathRegKey().

Here is the call graph for this function:

Here is the caller graph for this function:

setStringValue()

setStringValue	(		$key,
			$subkey,
			$entry,
			$value )

Sets a string value in the registry.

Parameters

string	$key	The root key (e.g., HKEY_LOCAL_MACHINE).
string	$subkey	The subkey path.
string	$entry	The entry name.
string	$value	The value to set.

Returns

bool True if the value was set successfully, false otherwise.

Definition at line 138 of file class.registry.php.

    {
        return $this->setValue($key, $subkey, $entry, $value, 'SetStringValue');
    }

References setValue().

Referenced by setAppBinsRegKey(), and setAppPathRegKey().

Here is the call graph for this function:

Here is the caller graph for this function:

setSysPathRegKey()

setSysPathRegKey

(

$value

)

Sets the system path in the registry.

Parameters

string

$value

The new value for the system path.

Returns

bool True on success, false on failure.

Definition at line 381 of file class.registry.php.

    {
        return $this->setExpandStringValue(
            self::HKEY_LOCAL_MACHINE,
            self::ENV_KEY,
            self::SYSPATH_REG_ENTRY,
            $value
        );
    }

References setExpandStringValue().

Here is the call graph for this function:

setValue()

setValue ( $key, $subkey, $entry, $value, $type )

private

Sets a value in the registry. Now uses Win32Native COM methods instead of VBScript.

Parameters

string	$key	The root key (e.g., HKEY_LOCAL_MACHINE).
string	$subkey	The subkey path.
string	$entry	The entry name.
string | null	$value	The value to set (optional).
string	$type	The type of value to set (e.g., SetStringValue).

Returns

bool True if the value was set successfully, false otherwise.

Definition at line 186 of file class.registry.php.

    {
        global $bearsamppLang;
 
        $this->latestError = null;
 
        $this->writeLog('SetValue ' . $key . '\\' . $subkey . '\\' . $entry);
        $this->writeLog('-> value: ' . $value);
        $this->writeLog('-> type: ' . $type);
 
        // Map the VBS type to Win32Native registry type
        $regType = self::REG_SZ; // Default
        if ($type == 'SetExpandedStringValue') {
            $regType = self::REG_EXPAND_SZ;
        } elseif ($type == 'SetStringValue') {
            $regType = self::REG_SZ;
        }
 
        // Handle delete operations
        if ($type == 'DeleteValue' && !empty($entry)) {
            // Delete a value
            $result = Win32Native::registryDeleteValue($key, $subkey, $entry);
        } elseif ($type == 'DeleteValue' && empty($entry)) {
            // Delete a key
            $result = Win32Native::registryDeleteKey($key, $subkey);
        } else {
            // Set a value
            $result = Win32Native::registrySetValue($key, $subkey, $entry, $value, $regType);
        }
 
        if ($subkey == self::ENV_KEY) {
            Batch::refreshEnvVars();
        }
 
        $this->writeLog('-> result: ' . ($result ? 'success' : 'failed'));
 
        if (!$result) {
            $this->latestError = $bearsamppLang->getValue(Lang::ERROR) . ' Registry operation failed';
 
            return false;
        }
 
        // Verify the value was set correctly (for set operations)
        if ($type != 'DeleteValue' && !empty($value)) {
            $verifyValue = Win32Native::registryGetValue($key, $subkey, $entry);
            if ($verifyValue != $value) {
                $this->latestError = sprintf($bearsamppLang->getValue(Lang::REGISTRY_SET_ERROR_TEXT), $value);
 
                return false;
            }
        }
 
        return true;
    }

References $bearsamppLang, $result, Lang\ERROR, Batch\refreshEnvVars(), Lang\REGISTRY_SET_ERROR_TEXT, Win32Native\registryDeleteKey(), Win32Native\registryDeleteValue(), Win32Native\registryGetValue(), Win32Native\registrySetValue(), and writeLog().

Referenced by deleteValue(), setExpandStringValue(), and setStringValue().

Here is the call graph for this function:

Here is the caller graph for this function:

writeLog()

writeLog ( $log )

private

Writes a log entry.

Parameters

string

$log

The log message to write.

Definition at line 68 of file class.registry.php.

    {
        global $bearsamppRoot;
        Log::debug($log, Path::getRegistryLogFilePath());
    }

References $bearsamppRoot, Log\debug(), and Path\getRegistryLogFilePath().

Referenced by deleteValue(), exists(), getValue(), and setValue().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$latestError

$latestError

private

Definition at line 51 of file class.registry.php.

Referenced by getLatestError().

APP_BINS_REG_ENTRY

const APP_BINS_REG_ENTRY = 'BEARSAMPP_BINS'

Definition at line 39 of file class.registry.php.

Referenced by ActionStartup\checkBinsRegKey(), ActionStartup\checkSystemPathRegKey(), and ActionSwitchVersion\processWindow().

APP_PATH_REG_ENTRY

const APP_PATH_REG_ENTRY = 'BEARSAMPP_PATH'

Definition at line 42 of file class.registry.php.

Referenced by ActionStartup\checkPathRegKey(), and Batch\refreshEnvVars().

END_PROCESS_STR

const END_PROCESS_STR = 'FINISHED!'

Definition at line 19 of file class.registry.php.

ENV_KEY

const ENV_KEY = 'SYSTEM\CurrentControlSet\Control\Session Manager\Environment'

Definition at line 36 of file class.registry.php.

HKEY_CLASSES_ROOT

const HKEY_CLASSES_ROOT = 'HKCR'

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

HKEY_CURRENT_USER

const HKEY_CURRENT_USER = 'HKCU'

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

Referenced by Path\findExecutable().

HKEY_LOCAL_MACHINE

const HKEY_LOCAL_MACHINE = 'HKLM'

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

Referenced by ActionStartup\cleanOldBehaviors(), Path\findExecutable(), Nssm\infos(), BinMailpit\rebuildConf(), BinMemcached\rebuildConf(), and BinXlight\rebuildConf().

HKEY_USERS

const HKEY_USERS = 'HKEY_USERS'

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

PROCESSOR_REG_ENTRY

const PROCESSOR_REG_ENTRY = 'Identifier'

Definition at line 49 of file class.registry.php.

PROCESSOR_REG_SUBKEY

const PROCESSOR_REG_SUBKEY = 'HARDWARE\DESCRIPTION\System\CentralProcessor\0'

Definition at line 48 of file class.registry.php.

REG_BINARY

const REG_BINARY = 'REG_BINARY'

Definition at line 28 of file class.registry.php.

REG_DWORD

const REG_DWORD = 'REG_DWORD'

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

REG_ERROR_ENTRY

const REG_ERROR_ENTRY = 'REG_ERROR_ENTRY'

Definition at line 32 of file class.registry.php.

REG_ERROR_SET

const REG_ERROR_SET = 'REG_ERROR_SET'

Definition at line 33 of file class.registry.php.

REG_EXPAND_SZ

const REG_EXPAND_SZ = 'REG_EXPAND_SZ'

Definition at line 27 of file class.registry.php.

REG_MULTI_SZ

const REG_MULTI_SZ = 'REG_MULTI_SZ'

Definition at line 30 of file class.registry.php.

REG_NO_ERROR

const REG_NO_ERROR = 'REG_NO_ERROR'

Definition at line 34 of file class.registry.php.

REG_SZ

const REG_SZ = 'REG_SZ'

Definition at line 26 of file class.registry.php.

SYSPATH_REG_ENTRY

const SYSPATH_REG_ENTRY = 'Path'

Definition at line 45 of file class.registry.php.

Referenced by ActionStartup\checkSystemPathRegKey().

---

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

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