Same name in other branches

1. 11.x core/lib/Drupal/Core/Recipe/RecipeDiscovery.php \Drupal\Core\Recipe\RecipeDiscovery::getRecipe()

Gets a recipe object.

Parameters

string $name: The machine name of the recipe to find.

Return value

\Drupal\Core\Recipe\Recipe The recipe object.

Throws

\Drupal\Core\Recipe\UnknownRecipeException Thrown when the recipe cannot be found.

File

core/lib/Drupal/Core/Recipe/RecipeDiscovery.php, line 35

Class

RecipeDiscovery

@internal This API is experimental.

Namespace

Drupal\Core\Recipe

Code

public function getRecipe(string $name) : Recipe {
    // In order to allow recipes to include core provided recipes, $name can be
    // a Drupal root relative path to a recipe folder. For example, a recipe can
    // include the core provided 'article_tags' recipe by listing the recipe as
    // 'core/recipes/article_tags'. It is strongly recommended not to rely on
    // relative paths for including recipes. Required recipes should be put in
    // the same parent directory as the recipe being applied. Note, only linux
    // style directory separators are supported. PHP on Windows can resolve the
    // mix of directory separators.
    if (str_contains($name, '/')) {
        $path = \Drupal::root() . "/{$name}/recipe.yml";
    }
    else {
        $path = $this->path . "/{$name}/recipe.yml";
    }
    if (file_exists($path)) {
        return Recipe::createFromDirectory(dirname($path));
    }
    $search_path = dirname($path, 2);
    throw new UnknownRecipeException($name, $search_path, sprintf("Can not find the %s recipe, search path: %s", $name, $search_path));
}

---