summaryrefslogtreecommitdiffstatshomepage
path: root/core/lib/Drupal/Core/Recipe/RecipeMissingExtensionsException.php
blob: cdc2102196365b4bb6e8e6bbbfe299052c24b84e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
<?php

declare(strict_types=1);

namespace Drupal\Core\Recipe;

use Drupal\Component\Assertion\Inspector;

/**
 * Exception thrown when recipes contain or depend on missing extensions.
 *
 * @internal
 *   This API is experimental.
 */
final class RecipeMissingExtensionsException extends \RuntimeException {

  /**
   * Constructs a RecipeMissingExtensionsException.
   *
   * @param array $extensions
   *   The list of missing extensions.
   * @param string $message
   *   [optional] The Exception message to throw.
   * @param int $code
   *   [optional] The Exception code.
   * @param null|\Throwable $previous
   *   [optional] The previous throwable used for the exception chaining.
   */
  public function __construct(public readonly array $extensions, string $message = "", int $code = 0, ?\Throwable $previous = NULL) {
    assert(Inspector::assertAllStrings($extensions), 'Extension names must be strings.');
    if (!$message) {
      $sorted = $this->extensions;
      sort($sorted);
      $message = sprintf("The following extensions are missing and are required for this recipe: %s", implode(", ", $sorted));
    }
    parent::__construct($message, $code, $previous);
  }

}