UpgradeController extends AbstractController
Upgrade controller
This class is a specific controller implementation and is not considered part of the Public TYPO3 API.
Table of Contents
Properties
- $coreUpdateService : CoreUpdateService
- $coreVersionService : CoreVersionService
- $matchers : array<string|int, mixed>
- Matcher registry of extension scanner.
- $packageManager : PackageManager
Methods
- __construct() : mixed
- cardsAction() : ResponseInterface
- Main "show the cards" view
- coreUpdateActivateAction() : ResponseInterface
- Activate a new core
- coreUpdateCheckPreConditionsAction() : ResponseInterface
- Check if core update is possible
- coreUpdateDownloadAction() : ResponseInterface
- Download new core
- coreUpdateGetDataAction() : ResponseInterface
- Core Update Get Data Action
- coreUpdateIsUpdateAvailableAction() : ResponseInterface
- Check for new core
- coreUpdateMoveAction() : ResponseInterface
- Move core to new location
- coreUpdateUnpackAction() : ResponseInterface
- Unpack a downloaded core
- coreUpdateVerifyChecksumAction() : ResponseInterface
- Verify downloaded core checksum
- extensionCompatTesterLoadedExtensionListAction() : ResponseInterface
- Get list of loaded extensions
- extensionCompatTesterLoadExtLocalconfAction() : ResponseInterface
- Load all ext_localconf files in order until given extension name
- extensionCompatTesterLoadExtTablesAction() : ResponseInterface
- Load all ext_localconf files in order until given extension name
- extensionCompatTesterUninstallExtensionAction() : ResponseInterface
- Unload one extension
- extensionScannerFilesAction() : ResponseInterface
- Return a list of files of an extension
- extensionScannerGetDataAction() : ResponseInterface
- Create Extension Scanner Data action
- extensionScannerMarkFullyScannedRestFilesAction() : ResponseInterface
- Ajax controller, part of "extension scanner". Called at the end of "scan all" as last action. Gets a list of RST file hashes that matched, goes through all existing RST files, finds those marked as "FullyScanned" and marks those that did not had any matches as "you are not affected".
- extensionScannerScanFileAction() : ResponseInterface
- Scan a single extension file for breaking / deprecated core code usages
- tcaExtTablesCheckAction() : ResponseInterface
- Check if loading ext_tables.php files still changes TCA
- tcaMigrationsCheckAction() : ResponseInterface
- Check TCA for needed migrations
- upgradeDocsGetChangelogForVersionAction() : ResponseInterface
- Render list of .rst files
- upgradeDocsGetContentAction() : ResponseInterface
- Render list of versions
- upgradeDocsMarkReadAction() : ResponseInterface
- Mark a .rst file as read
- upgradeDocsUnmarkReadAction() : ResponseInterface
- Mark a .rst file as not read
- upgradeWizardsBlockingDatabaseAddsAction() : ResponseInterface
- Check if new tables and fields should be added before executing wizards
- upgradeWizardsBlockingDatabaseCharsetFixAction() : ResponseInterface
- Fix a broken DB charset setting
- upgradeWizardsBlockingDatabaseCharsetTestAction() : ResponseInterface
- Test if database charset is ok
- upgradeWizardsBlockingDatabaseExecuteAction() : ResponseInterface
- Add new tables and fields
- upgradeWizardsDoneUpgradesAction() : ResponseInterface
- Get list of upgrade wizards marked as done
- upgradeWizardsExecuteAction() : ResponseInterface
- Execute one upgrade wizard
- upgradeWizardsGetDataAction() : ResponseInterface
- Change install tool password
- upgradeWizardsInputAction() : ResponseInterface
- Input stage of a specific upgrade wizard
- upgradeWizardsListAction() : ResponseInterface
- List available upgrade wizards
- upgradeWizardsMarkUndoneAction() : ResponseInterface
- Mark a wizard as "not done"
- assertValidVersion() : void
- Asserts that the given version is valid
- coreUpdateGetVersionToHandle() : CoreRelease
- Find out which version upgrade should be handled. This may be different depending on whether development or regular release.
- coreUpdateInitialize() : mixed
- Initialize the core upgrade actions
- extensionCompatTesterLoadExtLocalconfForExtension() : mixed
- Loads ext_localconf.php for a single extension. Method is a modified copy of the original bootstrap method.
- extensionCompatTesterLoadExtTablesForExtension() : mixed
- Loads ext_tables.php for a single extension. Method is a modified copy of the original bootstrap method.
- extensionScannerGetLineFromFile() : string
- Find a code line in a file
- getDocumentationDirectories() : array<string|int, string>
- getDocumentationFiles() : array<string|int, mixed>
- Get a list of '.rst' files and their details for "Upgrade documentation" view.
- initializeView() : ViewInterface
- Helper method to initialize a view instance.
Properties
$coreUpdateService
protected
CoreUpdateService
$coreUpdateService
$coreVersionService
protected
CoreVersionService
$coreVersionService
$matchers
Matcher registry of extension scanner.
protected
array<string|int, mixed>
$matchers
= [['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\ArrayDimensionMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/ArrayDimensionMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\ArrayGlobalMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/ArrayGlobalMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\ClassConstantMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/ClassConstantMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\ClassNameMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/ClassNameMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\ConstantMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/ConstantMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\ConstructorArgumentMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/ConstructorArgumentMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\PropertyAnnotationMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/PropertyAnnotationMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\MethodAnnotationMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/MethodAnnotationMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\FunctionCallMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/FunctionCallMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\AbstractMethodImplementationMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/AbstractMethodImplementationMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\InterfaceMethodChangedMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/InterfaceMethodChangedMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\MethodArgumentDroppedMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/MethodArgumentDroppedMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\MethodArgumentDroppedStaticMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/MethodArgumentDroppedStaticMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\MethodArgumentRequiredMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/MethodArgumentRequiredMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\MethodArgumentRequiredStaticMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/MethodArgumentRequiredStaticMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\MethodArgumentUnusedMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/MethodArgumentUnusedMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\MethodCallMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/MethodCallMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\MethodCallStaticMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/MethodCallStaticMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\PropertyExistsStaticMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/PropertyExistsStaticMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\PropertyProtectedMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/PropertyProtectedMatcher.php'], ['class' => \TYPO3\CMS\Install\ExtensionScanner\Php\Matcher\PropertyPublicMatcher::class, 'configurationFile' => 'EXT:install/Configuration/ExtensionScanner/Php/PropertyPublicMatcher.php']]
Node visitors that implement CodeScannerInterface
$packageManager read-only
protected
PackageManager
$packageManager
Methods
__construct()
public
__construct(PackageManager $packageManager, LateBootService $lateBootService, DatabaseUpgradeWizardsService $databaseUpgradeWizardsService, FormProtectionFactory $formProtectionFactory) : mixed
Parameters
- $packageManager : PackageManager
- $lateBootService : LateBootService
- $databaseUpgradeWizardsService : DatabaseUpgradeWizardsService
- $formProtectionFactory : FormProtectionFactory
cardsAction()
Main "show the cards" view
public
cardsAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfacecoreUpdateActivateAction()
Activate a new core
public
coreUpdateActivateAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfacecoreUpdateCheckPreConditionsAction()
Check if core update is possible
public
coreUpdateCheckPreConditionsAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfacecoreUpdateDownloadAction()
Download new core
public
coreUpdateDownloadAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfacecoreUpdateGetDataAction()
Core Update Get Data Action
public
coreUpdateGetDataAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfacecoreUpdateIsUpdateAvailableAction()
Check for new core
public
coreUpdateIsUpdateAvailableAction() : ResponseInterface
Return values
ResponseInterfacecoreUpdateMoveAction()
Move core to new location
public
coreUpdateMoveAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfacecoreUpdateUnpackAction()
Unpack a downloaded core
public
coreUpdateUnpackAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfacecoreUpdateVerifyChecksumAction()
Verify downloaded core checksum
public
coreUpdateVerifyChecksumAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceextensionCompatTesterLoadedExtensionListAction()
Get list of loaded extensions
public
extensionCompatTesterLoadedExtensionListAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceextensionCompatTesterLoadExtLocalconfAction()
Load all ext_localconf files in order until given extension name
public
extensionCompatTesterLoadExtLocalconfAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceextensionCompatTesterLoadExtTablesAction()
Load all ext_localconf files in order until given extension name
public
extensionCompatTesterLoadExtTablesAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceextensionCompatTesterUninstallExtensionAction()
Unload one extension
public
extensionCompatTesterUninstallExtensionAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Tags
Return values
ResponseInterfaceextensionScannerFilesAction()
Return a list of files of an extension
public
extensionScannerFilesAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceextensionScannerGetDataAction()
Create Extension Scanner Data action
public
extensionScannerGetDataAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceextensionScannerMarkFullyScannedRestFilesAction()
Ajax controller, part of "extension scanner". Called at the end of "scan all" as last action. Gets a list of RST file hashes that matched, goes through all existing RST files, finds those marked as "FullyScanned" and marks those that did not had any matches as "you are not affected".
public
extensionScannerMarkFullyScannedRestFilesAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceextensionScannerScanFileAction()
Scan a single extension file for breaking / deprecated core code usages
public
extensionScannerScanFileAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfacetcaExtTablesCheckAction()
Check if loading ext_tables.php files still changes TCA
public
tcaExtTablesCheckAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfacetcaMigrationsCheckAction()
Check TCA for needed migrations
public
tcaMigrationsCheckAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceupgradeDocsGetChangelogForVersionAction()
Render list of .rst files
public
upgradeDocsGetChangelogForVersionAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceupgradeDocsGetContentAction()
Render list of versions
public
upgradeDocsGetContentAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceupgradeDocsMarkReadAction()
Mark a .rst file as read
public
upgradeDocsMarkReadAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceupgradeDocsUnmarkReadAction()
Mark a .rst file as not read
public
upgradeDocsUnmarkReadAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceupgradeWizardsBlockingDatabaseAddsAction()
Check if new tables and fields should be added before executing wizards
public
upgradeWizardsBlockingDatabaseAddsAction() : ResponseInterface
Return values
ResponseInterfaceupgradeWizardsBlockingDatabaseCharsetFixAction()
Fix a broken DB charset setting
public
upgradeWizardsBlockingDatabaseCharsetFixAction() : ResponseInterface
Tags
Return values
ResponseInterfaceupgradeWizardsBlockingDatabaseCharsetTestAction()
Test if database charset is ok
public
upgradeWizardsBlockingDatabaseCharsetTestAction() : ResponseInterface
Tags
Return values
ResponseInterfaceupgradeWizardsBlockingDatabaseExecuteAction()
Add new tables and fields
public
upgradeWizardsBlockingDatabaseExecuteAction() : ResponseInterface
Return values
ResponseInterfaceupgradeWizardsDoneUpgradesAction()
Get list of upgrade wizards marked as done
public
upgradeWizardsDoneUpgradesAction() : ResponseInterface
Return values
ResponseInterfaceupgradeWizardsExecuteAction()
Execute one upgrade wizard
public
upgradeWizardsExecuteAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceupgradeWizardsGetDataAction()
Change install tool password
public
upgradeWizardsGetDataAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceupgradeWizardsInputAction()
Input stage of a specific upgrade wizard
public
upgradeWizardsInputAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceupgradeWizardsListAction()
List available upgrade wizards
public
upgradeWizardsListAction() : ResponseInterface
Return values
ResponseInterfaceupgradeWizardsMarkUndoneAction()
Mark a wizard as "not done"
public
upgradeWizardsMarkUndoneAction(ServerRequestInterface $request) : ResponseInterface
Parameters
- $request : ServerRequestInterface
Return values
ResponseInterfaceassertValidVersion()
Asserts that the given version is valid
protected
assertValidVersion(string $version) : void
Parameters
- $version : string
Tags
coreUpdateGetVersionToHandle()
Find out which version upgrade should be handled. This may be different depending on whether development or regular release.
protected
coreUpdateGetVersionToHandle(ServerRequestInterface $request) : CoreRelease
Parameters
- $request : ServerRequestInterface
Tags
Return values
CoreReleasecoreUpdateInitialize()
Initialize the core upgrade actions
protected
coreUpdateInitialize() : mixed
Tags
extensionCompatTesterLoadExtLocalconfForExtension()
Loads ext_localconf.php for a single extension. Method is a modified copy of the original bootstrap method.
protected
extensionCompatTesterLoadExtLocalconfForExtension(PackageInterface $package) : mixed
Parameters
- $package : PackageInterface
extensionCompatTesterLoadExtTablesForExtension()
Loads ext_tables.php for a single extension. Method is a modified copy of the original bootstrap method.
protected
extensionCompatTesterLoadExtTablesForExtension(PackageInterface $package) : mixed
Parameters
- $package : PackageInterface
extensionScannerGetLineFromFile()
Find a code line in a file
protected
extensionScannerGetLineFromFile(string $file, int $lineNumber) : string
Parameters
- $file : string
-
Absolute path to file
- $lineNumber : int
-
Find this line in file
Return values
string —Code line
getDocumentationDirectories()
protected
getDocumentationDirectories() : array<string|int, string>
Return values
array<string|int, string>getDocumentationFiles()
Get a list of '.rst' files and their details for "Upgrade documentation" view.
protected
getDocumentationFiles(string $version) : array<string|int, mixed>
Parameters
- $version : string
Return values
array<string|int, mixed>initializeView()
Helper method to initialize a view instance.
protected
initializeView(ServerRequestInterface $request) : ViewInterface
Parameters
- $request : ServerRequestInterface