Mercurial > hg > isophonics-drupal-site
view core/lib/Drupal/Core/Updater/Module.php @ 19:fa3358dc1485 tip
Add ndrum files
author | Chris Cannam |
---|---|
date | Wed, 28 Aug 2019 13:14:47 +0100 |
parents | 129ea1e6d783 |
children |
line wrap: on
line source
<?php namespace Drupal\Core\Updater; use Drupal\Core\Url; /** * Defines a class for updating modules using * Drupal\Core\FileTransfer\FileTransfer classes via authorize.php. */ class Module extends Updater implements UpdaterInterface { /** * Returns the directory where a module should be installed. * * If the module is already installed, drupal_get_path() will return a valid * path and we should install it there. If we're installing a new module, we * always want it to go into /modules, since that's where all the * documentation recommends users install their modules, and there's no way * that can conflict on a multi-site installation, since the Update manager * won't let you install a new module if it's already found on your system, * and if there was a copy in the top-level we'd see it. * * @return string * The absolute path of the directory. */ public function getInstallDirectory() { if ($this->isInstalled() && ($relative_path = drupal_get_path('module', $this->name))) { // The return value of drupal_get_path() is always relative to the site, // so prepend DRUPAL_ROOT. return DRUPAL_ROOT . '/' . dirname($relative_path); } else { // When installing a new module, prepend the requested root directory. return $this->root . '/' . $this->getRootDirectoryRelativePath(); } } /** * {@inheritdoc} */ public static function getRootDirectoryRelativePath() { return 'modules'; } /** * {@inheritdoc} */ public function isInstalled() { // Check if the module exists in the file system, regardless of whether it // is enabled or not. /** @var \Drupal\Core\Extension\ExtensionList $module_extension_list */ $module_extension_list = \Drupal::service('extension.list.module'); return $module_extension_list->exists($this->name); } /** * {@inheritdoc} */ public static function canUpdateDirectory($directory) { $info = static::getExtensionInfo($directory); return (isset($info['type']) && $info['type'] == 'module'); } /** * Determines whether this class can update the specified project. * * @param string $project_name * The project to check. * * @return bool */ public static function canUpdate($project_name) { return (bool) drupal_get_path('module', $project_name); } /** * Returns available database schema updates once a new version is installed. * * @return array */ public function getSchemaUpdates() { require_once DRUPAL_ROOT . '/core/includes/install.inc'; require_once DRUPAL_ROOT . '/core/includes/update.inc'; if (!self::canUpdate($this->name)) { return []; } module_load_include('install', $this->name); if (!$updates = drupal_get_schema_versions($this->name)) { return []; } $modules_with_updates = update_get_update_list(); if ($updates = $modules_with_updates[$this->name]) { if ($updates['start']) { return $updates['pending']; } } return []; } /** * {@inheritdoc} */ public function postInstallTasks() { // Since this is being called outside of the primary front controller, // the base_url needs to be set explicitly to ensure that links are // relative to the site root. // @todo Simplify with https://www.drupal.org/node/2548095 $default_options = [ '#type' => 'link', '#options' => [ 'absolute' => TRUE, 'base_url' => $GLOBALS['base_url'], ], ]; return [ $default_options + [ '#url' => Url::fromRoute('update.module_install'), '#title' => t('Install another module'), ], $default_options + [ '#url' => Url::fromRoute('system.modules_list'), '#title' => t('Enable newly added modules'), ], $default_options + [ '#url' => Url::fromRoute('system.admin'), '#title' => t('Administration pages'), ], ]; } /** * {@inheritdoc} */ public function postUpdateTasks() { // We don't want to check for DB updates here, we do that once for all // updated modules on the landing page. } }