Class PackageInstallationQueue

com.woltlab.wcf.acp.package

Description

PackageInstallationQueue represents a database entry in the package_installation_queue table.

  • author: Marcel Werk
  • copyright: 2001-2009 WoltLab GmbH
  • license: GNU

	

Direct descendents

Class Description
PackageInstallation PackageInstallation executes package installations and updates.
PackageUninstallation PackageUninstallation executes package uninstallations.

Variable Summary

Type Name
string $action
boolean $cancelable
boolean $confirmInstallation
mixed $done
mixed $nextStep
Package $package
integer $packageID
string $packageType
integer $parentQueueID
mixed $pipSortOrder
integer $processNo
integer $queueID
mixed $step
mixed $stepAfterPIP

Method Summary

Return Name
PackageInstallationQueue __construct(integer $queueID)
void assignPackageInfo()
void assignQueueInfo()
void calcProgress(integer $currentStep)
static void checkPackageInstallationQueue()
resource checkSafeMode()
void executePackageInstallationPlugin(string $pluginName)
string getAction()
integer getCurrentStep(integer $currentStep)
array getInstallationInfo()
static integer getNewProcessNo()
string getNextPackageInstallationPlugin(string $currentStep)
Package getPackage()
integer getPackageID()
PackageInstallationPlugin getPackageInstallationPlugin(string $pluginName)
integer getTotalStep()
void loadPackageInstallationPlugins()
void makeClear()
static void openQueue([integer $parentQueueID = 0], [integer $processNo = 0])
void showPackageInstallationException(SystemException $e)

Variables

$action

protected string $action

action


$cancelable

protected boolean $cancelable

true, if action is cancelable


$confirmInstallation

protected boolean $confirmInstallation

true, if the user has to confirm the action


$done

protected mixed $done


$nextStep

protected mixed $nextStep = ''


$package

protected Package $package

package object


$packageID

protected integer $packageID

id of package


$packageType

protected string $packageType

type of package


$parentQueueID

protected integer $parentQueueID

id of parent queue entry


$pipSortOrder

protected mixed $pipSortOrder = 'DESC'

Redefined in descendants as: PackageUninstallation::$pipSortOrder


$processNo

protected integer $processNo

process number


$queueID

protected integer $queueID

id of queue entry


$step

public mixed $step = ''


$stepAfterPIP

protected mixed $stepAfterPIP = ''

Methods

__construct

public PackageInstallationQueue __construct(integer $queueID)

Creates a new PackageInstallationQueue object.

Parameters:

  • $queueID

Redefined in descendants as: PackageInstallation::__construct(), PackageInstallationInfo::__construct(), PackageUninstallation::__construct()


assignPackageInfo

protected void assignPackageInfo()

Assigns the information of this package in the template engine.

Redefined in descendants as: PackageInstallation::assignPackageInfo(), PackageUninstallation::assignPackageInfo(), PackageInstallationRollback::assignPackageInfo()


assignQueueInfo

protected void assignQueueInfo()

Assigns the information of this queue entry in the template engine.


calcProgress

protected void calcProgress(integer $currentStep)

Calculates the current state of the progress bar.

Parameters:

  • $currentStep

Redefined in descendants as: PackageInstallation::calcProgress(), PackageUninstallation::calcProgress()


checkPackageInstallationQueue

public static void checkPackageInstallationQueue()

Checks the package installation queue for outstanding entries.


checkSafeMode

public resource checkSafeMode()

Checks if PHP's safe_mode is enabled, and if so, cares for ftp access.


executePackageInstallationPlugin

protected void executePackageInstallationPlugin(string $pluginName)

executes a package installation plugin

Parameters:

  • $pluginName

Redefined in descendants as: PackageInstallationRollback::executePackageInstallationPlugin()


getAction

public string getAction()

Returns the current installation action.


getCurrentStep

protected integer getCurrentStep(integer $currentStep)

Returns the number of the current installation step.

Parameters:

  • $currentStep

Redefined in descendants as: PackageInstallation::getCurrentStep()


getInstallationInfo

protected array getInstallationInfo()


getNewProcessNo

public static integer getNewProcessNo()

Returns a new process number for package installation queue.


getNextPackageInstallationPlugin

public string getNextPackageInstallationPlugin(string $currentStep)

Returns the name of the next step.

Parameters:

  • $currentStep

getPackage

public Package getPackage()

Returns the active package of this installation.


getPackageID

public integer getPackageID()

Returns the package id of this package installation.


getPackageInstallationPlugin

protected PackageInstallationPlugin getPackageInstallationPlugin(string $pluginName)

Returns an object of the package installation plugin with the given name.

Parameters:

  • $pluginName

getTotalStep

protected integer getTotalStep()

Returns the number of all installation steps.

Redefined in descendants as: PackageInstallation::getTotalStep(), PackageUninstallation::getTotalStep()


loadPackageInstallationPlugins

protected void loadPackageInstallationPlugins()

Loads all registered needed package installation plugins.

Redefined in descendants as: PackageInstallationRollback::loadPackageInstallationPlugins()


makeClear

protected void makeClear()

Clears relevant caches after package installation, update or uninstallation.


openQueue

public static void openQueue([integer $parentQueueID = 0], [integer $processNo = 0])

Opens the package installation queue and starts the installation, update or uninstallation of the first entry.

Parameters:

  • $parentQueueID
  • $processNo

showPackageInstallationException

protected void showPackageInstallationException(SystemException $e)

Displays a system exception in the paackageinstallation exception template.

Parameters:

  • $e