class Plugin

Same name in this branch
  1. 11.x composer/Plugin/Scaffold/Plugin.php \Drupal\Composer\Plugin\Scaffold\Plugin
  2. 11.x core/lib/Drupal/Component/Annotation/Plugin.php \Drupal\Component\Annotation\Plugin
  3. 11.x core/lib/Drupal/Component/Plugin/Attribute/Plugin.php \Drupal\Component\Plugin\Attribute\Plugin
Same name and namespace in other branches
  1. 9 composer/Plugin/Scaffold/Plugin.php \Drupal\Composer\Plugin\Scaffold\Plugin
  2. 9 core/lib/Drupal/Component/Annotation/Plugin.php \Drupal\Component\Annotation\Plugin
  3. 8.9.x composer/Plugin/Scaffold/Plugin.php \Drupal\Composer\Plugin\Scaffold\Plugin
  4. 8.9.x core/lib/Drupal/Component/Annotation/Plugin.php \Drupal\Component\Annotation\Plugin
  5. 10 composer/Plugin/Scaffold/Plugin.php \Drupal\Composer\Plugin\Scaffold\Plugin
  6. 10 core/lib/Drupal/Component/Annotation/Plugin.php \Drupal\Component\Annotation\Plugin
  7. 10 core/lib/Drupal/Component/Plugin/Attribute/Plugin.php \Drupal\Component\Plugin\Attribute\Plugin

Composer plugin for handling dependency unpacking.

@internal

Attributes

#[\Attribute(\Attribute::TARGET_CLASS)]

Hierarchy

  • class \Drupal\Composer\Plugin\RecipeUnpack\Plugin extends \Composer\Plugin\PluginInterface, \Composer\EventDispatcher\EventSubscriberInterface, \Composer\Plugin\Capable

Expanded class hierarchy of Plugin

24 string references to 'Plugin'
Action::create in core/modules/system/src/Entity/Action.php
Constructs a new entity object, without permanently saving it.
ActionFormBase::form in core/modules/action/src/Form/ActionFormBase.php
Gets the actual form array to be built.
ActionValidationTest::testInvalidPluginId in core/modules/system/tests/src/Kernel/Entity/ActionValidationTest.php
Tests that the action plugin ID is validated.
block.schema.yml in core/modules/block/config/schema/block.schema.yml
core/modules/block/config/schema/block.schema.yml
BlockCreationTrait::placeBlock in core/modules/block/tests/src/Traits/BlockCreationTrait.php
Creates a block instance based on default settings.

... See full list

File

composer/Plugin/RecipeUnpack/Plugin.php, line 23

Namespace

Drupal\Composer\Plugin\RecipeUnpack
View source
final class Plugin implements PluginInterface, EventSubscriberInterface, Capable {
  
  /**
   * The composer package type of Drupal recipes.
   */
  public const RECIPE_PACKAGE_TYPE = 'drupal-recipe';
  
  /**
   * The handler for dependency unpacking.
   */
  private UnpackManager $manager;
  
  /**
   * {@inheritdoc}
   */
  public function getCapabilities() : array {
    return [
      CommandProvider::class => UnpackCommandProvider::class,
    ];
  }
  
  /**
   * {@inheritdoc}
   */
  public function activate(Composer $composer, IOInterface $io) : void {
    $this->manager = new UnpackManager($composer, $io);
  }
  
  /**
   * {@inheritdoc}
   */
  public function deactivate(Composer $composer, IOInterface $io) : void {
  }
  
  /**
   * {@inheritdoc}
   */
  public function uninstall(Composer $composer, IOInterface $io) : void {
  }
  
  /**
   * {@inheritdoc}
   */
  public static function getSubscribedEvents() : array {
    return [
      ScriptEvents::POST_UPDATE_CMD => 'unpackOnRequire',
      ScriptEvents::POST_CREATE_PROJECT_CMD => 'unpackOnCreateProject',
    ];
  }
  
  /**
   * Post update command event callback.
   */
  public function unpackOnRequire(Event $event) : void {
    if (!$this->manager->unpackOptions->options['on-require']) {
      return;
    }
    // @todo https://www.drupal.org/project/drupal/issues/3523269 Use Composer
    //   API once it exists.
    $backtrace = debug_backtrace();
    $composer = $event->getComposer();
    foreach ($backtrace as $trace) {
      if (isset($trace['object']) && $trace['object'] instanceof Installer) {
        $installer = $trace['object'];
        // Get the list of packages being required. This code is largely copied
        // from https://github.com/symfony/flex/blob/2.x/src/Flex.php#L218.
        $updateAllowList = \Closure::bind(function () {
          return $this->updateAllowList ?? [];
        }, $installer, $installer)();
        // Determine if the --no-install flag has been passed to require.
        $isInstalling = \Closure::bind(function () {
          return $this->install;
        }, $installer, $installer)();
      }
      // If the command is a require command, populate the list of recipes to
      // unpack.
      if (isset($trace['object']) && $trace['object'] instanceof RequireCommand && isset($installer, $updateAllowList, $isInstalling)) {
        // Determines if a message has been sent about require-dev and recipes.
        $devRecipeWarningEmitted = FALSE;
        $unpackCollection = new UnpackCollection();
        foreach ($updateAllowList as $package_name) {
          $packages = $composer->getRepositoryManager()
            ->getLocalRepository()
            ->findPackages($package_name);
          $package = reset($packages);
          if (!$package instanceof Package) {
            if (!$isInstalling) {
              $event->getIO()
                ->write('Recipes are not unpacked when the --no-install option is used.', verbosity: IOInterface::VERBOSE);
              return;
            }
            $event->getIO()
              ->error(sprintf('%s does not resolve to a package.', $package_name));
            return;
          }
          // Only recipes are supported.
          if ($package->getType() === self::RECIPE_PACKAGE_TYPE) {
            if ($this->manager->unpackOptions
              ->isIgnored($package)) {
              $event->getIO()
                ->write(sprintf('<info>%s</info> not unpacked because it is ignored.', $package_name), verbosity: IOInterface::VERBOSE);
            }
            elseif (UnpackManager::isDevRequirement($package)) {
              if (!$devRecipeWarningEmitted) {
                $event->getIO()
                  ->write('<info>Recipes required as a development dependency are not automatically unpacked.</info>');
                $devRecipeWarningEmitted = TRUE;
              }
            }
            else {
              $unpackCollection->add($package);
            }
          }
        }
        // Unpack any recipes that have been added to the collection.
        $this->manager
          ->unpack($unpackCollection);
        // The trace has been processed far enough and the $updateAllowList has
        // been used.
        break;

      }
    }
  }
  
  /**
   * Post create-project command event callback.
   */
  public function unpackOnCreateProject(Event $event) : void {
    $composer = $event->getComposer();
    $unpackCollection = new UnpackCollection();
    foreach ($composer->getRepositoryManager()
      ->getLocalRepository()
      ->getPackages() as $package) {
      // Only recipes are supported.
      if ($package->getType() === self::RECIPE_PACKAGE_TYPE) {
        if ($this->manager->unpackOptions
          ->isIgnored($package)) {
          $event->getIO()
            ->write(sprintf('<info>%s</info> not unpacked because it is ignored.', $package->getName()), verbosity: IOInterface::VERBOSE);
        }
        elseif (UnpackManager::isDevRequirement($package)) {
          continue;
        }
        else {
          $unpackCollection->add($package);
        }
      }
    }
    // Unpack any recipes that have been registered.
    $this->manager
      ->unpack($unpackCollection);
  }

}

Members

Title Sort descending Modifiers Object type Summary
Plugin::$manager private property The handler for dependency unpacking.
Plugin::activate public function
Plugin::deactivate public function
Plugin::getCapabilities public function
Plugin::getSubscribedEvents public static function
Plugin::RECIPE_PACKAGE_TYPE public constant The composer package type of Drupal recipes.
Plugin::uninstall public function
Plugin::unpackOnCreateProject public function Post create-project command event callback.
Plugin::unpackOnRequire public function Post update command event callback.

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