TYPO3 CMS  TYPO3_6-2
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService Class Reference
Inheritance diagram for TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService:
TYPO3\CMS\Core\SingletonInterface

Public Member Functions

 markExtensionForInstallation ($extensionKey)
 
 markExtensionForCopy ($extensionKey, $sourceFolder)
 
 markExtensionForDownload (Extension $extension)
 
 markExtensionForUpdate (Extension $extension)
 
 setSkipSystemDependencyCheck ($skipSystemDependencyCheck)
 
 installExtension (Extension $extension)
 
 getDependencyErrors ()
 
 getExtension ($extensionKey)
 
 isAvailable ($extensionKey)
 
 getAndResolveDependencies (Extension $extension)
 
 downloadMainExtension (Extension $extension)
 

Protected Member Functions

 downloadExtension (Extension $extension)
 
 checkDependencies (Extension $extension)
 
 setInExtensionRepository ($extensionKey)
 
 copyDependencies (array $copyQueue)
 
 uninstallDependenciesToBeUpdated (array $updateQueue)
 
 installDependencies (array $installQueue)
 
 downloadDependencies (array $downloadQueue)
 
 emitWillInstallExtensionsSignal (array $installQueue)
 
 emitHasInstalledExtensionSignal ($extensionKey)
 
 getSignalSlotDispatcher ()
 

Protected Attributes

 $downloadQueue
 
 $dependencyUtility
 
 $installUtility
 
 $extensionModelUtility
 
 $downloadUtility
 
 $skipSystemDependencyCheck = FALSE
 

Detailed Description

Service class for managing multiple step processes (dependencies for example)

Author
Susanne Moog susan.nosp@m.ne.m.nosp@m.oog@t.nosp@m.ypo3.nosp@m..org

Definition at line 24 of file ExtensionManagementService.php.

Member Function Documentation

◆ checkDependencies()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::checkDependencies ( Extension  $extension)
protected

Check dependencies for an extension and its required extensions

Parameters
Extension$extension
Returns
bool Returns TRUE if all dependencies can be resolved, otherwise FALSE

Definition at line 203 of file ExtensionManagementService.php.

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\installExtension().

◆ copyDependencies()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::copyDependencies ( array  $copyQueue)
protected

Copies locally provided extensions to typo3conf/ext

Parameters
array$copyQueue
Returns
void

Definition at line 230 of file ExtensionManagementService.php.

References TYPO3\CMS\Core\Utility\GeneralUtility\copyDirectory(), TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\markExtensionForInstallation(), TYPO3\CMS\Core\Utility\GeneralUtility\mkdir(), and TYPO3\CMS\Extensionmanager\Domain\Model\Extension\returnAllowedInstallPaths().

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\installExtension().

◆ downloadDependencies()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::downloadDependencies ( array  $downloadQueue)
protected

Download dependencies expects an array of extension objects to download

Parameters
Extension[]$downloadQueue
Returns
array

Definition at line 286 of file ExtensionManagementService.php.

References TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\markExtensionForInstallation().

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\installExtension().

◆ downloadExtension()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::downloadExtension ( Extension  $extension)
protected

Download an extension

Parameters
Extension$extension

Definition at line 192 of file ExtensionManagementService.php.

References TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\downloadMainExtension(), TYPO3\CMS\Extensionmanager\Domain\Model\Extension\getExtensionKey(), and TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\setInExtensionRepository().

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\installExtension().

◆ downloadMainExtension()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::downloadMainExtension ( Extension  $extension)

Downloads the extension the user wants to install This is separated from downloading the dependencies as an extension is able to provide it's own dependencies

Parameters
Extension$extension
Returns
void

Definition at line 321 of file ExtensionManagementService.php.

References TYPO3\CMS\Extbase\DomainObject\AbstractDomainObject\getUid().

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\downloadExtension().

◆ emitHasInstalledExtensionSignal()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::emitHasInstalledExtensionSignal (   $extensionKey)
protected
Parameters
string$extensionKey

Definition at line 339 of file ExtensionManagementService.php.

References TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\getSignalSlotDispatcher().

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\installDependencies().

◆ emitWillInstallExtensionsSignal()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::emitWillInstallExtensionsSignal ( array  $installQueue)
protected
Parameters
array$installQueue

Definition at line 332 of file ExtensionManagementService.php.

References TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\getSignalSlotDispatcher().

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\installDependencies().

◆ getAndResolveDependencies()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::getAndResolveDependencies ( Extension  $extension)

Get and resolve dependencies

Parameters
Extension$extension
Returns
array

Definition at line 303 of file ExtensionManagementService.php.

◆ getDependencyErrors()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::getDependencyErrors ( )

Returns the unresolved dependency errors

Returns
array

Definition at line 162 of file ExtensionManagementService.php.

◆ getExtension()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::getExtension (   $extensionKey)
Parameters
string$extensionKey
Returns
Extension
Exceptions

Definition at line 171 of file ExtensionManagementService.php.

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\markExtensionForInstallation().

◆ getSignalSlotDispatcher()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::getSignalSlotDispatcher ( )
protected

Get the SignalSlot dispatcher

Returns

Definition at line 348 of file ExtensionManagementService.php.

References $signalSlotDispatcher, and TYPO3\CMS\Core\Utility\GeneralUtility\makeInstance().

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\emitHasInstalledExtensionSignal(), and TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\emitWillInstallExtensionsSignal().

◆ installDependencies()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::installDependencies ( array  $installQueue)
protected

Install dependent extensions

Parameters
array$installQueue
Returns
array

Definition at line 263 of file ExtensionManagementService.php.

References TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\emitHasInstalledExtensionSignal(), and TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\emitWillInstallExtensionsSignal().

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\installExtension().

◆ installExtension()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::installExtension ( Extension  $extension)

Install the extension

Parameters
Extension$extension
Returns
bool|array Returns FALSE if dependencies cannot be resolved, otherwise array with installation information

Definition at line 125 of file ExtensionManagementService.php.

References TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\checkDependencies(), TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\copyDependencies(), TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\downloadDependencies(), TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\downloadExtension(), TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\installDependencies(), and TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\uninstallDependenciesToBeUpdated().

◆ isAvailable()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::isAvailable (   $extensionKey)

Checks if an extension is available in the system

Parameters
string$extensionKey
Returns
bool

Definition at line 183 of file ExtensionManagementService.php.

◆ markExtensionForCopy()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::markExtensionForCopy (   $extensionKey,
  $sourceFolder 
)

Mark an extension for copy

Parameters
string$extensionKey
string$sourceFolder
Returns
void

Definition at line 80 of file ExtensionManagementService.php.

◆ markExtensionForDownload()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::markExtensionForDownload ( Extension  $extension)

Mark an extension for download

Parameters
Extension$extension
Returns
void

Definition at line 90 of file ExtensionManagementService.php.

◆ markExtensionForInstallation()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::markExtensionForInstallation (   $extensionKey)
Parameters
string$extensionKey
Returns
void

Definition at line 65 of file ExtensionManagementService.php.

References TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\getExtension().

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\copyDependencies(), and TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\downloadDependencies().

◆ markExtensionForUpdate()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::markExtensionForUpdate ( Extension  $extension)
Parameters
Extension$extension
Returns
void

Definition at line 103 of file ExtensionManagementService.php.

◆ setInExtensionRepository()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::setInExtensionRepository (   $extensionKey)
protected

Sets the path to the repository in an extension (Initialisation/Extensions) depending on the extension that is currently installed

Parameters
string$extensionKey

Definition at line 217 of file ExtensionManagementService.php.

References TYPO3\CMS\Extensionmanager\Domain\Model\Extension\returnInstallPaths().

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\downloadExtension().

◆ setSkipSystemDependencyCheck()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::setSkipSystemDependencyCheck (   $skipSystemDependencyCheck)

Enables or disables the dependency check for system environment (PHP, TYPO3) before extension installation

Parameters
bool$skipSystemDependencyCheck

Definition at line 115 of file ExtensionManagementService.php.

References TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\$skipSystemDependencyCheck.

◆ uninstallDependenciesToBeUpdated()

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::uninstallDependenciesToBeUpdated ( array  $updateQueue)
protected

Uninstall extensions that will be updated This is not strictly necessary but cleaner all in all

Parameters
Extension[]$updateQueue
Returns
array

Definition at line 248 of file ExtensionManagementService.php.

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\installExtension().

Member Data Documentation

◆ $dependencyUtility

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::$dependencyUtility
protected

Definition at line 36 of file ExtensionManagementService.php.

◆ $downloadQueue

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::$downloadQueue
protected

Definition at line 30 of file ExtensionManagementService.php.

◆ $downloadUtility

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::$downloadUtility
protected

Definition at line 54 of file ExtensionManagementService.php.

◆ $extensionModelUtility

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::$extensionModelUtility
protected

Definition at line 48 of file ExtensionManagementService.php.

◆ $installUtility

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::$installUtility
protected

Definition at line 42 of file ExtensionManagementService.php.

◆ $skipSystemDependencyCheck

TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService::$skipSystemDependencyCheck = FALSE
protected

Definition at line 59 of file ExtensionManagementService.php.

Referenced by TYPO3\CMS\Extensionmanager\Service\ExtensionManagementService\setSkipSystemDependencyCheck().