Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. PluginInstaller.php

class PluginInstaller

Installer for plugin packages

@author Jordi Boggiano <j.boggiano@seld.be> @author Nils Adermann <naderman@naderman.de>

Hierarchy

  • class \Composer\Installer\LibraryInstaller implements \Composer\Installer\InstallerInterface, \Composer\Installer\BinaryPresenceInterface
    • class \Composer\Installer\PluginInstaller extends \Composer\Installer\LibraryInstaller

Expanded class hierarchy of PluginInstaller

File

vendor/composer/composer/src/Composer/Installer/PluginInstaller.php, line 31

Namespace

Composer\Installer
View source
class PluginInstaller extends LibraryInstaller {
    public function __construct(IOInterface $io, PartialComposer $composer, ?Filesystem $fs = null, ?BinaryInstaller $binaryInstaller = null) {
        parent::__construct($io, $composer, 'composer-plugin', $fs, $binaryInstaller);
    }
    
    /**
     * @inheritDoc
     */
    public function supports(string $packageType) {
        return $packageType === 'composer-plugin' || $packageType === 'composer-installer';
    }
    public function disablePlugins() : void {
        $this->getPluginManager()
            ->disablePlugins();
    }
    
    /**
     * @inheritDoc
     */
    public function prepare($type, PackageInterface $package, ?PackageInterface $prevPackage = null) {
        // fail install process early if it is going to fail due to a plugin not being allowed
        if (($type === 'install' || $type === 'update') && !$this->getPluginManager()
            ->arePluginsDisabled('local')) {
            $this->getPluginManager()
                ->isPluginAllowed($package->getName(), false, true === ($package->getExtra()['plugin-optional'] ?? false));
        }
        return parent::prepare($type, $package, $prevPackage);
    }
    
    /**
     * @inheritDoc
     */
    public function download(PackageInterface $package, ?PackageInterface $prevPackage = null) {
        $extra = $package->getExtra();
        if (empty($extra['class'])) {
            throw new \UnexpectedValueException('Error while installing ' . $package->getPrettyName() . ', composer-plugin packages should have a class defined in their extra key to be usable.');
        }
        return parent::download($package, $prevPackage);
    }
    
    /**
     * @inheritDoc
     */
    public function install(InstalledRepositoryInterface $repo, PackageInterface $package) {
        $promise = parent::install($repo, $package);
        if (!$promise instanceof PromiseInterface) {
            $promise = \React\Promise\resolve(null);
        }
        return $promise->then(function () use ($package, $repo) : void {
            try {
                Platform::workaroundFilesystemIssues();
                $this->getPluginManager()
                    ->registerPackage($package, true);
            } catch (\Exception $e) {
                $this->rollbackInstall($e, $repo, $package);
            }
        });
    }
    
    /**
     * @inheritDoc
     */
    public function update(InstalledRepositoryInterface $repo, PackageInterface $initial, PackageInterface $target) {
        $promise = parent::update($repo, $initial, $target);
        if (!$promise instanceof PromiseInterface) {
            $promise = \React\Promise\resolve(null);
        }
        return $promise->then(function () use ($initial, $target, $repo) : void {
            try {
                Platform::workaroundFilesystemIssues();
                $this->getPluginManager()
                    ->deactivatePackage($initial);
                $this->getPluginManager()
                    ->registerPackage($target, true);
            } catch (\Exception $e) {
                $this->rollbackInstall($e, $repo, $target);
            }
        });
    }
    public function uninstall(InstalledRepositoryInterface $repo, PackageInterface $package) {
        $this->getPluginManager()
            ->uninstallPackage($package);
        return parent::uninstall($repo, $package);
    }
    private function rollbackInstall(\Exception $e, InstalledRepositoryInterface $repo, PackageInterface $package) : void {
        $this->io
            ->writeError('Plugin initialization failed (' . $e->getMessage() . '), uninstalling plugin');
        parent::uninstall($repo, $package);
        throw $e;
    }
    protected function getPluginManager() : PluginManager {
        assert($this->composer instanceof Composer, new \LogicException(self::class . ' should be initialized with a fully loaded Composer instance.'));
        $pluginManager = $this->composer
            ->getPluginManager();
        return $pluginManager;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
LibraryInstaller::$binaryInstaller protected property @var BinaryInstaller
LibraryInstaller::$composer protected property @var PartialComposer
LibraryInstaller::$downloadManager protected property @var DownloadManager|null
LibraryInstaller::$filesystem protected property @var Filesystem
LibraryInstaller::$io protected property @var IOInterface
LibraryInstaller::$type protected property @var string
LibraryInstaller::$vendorDir protected property @var string
LibraryInstaller::cleanup public function @inheritDoc Overrides InstallerInterface::cleanup
LibraryInstaller::ensureBinariesPresence public function Make sure binaries are installed for a given package. Overrides BinaryPresenceInterface::ensureBinariesPresence
LibraryInstaller::getDownloadManager protected function
LibraryInstaller::getInstallPath public function @inheritDoc Overrides InstallerInterface::getInstallPath 1
LibraryInstaller::getPackageBasePath protected function Returns the base path of the package without target-dir path
LibraryInstaller::initializeVendorDir protected function
LibraryInstaller::installCode protected function @phpstan-return PromiseInterface&lt;void|null&gt;|null
LibraryInstaller::isInstalled public function @inheritDoc Overrides InstallerInterface::isInstalled
LibraryInstaller::removeCode protected function @phpstan-return PromiseInterface&lt;void|null&gt;|null
LibraryInstaller::updateCode protected function @phpstan-return PromiseInterface&lt;void|null&gt;|null
PluginInstaller::disablePlugins public function
PluginInstaller::download public function @inheritDoc Overrides LibraryInstaller::download
PluginInstaller::getPluginManager protected function
PluginInstaller::install public function @inheritDoc Overrides LibraryInstaller::install
PluginInstaller::prepare public function @inheritDoc Overrides LibraryInstaller::prepare
PluginInstaller::rollbackInstall private function
PluginInstaller::supports public function @inheritDoc Overrides LibraryInstaller::supports
PluginInstaller::uninstall public function @inheritDoc Overrides LibraryInstaller::uninstall
PluginInstaller::update public function @inheritDoc Overrides LibraryInstaller::update
PluginInstaller::__construct public function Initializes library installer. Overrides LibraryInstaller::__construct

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal