‪TYPO3CMS  10.4
TYPO3\CMS\Install\Controller\UpgradeController Class Reference
Inheritance diagram for TYPO3\CMS\Install\Controller\UpgradeController:
TYPO3\CMS\Install\Controller\AbstractController

Public Member Functions

 __construct (PackageManager $packageManager, LateBootService $lateBootService, UpgradeWizardsService $upgradeWizardsService)
 
ResponseInterface cardsAction (ServerRequestInterface $request)
 
ResponseInterface coreUpdateActivateAction (ServerRequestInterface $request)
 
ResponseInterface coreUpdateCheckPreConditionsAction (ServerRequestInterface $request)
 
ResponseInterface coreUpdateDownloadAction (ServerRequestInterface $request)
 
ResponseInterface coreUpdateGetDataAction (ServerRequestInterface $request)
 
ResponseInterface coreUpdateIsUpdateAvailableAction ()
 
ResponseInterface coreUpdateMoveAction (ServerRequestInterface $request)
 
ResponseInterface coreUpdateUnpackAction (ServerRequestInterface $request)
 
ResponseInterface coreUpdateVerifyChecksumAction (ServerRequestInterface $request)
 
ResponseInterface extensionCompatTesterLoadedExtensionListAction (ServerRequestInterface $request)
 
ResponseInterface extensionCompatTesterLoadExtLocalconfAction (ServerRequestInterface $request)
 
ResponseInterface extensionCompatTesterLoadExtTablesAction (ServerRequestInterface $request)
 
ResponseInterface extensionCompatTesterUninstallExtensionAction (ServerRequestInterface $request)
 
ResponseInterface extensionScannerGetDataAction (ServerRequestInterface $request)
 
ResponseInterface extensionScannerFilesAction (ServerRequestInterface $request)
 
ResponseInterface extensionScannerMarkFullyScannedRestFilesAction (ServerRequestInterface $request)
 
ResponseInterface extensionScannerScanFileAction (ServerRequestInterface $request)
 
ResponseInterface tcaExtTablesCheckAction (ServerRequestInterface $request)
 
ResponseInterface tcaMigrationsCheckAction (ServerRequestInterface $request)
 
ResponseInterface upgradeDocsGetContentAction (ServerRequestInterface $request)
 
ResponseInterface upgradeDocsGetChangelogForVersionAction (ServerRequestInterface $request)
 
ResponseInterface upgradeDocsMarkReadAction (ServerRequestInterface $request)
 
ResponseInterface upgradeDocsUnmarkReadAction (ServerRequestInterface $request)
 
ResponseInterface upgradeWizardsBlockingDatabaseAddsAction ()
 
ResponseInterface upgradeWizardsBlockingDatabaseExecuteAction ()
 
ResponseInterface upgradeWizardsBlockingDatabaseCharsetFixAction ()
 
ResponseInterface upgradeWizardsBlockingDatabaseCharsetTestAction ()
 
ResponseInterface upgradeWizardsDoneUpgradesAction ()
 
ResponseInterface upgradeWizardsExecuteAction (ServerRequestInterface $request)
 
ResponseInterface upgradeWizardsInputAction (ServerRequestInterface $request)
 
ResponseInterface upgradeWizardsListAction ()
 
ResponseInterface upgradeWizardsMarkUndoneAction (ServerRequestInterface $request)
 
ResponseInterface upgradeWizardsGetDataAction (ServerRequestInterface $request)
 

Protected Member Functions

 coreUpdateInitialize ()
 
CoreRelease coreUpdateGetVersionToHandle (ServerRequestInterface $request)
 
 extensionCompatTesterLoadExtLocalconfForExtension (PackageInterface $package)
 
 extensionCompatTesterLoadExtTablesForExtension (PackageInterface $package)
 
string[] getDocumentationDirectories ()
 
array getDocumentationFiles (string $version)
 
string extensionScannerGetLineFromFile (string $file, int $lineNumber)
 
 assertValidVersion (string $version)
 
- ‪Protected Member Functions inherited from ‪TYPO3\CMS\Install\Controller\AbstractController
StandaloneView initializeStandaloneView (ServerRequestInterface $request, string $templatePath)
 

Protected Attributes

CoreUpdateService $coreUpdateService
 
CoreVersionService $coreVersionService
 
PackageManager $packageManager
 
array $matchers
 

Private Attributes

UpgradeWizardsService $upgradeWizardsService
 
LateBootService $lateBootService
 

Detailed Description

Upgrade controller

This class is a specific controller implementation and is not considered part of the Public TYPO3 API.

Definition at line 79 of file UpgradeController.php.

Constructor & Destructor Documentation

◆ __construct()

TYPO3\CMS\Install\Controller\UpgradeController::__construct ( PackageManager  $packageManager,
LateBootService  $lateBootService,
UpgradeWizardsService  $upgradeWizardsService 
)

Member Function Documentation

◆ assertValidVersion()

TYPO3\CMS\Install\Controller\UpgradeController::assertValidVersion ( string  $version)
protected

Asserts that the given version is valid

Parameters
string$version
Exceptions

Definition at line 1426 of file UpgradeController.php.

Referenced by TYPO3\CMS\Install\Controller\UpgradeController\upgradeDocsGetChangelogForVersionAction().

◆ cardsAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::cardsAction ( ServerRequestInterface  $request)

Main "show the cards" view

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 205 of file UpgradeController.php.

References TYPO3\CMS\Core\Core\Environment\getExtensionsPath(), and TYPO3\CMS\Install\Controller\AbstractController\initializeStandaloneView().

◆ coreUpdateActivateAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::coreUpdateActivateAction ( ServerRequestInterface  $request)

Activate a new core

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 221 of file UpgradeController.php.

References TYPO3\CMS\Install\Controller\UpgradeController\coreUpdateInitialize().

◆ coreUpdateCheckPreConditionsAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::coreUpdateCheckPreConditionsAction ( ServerRequestInterface  $request)

Check if core update is possible

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 236 of file UpgradeController.php.

References TYPO3\CMS\Install\Controller\UpgradeController\coreUpdateInitialize().

◆ coreUpdateDownloadAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::coreUpdateDownloadAction ( ServerRequestInterface  $request)

Download new core

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 251 of file UpgradeController.php.

References TYPO3\CMS\Install\Controller\UpgradeController\coreUpdateInitialize().

◆ coreUpdateGetDataAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::coreUpdateGetDataAction ( ServerRequestInterface  $request)

◆ coreUpdateGetVersionToHandle()

CoreRelease TYPO3\CMS\Install\Controller\UpgradeController::coreUpdateGetVersionToHandle ( ServerRequestInterface  $request)
protected

Find out which version upgrade should be handled. This may be different depending on whether development or regular release.

Parameters
ServerRequestInterface$request
Exceptions

Definition at line 1286 of file UpgradeController.php.

◆ coreUpdateInitialize()

◆ coreUpdateIsUpdateAvailableAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::coreUpdateIsUpdateAvailableAction ( )

◆ coreUpdateMoveAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::coreUpdateMoveAction ( ServerRequestInterface  $request)

Move core to new location

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 450 of file UpgradeController.php.

References TYPO3\CMS\Install\Controller\UpgradeController\coreUpdateInitialize().

◆ coreUpdateUnpackAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::coreUpdateUnpackAction ( ServerRequestInterface  $request)

Unpack a downloaded core

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 465 of file UpgradeController.php.

References TYPO3\CMS\Install\Controller\UpgradeController\coreUpdateInitialize().

◆ coreUpdateVerifyChecksumAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::coreUpdateVerifyChecksumAction ( ServerRequestInterface  $request)

Verify downloaded core checksum

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 480 of file UpgradeController.php.

References TYPO3\CMS\Install\Controller\UpgradeController\coreUpdateInitialize().

◆ extensionCompatTesterLoadedExtensionListAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::extensionCompatTesterLoadedExtensionListAction ( ServerRequestInterface  $request)

Get list of loaded extensions

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 495 of file UpgradeController.php.

References TYPO3\CMS\Core\FormProtection\FormProtectionFactory\get(), and TYPO3\CMS\Install\Controller\AbstractController\initializeStandaloneView().

◆ extensionCompatTesterLoadExtLocalconfAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::extensionCompatTesterLoadExtLocalconfAction ( ServerRequestInterface  $request)

Load all ext_localconf files in order until given extension name

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 523 of file UpgradeController.php.

References TYPO3\CMS\Install\Controller\UpgradeController\extensionCompatTesterLoadExtLocalconfForExtension().

◆ extensionCompatTesterLoadExtLocalconfForExtension()

TYPO3\CMS\Install\Controller\UpgradeController::extensionCompatTesterLoadExtLocalconfForExtension ( PackageInterface  $package)
protected

◆ extensionCompatTesterLoadExtTablesAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::extensionCompatTesterLoadExtTablesAction ( ServerRequestInterface  $request)

Load all ext_localconf files in order until given extension name

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 553 of file UpgradeController.php.

References TYPO3\CMS\Install\Controller\UpgradeController\extensionCompatTesterLoadExtLocalconfForExtension(), and TYPO3\CMS\Install\Controller\UpgradeController\extensionCompatTesterLoadExtTablesForExtension().

◆ extensionCompatTesterLoadExtTablesForExtension()

TYPO3\CMS\Install\Controller\UpgradeController::extensionCompatTesterLoadExtTablesForExtension ( PackageInterface  $package)
protected

Loads ext_tables.php for a single extension. Method is a modified copy of the original bootstrap method.

Parameters
PackageInterface$package

Definition at line 1318 of file UpgradeController.php.

References TYPO3\CMS\Core\Package\PackageInterface\getPackagePath().

Referenced by TYPO3\CMS\Install\Controller\UpgradeController\extensionCompatTesterLoadExtTablesAction().

◆ extensionCompatTesterUninstallExtensionAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::extensionCompatTesterUninstallExtensionAction ( ServerRequestInterface  $request)

Unload one extension

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface
Exceptions

Definition at line 589 of file UpgradeController.php.

References TYPO3\CMS\Core\Messaging\AbstractMessage\ERROR, TYPO3\CMS\Core\Utility\ExtensionManagementUtility\isLoaded(), and TYPO3\CMS\Core\Utility\ExtensionManagementUtility\unloadExtension().

◆ extensionScannerFilesAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::extensionScannerFilesAction ( ServerRequestInterface  $request)

Return a list of files of an extension

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 659 of file UpgradeController.php.

References $finder, and TYPO3\CMS\Core\Core\Environment\getExtensionsPath().

◆ extensionScannerGetDataAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::extensionScannerGetDataAction ( ServerRequestInterface  $request)

Create Extension Scanner Data action

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 630 of file UpgradeController.php.

References TYPO3\CMS\Core\FormProtection\FormProtectionFactory\get(), TYPO3\CMS\Core\Core\Environment\getExtensionsPath(), and TYPO3\CMS\Install\Controller\AbstractController\initializeStandaloneView().

◆ extensionScannerGetLineFromFile()

string TYPO3\CMS\Install\Controller\UpgradeController::extensionScannerGetLineFromFile ( string  $file,
int  $lineNumber 
)
protected

Find a code line in a file

Parameters
string$file‪Absolute path to file
int$lineNumber‪Find this line in file
Returns
‪string Code line

Definition at line 1410 of file UpgradeController.php.

Referenced by TYPO3\CMS\Install\Controller\UpgradeController\extensionScannerScanFileAction().

◆ extensionScannerMarkFullyScannedRestFilesAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::extensionScannerMarkFullyScannedRestFilesAction ( ServerRequestInterface  $request)

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".

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 700 of file UpgradeController.php.

References $finder, and TYPO3\CMS\Core\Utility\ExtensionManagementUtility\extPath().

◆ extensionScannerScanFileAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::extensionScannerScanFileAction ( ServerRequestInterface  $request)

◆ getDocumentationDirectories()

string [] TYPO3\CMS\Install\Controller\UpgradeController::getDocumentationDirectories ( )
protected

◆ getDocumentationFiles()

array TYPO3\CMS\Install\Controller\UpgradeController::getDocumentationFiles ( string  $version)
protected

Get a list of '.rst' files and their details for "Upgrade documentation" view.

Parameters
string$version
Returns
‪array

Definition at line 1344 of file UpgradeController.php.

References TYPO3\CMS\Core\Utility\ExtensionManagementUtility\extPath().

Referenced by TYPO3\CMS\Install\Controller\UpgradeController\upgradeDocsGetChangelogForVersionAction().

◆ tcaExtTablesCheckAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::tcaExtTablesCheckAction ( ServerRequestInterface  $request)

Check if loading ext_tables.php files still changes TCA

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 873 of file UpgradeController.php.

References $GLOBALS, TYPO3\CMS\Install\Controller\UpgradeController\extensionCompatTesterLoadExtLocalconfForExtension(), TYPO3\CMS\Install\Controller\AbstractController\initializeStandaloneView(), and TYPO3\CMS\Core\Messaging\AbstractMessage\NOTICE.

◆ tcaMigrationsCheckAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::tcaMigrationsCheckAction ( ServerRequestInterface  $request)

Check TCA for needed migrations

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 920 of file UpgradeController.php.

References $GLOBALS, TYPO3\CMS\Install\Controller\AbstractController\initializeStandaloneView(), and TYPO3\CMS\Core\Messaging\AbstractMessage\NOTICE.

◆ upgradeDocsGetChangelogForVersionAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeDocsGetChangelogForVersionAction ( ServerRequestInterface  $request)

◆ upgradeDocsGetContentAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeDocsGetContentAction ( ServerRequestInterface  $request)

◆ upgradeDocsMarkReadAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeDocsMarkReadAction ( ServerRequestInterface  $request)

Mark a .rst file as read

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 1000 of file UpgradeController.php.

◆ upgradeDocsUnmarkReadAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeDocsUnmarkReadAction ( ServerRequestInterface  $request)

Mark a .rst file as not read

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 1017 of file UpgradeController.php.

◆ upgradeWizardsBlockingDatabaseAddsAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeWizardsBlockingDatabaseAddsAction ( )

Check if new tables and fields should be added before executing wizards

Returns
‪ResponseInterface

Definition at line 1033 of file UpgradeController.php.

◆ upgradeWizardsBlockingDatabaseCharsetFixAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeWizardsBlockingDatabaseCharsetFixAction ( )

Fix a broken DB charset setting

Returns
‪ResponseInterface

Definition at line 1095 of file UpgradeController.php.

◆ upgradeWizardsBlockingDatabaseCharsetTestAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeWizardsBlockingDatabaseCharsetTestAction ( )

Test if database charset is ok

Returns
‪ResponseInterface

Definition at line 1114 of file UpgradeController.php.

◆ upgradeWizardsBlockingDatabaseExecuteAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeWizardsBlockingDatabaseExecuteAction ( )

Add new tables and fields

Returns
‪ResponseInterface

Definition at line 1060 of file UpgradeController.php.

References $errors, and TYPO3\CMS\Core\Messaging\AbstractMessage\ERROR.

◆ upgradeWizardsDoneUpgradesAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeWizardsDoneUpgradesAction ( )

Get list of upgrade wizards marked as done

Returns
‪ResponseInterface

Definition at line 1128 of file UpgradeController.php.

◆ upgradeWizardsExecuteAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeWizardsExecuteAction ( ServerRequestInterface  $request)

Execute one upgrade wizard

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 1155 of file UpgradeController.php.

◆ upgradeWizardsGetDataAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeWizardsGetDataAction ( ServerRequestInterface  $request)

Change install tool password

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 1244 of file UpgradeController.php.

References TYPO3\CMS\Core\FormProtection\FormProtectionFactory\get(), and TYPO3\CMS\Install\Controller\AbstractController\initializeStandaloneView().

◆ upgradeWizardsInputAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeWizardsInputAction ( ServerRequestInterface  $request)

Input stage of a specific upgrade wizard

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 1174 of file UpgradeController.php.

◆ upgradeWizardsListAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeWizardsListAction ( )

List available upgrade wizards

Returns
‪ResponseInterface

Definition at line 1193 of file UpgradeController.php.

◆ upgradeWizardsMarkUndoneAction()

ResponseInterface TYPO3\CMS\Install\Controller\UpgradeController::upgradeWizardsMarkUndoneAction ( ServerRequestInterface  $request)

Mark a wizard as "not done"

Parameters
ServerRequestInterface$request
Returns
‪ResponseInterface

Definition at line 1212 of file UpgradeController.php.

References TYPO3\CMS\Core\Messaging\AbstractMessage\ERROR.

Member Data Documentation

◆ $coreUpdateService

CoreUpdateService TYPO3\CMS\Install\Controller\UpgradeController::$coreUpdateService
protected

◆ $coreVersionService

CoreVersionService TYPO3\CMS\Install\Controller\UpgradeController::$coreVersionService
protected

◆ $lateBootService

LateBootService TYPO3\CMS\Install\Controller\UpgradeController::$lateBootService
private

◆ $matchers

array TYPO3\CMS\Install\Controller\UpgradeController::$matchers
protected

Matcher registry of extension scanner. Node visitors that implement CodeScannerInterface

Definition at line 116 of file UpgradeController.php.

Referenced by TYPO3\CMS\Install\Controller\UpgradeController\extensionScannerScanFileAction().

◆ $packageManager

PackageManager TYPO3\CMS\Install\Controller\UpgradeController::$packageManager
protected

◆ $upgradeWizardsService

UpgradeWizardsService TYPO3\CMS\Install\Controller\UpgradeController::$upgradeWizardsService
private