class ApplyFailedException

Exception thrown if a stage encounters an error applying an update.

If this exception is thrown it indicates that an update of the active codebase was attempted but failed. If this happens the site code is in an indeterminate state. Package Manager does not provide a method for recovering from this state. The site code should be restored from a backup.

This exception is different from StageFailureMarkerException in that it is thrown if an error happens *during* the apply operation, rather than before or after it.

Should not be thrown by external code.

Hierarchy

  • class \Drupal\package_manager\Exception\StageException extends \Drupal\package_manager\Exception\RuntimeException
    • class \Drupal\package_manager\Exception\ApplyFailedException extends \Drupal\package_manager\Exception\StageException

Expanded class hierarchy of ApplyFailedException

2 files declare their use of ApplyFailedException
StageBase.php in core/modules/package_manager/src/StageBase.php
StageBaseTest.php in core/modules/package_manager/tests/src/Kernel/StageBaseTest.php

File

core/modules/package_manager/src/Exception/ApplyFailedException.php, line 21

Namespace

Drupal\package_manager\Exception
View source
final class ApplyFailedException extends StageException {

}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.