ActionEditVhost Class Reference

Inheritance diagram for ActionEditVhost:

Data Fields
const	GAUGE_SAVE = 3
Data Fields inherited from ActionDialogBase
const	GAUGE_DELETE = 2
const	GAUGE_SAVE = 2

Protected Member Functions
	createFormFields ($bearsamppWinbinder)
	deleteItem ()
	getDeleteConfirmMessage ()
	getDeleteDialogTitle ()
	getDeleteErrorMessage ()
	getDeleteSuccessMessage ()
	getDialogTitle ()
	getFormValues ($bearsamppWinbinder)
	getGaugeSave ()
	getSaveErrorMessage ()
	getSaveSuccessMessage ($values)
	getWindowTitle ()
	handleCustomEvent ($window, $id, $ctrl, $param1, $param2)
	initializeDialog ($args)
	itemExists ($values)
	restartService ()
	saveItem ($values)
	validateInput ($values)
Protected Member Functions inherited from ActionDialogBase
	createButtons ($bearsamppWinbinder)
	getGaugeDelete ()
	handleDelete ($window)
	handleSave ($window)
	isEditMode ()

Private Attributes
	$wbBtnDocRoot
	$wbInputDocRoot
	$wbInputServerName
	$wbLabelDocRoot
	$wbLabelExp
	$wbLabelServerName

Additional Inherited Members
Public Member Functions inherited from ActionDialogBase
	__construct ($args)
	processWindow ($window, $id, $ctrl, $param1, $param2)
Protected Attributes inherited from ActionDialogBase
	$initValue
	$wbBtnCancel
	$wbBtnDelete
	$wbBtnSave
	$wbProgressBar
	$wbWindow

Detailed Description

Class ActionEditVhost Handles the editing of virtual hosts within the Bearsampp application.

Definition at line 15 of file class.action.editVhost.php.

Member Function Documentation

createFormFields()

createFormFields ( $bearsamppWinbinder )

protected

Create form fields specific to the dialog This method should create all input fields, labels, and buttons

Parameters

object

$bearsamppWinbinder

The WinBinder instance

Returns

void

Reimplemented from ActionDialogBase.

Definition at line 72 of file class.action.editVhost.php.

    {
        global $bearsamppRoot, $bearsamppLang;
 
        // Load existing vhost data
        $filePath = $bearsamppRoot->getVhostsPath() . '/' . $this->initValue . '.conf';
        $fileContent = file_get_contents($filePath);
        preg_match('/DocumentRoot\s+"(.*)"/', $fileContent, $matchDocumentRoot);
        $initDocumentRoot = Util::formatWindowsPath(trim($matchDocumentRoot[1]));
 
        $this->wbLabelServerName = $bearsamppWinbinder->createLabel(
            $this->wbWindow,
            $bearsamppLang->getValue(Lang::VHOST_SERVER_NAME_LABEL) . ' :',
            15, 15, 85, null, WBC_RIGHT
        );
        $this->wbInputServerName = $bearsamppWinbinder->createInputText(
            $this->wbWindow,
            $this->initValue,
            105, 13, 150, null
        );
 
        $this->wbLabelDocRoot = $bearsamppWinbinder->createLabel(
            $this->wbWindow,
            $bearsamppLang->getValue(Lang::VHOST_DOCUMENT_ROOT_LABEL) . ' :',
            15, 45, 85, null, WBC_RIGHT
        );
        $this->wbInputDocRoot = $bearsamppWinbinder->createInputText(
            $this->wbWindow,
            $initDocumentRoot,
            105, 43, 190, null, null, WBC_READONLY
        );
        $this->wbBtnDocRoot = $bearsamppWinbinder->createButton(
            $this->wbWindow,
            $bearsamppLang->getValue(Lang::BUTTON_BROWSE),
            300, 43, 110
        );
 
        $this->wbLabelExp = $bearsamppWinbinder->createLabel(
            $this->wbWindow,
            sprintf($bearsamppLang->getValue(Lang::VHOST_EXP_LABEL), $this->initValue, $initDocumentRoot),
            15, 80, 470, 50
        );
    }

References $bearsamppLang, $bearsamppRoot, Lang\BUTTON_BROWSE, Util\formatWindowsPath(), Lang\VHOST_DOCUMENT_ROOT_LABEL, Lang\VHOST_EXP_LABEL, and Lang\VHOST_SERVER_NAME_LABEL.

deleteItem()

deleteItem ( )

protected

Delete the item

Returns

bool True on success, false on failure

Reimplemented from ActionDialogBase.

Definition at line 174 of file class.action.editVhost.php.

    {
        global $bearsamppRoot, $bearsamppOpenSsl;
 
        return $bearsamppOpenSsl->removeCrt($this->initValue) &&
               @unlink($bearsamppRoot->getVhostsPath() . '/' . $this->initValue . '.conf');
    }

References $bearsamppRoot.

getDeleteConfirmMessage()

getDeleteConfirmMessage ( )

protected

Get delete confirmation message

Returns

string The confirmation message

Reimplemented from ActionDialogBase.

Definition at line 199 of file class.action.editVhost.php.

    {
        global $bearsamppLang;
        return sprintf($bearsamppLang->getValue(Lang::DELETE_VHOST), $this->initValue);
    }

References $bearsamppLang, and Lang\DELETE_VHOST.

getDeleteDialogTitle()

getDeleteDialogTitle ( )

protected

Get the delete dialog title

Returns

string The delete dialog title

Reimplemented from ActionDialogBase.

Definition at line 43 of file class.action.editVhost.php.

    {
        global $bearsamppLang;
        return $bearsamppLang->getValue(Lang::DELETE_VHOST_TITLE);
    }

References $bearsamppLang, and Lang\DELETE_VHOST_TITLE.

getDeleteErrorMessage()

getDeleteErrorMessage ( )

protected

Get error message after delete failure

Returns

string The error message

Reimplemented from ActionDialogBase.

Definition at line 211 of file class.action.editVhost.php.

    {
        global $bearsamppRoot, $bearsamppLang;
        return sprintf(
            $bearsamppLang->getValue(Lang::VHOST_REMOVE_ERROR),
            $bearsamppRoot->getVhostsPath() . '/' . $this->initValue . '.conf'
        );
    }

References $bearsamppLang, $bearsamppRoot, and Lang\VHOST_REMOVE_ERROR.

getDeleteSuccessMessage()

getDeleteSuccessMessage ( )

protected

Get success message after delete

Returns

string The success message

Reimplemented from ActionDialogBase.

Definition at line 205 of file class.action.editVhost.php.

    {
        global $bearsamppLang;
        return sprintf($bearsamppLang->getValue(Lang::VHOST_REMOVED), $this->initValue);
    }

References $bearsamppLang, and Lang\VHOST_REMOVED.

getDialogTitle()

getDialogTitle ( )

protected

Get the dialog title for messages

Returns

string The dialog title

Reimplemented from ActionDialogBase.

Definition at line 37 of file class.action.editVhost.php.

    {
        global $bearsamppLang;
        return sprintf($bearsamppLang->getValue(Lang::EDIT_VHOST_TITLE), $this->initValue);
    }

References $bearsamppLang, and Lang\EDIT_VHOST_TITLE.

getFormValues()

getFormValues ( $bearsamppWinbinder )

protected

Get the current form values

Parameters

object

$bearsamppWinbinder

The WinBinder instance

Returns

array Associative array of form values

Reimplemented from ActionDialogBase.

Definition at line 116 of file class.action.editVhost.php.

    {
        return [
            'serverName' => $bearsamppWinbinder->getText($this->wbInputServerName[WinBinder::CTRL_OBJ]),
            'documentRoot' => $bearsamppWinbinder->getText($this->wbInputDocRoot[WinBinder::CTRL_OBJ])
        ];
    }

References WinBinder\CTRL_OBJ.

getGaugeSave()

getGaugeSave ( )

protected

Get the gauge value for save operation (can be overridden)

Returns

int The gauge value

Reimplemented from ActionDialogBase.

Definition at line 26 of file class.action.editVhost.php.

    {
        return self::GAUGE_SAVE;
    }

getSaveErrorMessage()

getSaveErrorMessage ( )

protected

Get error message after save failure

Returns

string The error message

Reimplemented from ActionDialogBase.

Definition at line 193 of file class.action.editVhost.php.

    {
        global $bearsamppLang;
        return $bearsamppLang->getValue(Lang::VHOST_CREATED_ERROR);
    }

References $bearsamppLang, and Lang\VHOST_CREATED_ERROR.

getSaveSuccessMessage()

getSaveSuccessMessage ( $values )

protected

Get success message after save

Parameters

array

$values

The form values

Returns

string The success message

Reimplemented from ActionDialogBase.

Definition at line 182 of file class.action.editVhost.php.

    {
        global $bearsamppLang;
        return sprintf(
            $bearsamppLang->getValue(Lang::VHOST_CREATED),
            $values['serverName'],
            $values['serverName'],
            $values['documentRoot']
        );
    }

References $bearsamppLang, and Lang\VHOST_CREATED.

getWindowTitle()

getWindowTitle ( )

protected

Get the dialog window title

Returns

string The window title

Reimplemented from ActionDialogBase.

Definition at line 31 of file class.action.editVhost.php.

    {
        global $bearsamppLang;
        return sprintf($bearsamppLang->getValue(Lang::EDIT_VHOST_TITLE), $this->initValue);
    }

References $bearsamppLang, and Lang\EDIT_VHOST_TITLE.

handleCustomEvent()

handleCustomEvent ( $window, $id, $ctrl, $param1, $param2 )

protected

Handle custom events (can be overridden by child classes)

Parameters

resource	$window	The window resource
int	$id	The control ID
resource	$ctrl	The control resource
mixed	$param1	Additional parameter 1
mixed	$param2	Additional parameter 2

Returns

void

Reimplemented from ActionDialogBase.

Definition at line 226 of file class.action.editVhost.php.

    {
        global $bearsamppLang, $bearsamppWinbinder;
 
        $serverName = $bearsamppWinbinder->getText($this->wbInputServerName[WinBinder::CTRL_OBJ]);
        $documentRoot = $bearsamppWinbinder->getText($this->wbInputDocRoot[WinBinder::CTRL_OBJ]);
 
        // Handle server name input change
        if ($id == $this->wbInputServerName[WinBinder::CTRL_ID]) {
            $bearsamppWinbinder->setText(
                $this->wbLabelExp[WinBinder::CTRL_OBJ],
                sprintf($bearsamppLang->getValue(Lang::VHOST_EXP_LABEL), $serverName, $documentRoot)
            );
            $bearsamppWinbinder->setEnabled(
                $this->wbBtnSave[WinBinder::CTRL_OBJ],
                !empty($serverName)
            );
        }
 
        // Handle browse button
        if ($id == $this->wbBtnDocRoot[WinBinder::CTRL_ID]) {
            $documentRoot = $bearsamppWinbinder->sysDlgPath(
                $window,
                $bearsamppLang->getValue(Lang::VHOST_DOC_ROOT_PATH),
                $documentRoot
            );
            if ($documentRoot && is_dir($documentRoot)) {
                $bearsamppWinbinder->setText($this->wbInputDocRoot[WinBinder::CTRL_OBJ], $documentRoot . '\\');
                $bearsamppWinbinder->setText(
                    $this->wbLabelExp[WinBinder::CTRL_OBJ],
                    sprintf($bearsamppLang->getValue(Lang::VHOST_EXP_LABEL), $serverName, $documentRoot . '\\')
                );
            }
        }
    }

References $bearsamppLang, WinBinder\CTRL_ID, WinBinder\CTRL_OBJ, Lang\VHOST_DOC_ROOT_PATH, and Lang\VHOST_EXP_LABEL.

initializeDialog()

initializeDialog ( $args )

protected

Initialize the dialog window

Parameters

array

$args

Command line arguments

Returns

bool True if initialization successful, false otherwise

Reimplemented from ActionDialogBase.

Definition at line 49 of file class.action.editVhost.php.

    {
        global $bearsamppRoot;
 
        if (!isset($args[0]) || empty($args[0])) {
            return false;
        }
 
        $filePath = $bearsamppRoot->getVhostsPath() . '/' . $args[0] . '.conf';
        if (!file_exists($filePath)) {
            return false;
        }
 
        $fileContent = file_get_contents($filePath);
        if (!preg_match('/ServerName\s+(.*)/', $fileContent, $matchServerName) ||
            !preg_match('/DocumentRoot\s+"(.*)"/', $fileContent, $matchDocumentRoot)) {
            return false;
        }
 
        $this->initValue = trim($matchServerName[1]);
        return true;
    }

References $bearsamppRoot.

itemExists()

itemExists ( $values )

protected

Check if the item already exists (for add/edit operations)

Parameters

array

$values

The form values

Returns

bool True if exists, false otherwise

Reimplemented from ActionDialogBase.

Definition at line 138 of file class.action.editVhost.php.

    {
        global $bearsamppRoot, $bearsamppLang, $bearsamppWinbinder;
 
        // Only check if name changed
        if ($values['serverName'] != $this->initValue && is_file($bearsamppRoot->getVhostsPath() . '/' . $values['serverName'] . '.conf')) {
            $bearsamppWinbinder->messageBoxError(
                sprintf($bearsamppLang->getValue(Lang::VHOST_ALREADY_EXISTS), $values['serverName']),
                $this->getDialogTitle()
            );
            return true;
        }
 
        return false;
    }

References $bearsamppLang, $bearsamppRoot, and Lang\VHOST_ALREADY_EXISTS.

restartService()

restartService ( )

protected

Restart the service after save/delete

Returns

void

Reimplemented from ActionDialogBase.

Definition at line 220 of file class.action.editVhost.php.

    {
        global $bearsamppBins;
        $bearsamppBins->getApache()->getService()->restart();
    }

References $bearsamppBins.

saveItem()

saveItem ( $values )

protected

Save the item (create or update)

Parameters

array

$values

The form values

Returns

bool True on success, false on failure

Reimplemented from ActionDialogBase.

Definition at line 154 of file class.action.editVhost.php.

    {
        global $bearsamppRoot, $bearsamppBins, $bearsamppOpenSsl;
 
        // Remove old vhost and certificate
        $bearsamppOpenSsl->removeCrt($this->initValue);
        @unlink($bearsamppRoot->getVhostsPath() . '/' . $this->initValue . '.conf');
 
        // Create new SSL certificate
        if (!$bearsamppOpenSsl->createCrt($values['serverName'])) {
            return false;
        }
 
        // Create new vhost configuration file
        return file_put_contents(
            $bearsamppRoot->getVhostsPath() . '/' . $values['serverName'] . '.conf',
            $bearsamppBins->getApache()->getVhostContent($values['serverName'], $values['documentRoot'])
        ) !== false;
    }

References $bearsamppBins, and $bearsamppRoot.

validateInput()

validateInput ( $values )

protected

Validate the form input

Parameters

array

$values

The form values

Returns

array ['valid' => bool, 'error' => string|null]

Reimplemented from ActionDialogBase.

Definition at line 124 of file class.action.editVhost.php.

    {
        global $bearsamppLang;
 
        if (!Util::isValidDomainName($values['serverName'])) {
            return [
                'valid' => false,
                'error' => sprintf($bearsamppLang->getValue(Lang::VHOST_NOT_VALID_DOMAIN), $values['serverName'])
            ];
        }
 
        return ['valid' => true];
    }

References $bearsamppLang, Util\isValidDomainName(), and Lang\VHOST_NOT_VALID_DOMAIN.

Field Documentation

$wbBtnDocRoot

$wbBtnDocRoot

private

Definition at line 21 of file class.action.editVhost.php.

$wbInputDocRoot

$wbInputDocRoot

private

Definition at line 20 of file class.action.editVhost.php.

$wbInputServerName

$wbInputServerName

private

Definition at line 18 of file class.action.editVhost.php.

$wbLabelDocRoot

$wbLabelDocRoot

private

Definition at line 19 of file class.action.editVhost.php.

$wbLabelExp

$wbLabelExp

private

Definition at line 22 of file class.action.editVhost.php.

$wbLabelServerName

$wbLabelServerName

private

Definition at line 17 of file class.action.editVhost.php.

GAUGE_SAVE

const GAUGE_SAVE = 3

Definition at line 24 of file class.action.editVhost.php.

---

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

• E:/Bearsampp-development/sandbox/core/classes/actions/class.action.editVhost.php