Plugins.php

Go to the documentation of this file.

<?php

namespace Elgg\Database;

use Elgg\Cache\BaseCache;
use Elgg\Config;
use Elgg\Context;
use Elgg\Database;
use Elgg\EventsService;
use Elgg\Exceptions\InvalidArgumentException;
use Elgg\Exceptions\PluginException;
use Elgg\Http\Request;
use Elgg\I18n\Translator;
use Elgg\Project\Paths;
use Elgg\SessionManagerService;
use Elgg\SystemMessagesService;
use Elgg\Traits\Cacheable;
use Elgg\Traits\Debug\Profilable;
use Elgg\Traits\Loggable;
use Elgg\ViewsService;
use Psr\Log\LogLevel;

class Plugins {

    use Profilable;
    use Cacheable;
    use Loggable;
    
    const BUNDLED_PLUGINS = [
        'activity',
        'blog',
        'bookmarks',
        'ckeditor',
        'custom_index',
        'dashboard',
        'developers',
        'discussions',
        'externalpages',
        'file',
        'friends',
        'friends_collections',
        'garbagecollector',
        'groups',
        'invitefriends',
        'likes',
        'members',
        'messageboard',
        'messages',
        'notifications',
        'pages',
        'profile',
        'reportedcontent',
        'search',
        'site_notifications',
        'system_log',
        'tagcloud',
        'theme_sandbox',
        'thewire',
        'uservalidationbyemail',
        'web_services',
    ];

    protected ?array $boot_plugins;

    protected Database $db;

    protected SessionManagerService $session_manager;

    protected EventsService $events;

    protected Translator $translator;

    protected ViewsService $views;

    protected Config $config;

    protected SystemMessagesService $system_messages;

    protected Context $context;

    public function __construct(
        BaseCache $cache,
        Database $db,
        SessionManagerService $session_manager,
        EventsService $events,
        Translator $translator,
        ViewsService $views,
        Config $config,
        SystemMessagesService $system_messages,
        Request $request
    ) {
        $this->cache = $cache;
        $this->db = $db;
        $this->session_manager = $session_manager;
        $this->events = $events;
        $this->translator = $translator;
        $this->views = $views;
        $this->config = $config;
        $this->system_messages = $system_messages;
        
        $this->context = $request->getContextStack();
    }

    public function getPath(): string {
        $path = $this->config->plugins_path;
        if (!$path) {
            $path = Paths::project() . 'mod/';
        }
        
        return $path;
    }

    public function setBootPlugins(array $plugins = null, bool $order_plugins = true): void {
        if (!is_array($plugins)) {
            unset($this->boot_plugins);
            return;
        }
        
        // Always (re)set the boot_plugins. This makes sure that even if you have no plugins active this is known to the system.
        $this->boot_plugins = [];
        
        if ($order_plugins) {
            $plugins = $this->orderPluginsByPriority($plugins);
        }
        
        foreach ($plugins as $plugin) {
            if (!$plugin instanceof \ElggPlugin) {
                continue;
            }
            
            $plugin_id = $plugin->getID();
            if (!$plugin_id) {
                continue;
            }

            $plugin->registerLanguages();
            
            $this->boot_plugins[$plugin_id] = $plugin;
            $this->cache->save($plugin_id, $plugin);
        }
    }

    public function clear(): void {
        $this->cache->clear();
    }
    
    public function invalidate(): void {
        $this->cache->invalidate();
    }
    
    public function getDirsInDir(string $dir = null): array {
        if (!$dir) {
            $dir = $this->getPath();
        }

        if (!is_dir($dir)) {
            return [];
        }
        
        $handle = opendir($dir);
        if ($handle === false) {
            return [];
        }
        
        $plugin_dirs = [];
        while (($plugin_dir = readdir($handle)) !== false) {
            // must be directory and not begin with a .
            if (!str_starts_with($plugin_dir, '.') && is_dir($dir . $plugin_dir)) {
                $plugin_dirs[] = $plugin_dir;
            }
        }

        sort($plugin_dirs);

        return $plugin_dirs;
    }

    public function generateEntities(): bool {
        $mod_dir = $this->getPath();

        // ignore access in case this is called with no admin logged in - needed for creating plugins perhaps?
        $old_ia = $this->session_manager->setIgnoreAccess(true);

        // show hidden entities so that we can enable them if appropriate
        $old_access = $this->session_manager->setDisabledEntityVisibility(true);

        $known_plugins = $this->find('all');
        if (empty($known_plugins)) {
            $known_plugins = [];
        }

        // keeps track if reindexing is needed
        $reindex = false;
        
        // map paths to indexes
        $id_map = [];
        $latest_priority = -1;
        foreach ($known_plugins as $i => $plugin) {
            // if the ID is wrong, delete the plugin because we can never load it.
            $id = $plugin->getID();
            if (!$id) {
                $plugin->delete();
                unset($known_plugins[$i]);
                continue;
            }
            
            $id_map[$plugin->getID()] = $i;
            $plugin->cache();
            
            // disabled plugins should have no priority, so no need to check if the priority is incorrect
            if (!$plugin->isEnabled()) {
                continue;
            }
            
            $current_priority = $plugin->getPriority();
            if (($current_priority - $latest_priority) > 1) {
                $reindex = true;
            }
            
            $latest_priority = $current_priority;
        }

        $physical_plugins = $this->getDirsInDir($mod_dir);
        if (empty($physical_plugins)) {
            $this->session_manager->setIgnoreAccess($old_ia);
            $this->session_manager->setDisabledEntityVisibility($old_access);

            return false;
        }

        // check real plugins against known ones
        foreach ($physical_plugins as $plugin_id) {
            // is this already in the db?
            if (array_key_exists($plugin_id, $id_map)) {
                $index = $id_map[$plugin_id];
                $plugin = $known_plugins[$index];
                // was this plugin deleted and its entity disabled?
                if (!$plugin->isEnabled()) {
                    $plugin->enable();
                    try {
                        $plugin->deactivate();
                    } catch (PluginException $e) {
                        // do nothing
                    }
                    
                    $plugin->setPriority('new');
                }

                // remove from the list of plugins to disable
                unset($known_plugins[$index]);
            } else {
                // create new plugin
                // priority is forced to last in save() if not set.
                $plugin = \ElggPlugin::fromId($plugin_id);
                $plugin->cache();
            }
        }

        // everything remaining in $known_plugins needs to be disabled
        // because they are entities, but their dirs were removed.
        // don't delete the entities because they hold settings.
        foreach ($known_plugins as $plugin) {
            if (!$plugin->isEnabled()) {
                continue;
            }
            
            $reindex = true;
            
            if ($plugin->isActive()) {
                try {
                    $plugin->deactivate();
                } catch (PluginException $e) {
                    // do nothing
                }
            }
            
            // remove the priority.
            $plugin->deleteMetadata(\ElggPlugin::PRIORITY_SETTING_NAME);
            
            $plugin->disable();
        }
        
        if ($reindex) {
            $this->reindexPriorities();
        }

        $this->session_manager->setIgnoreAccess($old_ia);
        $this->session_manager->setDisabledEntityVisibility($old_access);

        return true;
    }

    public function cache(\ElggPlugin $plugin): void {
        if (!$plugin->getID()) {
            return;
        }
        
        $this->cache->save($plugin->getID(), $plugin);
    }

    public function invalidateCache($plugin_id): void {
        try {
            $this->cache->delete($plugin_id);
        } catch (InvalidArgumentException $ex) {
            // A plugin must have been deactivated due to missing folder
            // without proper cleanup
            elgg_invalidate_caches();
        }
    }

    public function get(string $plugin_id): ?\ElggPlugin {
        if (empty($plugin_id)) {
            return null;
        }

        $plugin = $this->cache->load($plugin_id);
        if ($plugin instanceof \ElggPlugin) {
            return $plugin;
        }

        $plugins = elgg_get_entities([
            'type' => 'object',
            'subtype' => 'plugin',
            'metadata_name_value_pairs' => [
                'name' => 'title',
                'value' => $plugin_id,
            ],
            'limit' => 1,
            'distinct' => false,
        ]);

        if (empty($plugins)) {
            return null;
        }

        $plugins[0]->cache();

        return $plugins[0];
    }

    public function exists(string $id): bool {
        return $this->get($id) instanceof \ElggPlugin;
    }

    public function getMaxPriority(): int {
        $qb = Select::fromTable('entities', 'e');
        $qb->select('MAX(CAST(md.value AS unsigned)) as max')
            ->join('e', 'metadata', 'md', 'e.guid = md.entity_guid')
            ->where($qb->compare('md.name', '=', \ElggPlugin::PRIORITY_SETTING_NAME, ELGG_VALUE_STRING))
            ->andWhere($qb->compare('e.type', '=', 'object', ELGG_VALUE_STRING))
            ->andWhere($qb->compare('e.subtype', '=', 'plugin', ELGG_VALUE_STRING));

        $data = $this->db->getDataRow($qb);
        if (empty($data)) {
            return 1;
        }

        return max(1, (int) $data->max);
    }

    public function isActive(string $plugin_id): bool {
        if (isset($this->boot_plugins) && is_array($this->boot_plugins)) {
            return array_key_exists($plugin_id, $this->boot_plugins);
        }
        
        $plugin = $this->get($plugin_id);
        if (!$plugin instanceof \ElggPlugin) {
            return false;
        }
        
        return $plugin->hasRelationship(1, 'active_plugin');
    }

    public function build(): bool {
        $plugins_path = $this->getPath();

        // temporary disable all plugins if there is a file called 'disabled' in the plugin dir
        if (file_exists("{$plugins_path}/disabled")) {
            if ($this->session_manager->isAdminLoggedIn() && $this->context->contains('admin')) {
                $this->system_messages->addSuccessMessage($this->translator->translate('plugins:disabled'));
            }

            return false;
        }

        $this->events->registerHandler('plugins_load', 'system', [$this, 'register']);
        $this->events->registerHandler('plugins_boot:before', 'system', [$this, 'boot']);
        $this->events->registerHandler('init', 'system', [$this, 'init']);
        $this->events->registerHandler('ready', 'system', [$this, 'ready']);
        $this->events->registerHandler('upgrade', 'system', [$this, 'upgrade']);
        $this->events->registerHandler('shutdown', 'system', [$this, 'shutdown']);

        return true;
    }

    public function register(): void {
        $plugins = $this->find('active');
        if (empty($plugins)) {
            return;
        }

        $this->beginTimer([__METHOD__]);

        foreach ($plugins as $plugin) {
            try {
                $plugin->register();
            } catch (\Exception $ex) {
                $this->disable($plugin, $ex);
            }
        }

        $this->endTimer([__METHOD__]);
    }

    public function boot(): void {
        $plugins = $this->find('active');
        if (empty($plugins)) {
            return;
        }

        $this->beginTimer([__METHOD__]);

        foreach ($plugins as $plugin) {
            try {
                $plugin->boot();
            } catch (\Exception $ex) {
                $this->disable($plugin, $ex);
            }
        }

        $this->endTimer([__METHOD__]);
    }

    public function init(): void {
        $plugins = $this->find('active');
        if (empty($plugins)) {
            return;
        }

        $this->beginTimer([__METHOD__]);

        foreach ($plugins as $plugin) {
            try {
                $plugin->init();
            } catch (\Exception $ex) {
                $this->disable($plugin, $ex);
            }
        }

        $this->endTimer([__METHOD__]);
    }

    public function ready(): void {
        $plugins = $this->find('active');
        if (empty($plugins)) {
            return;
        }

        $this->beginTimer([__METHOD__]);

        foreach ($plugins as $plugin) {
            try {
                $plugin->getBootstrap()->ready();
            } catch (\Exception $ex) {
                $this->disable($plugin, $ex);
            }
        }

        $this->endTimer([__METHOD__]);
    }

    public function upgrade(): void {
        $plugins = $this->find('active');
        if (empty($plugins)) {
            return;
        }

        $this->beginTimer([__METHOD__]);

        foreach ($plugins as $plugin) {
            try {
                $plugin->getBootstrap()->upgrade();
            } catch (\Exception $ex) {
                $this->disable($plugin, $ex);
            }
        }

        $this->endTimer([__METHOD__]);
    }

    public function shutdown(): void {
        $plugins = $this->find('active');
        if (empty($plugins)) {
            return;
        }

        $this->beginTimer([__METHOD__]);

        foreach ($plugins as $plugin) {
            try {
                $plugin->getBootstrap()->shutdown();
            } catch (\Exception $ex) {
                $this->disable($plugin, $ex);
            }
        }

        $this->endTimer([__METHOD__]);
    }

    protected function disable(\ElggPlugin $plugin, \Exception $previous): void {
        $this->getLogger()->log(LogLevel::ERROR, $previous, [
            'context' => [
                'plugin' => $plugin,
            ],
        ]);

        if (!$this->config->auto_disable_plugins) {
            return;
        }

        try {
            $id = $plugin->getID();
            $plugin->deactivate();

            $msg = $this->translator->translate(
                'PluginException:CannotStart',
                [$id, $plugin->guid, $previous->getMessage()]
            );

            elgg_add_admin_notice("cannot_start {$id}", $msg);
        } catch (PluginException $ex) {
            $this->getLogger()->log(LogLevel::ERROR, $ex, [
                'context' => [
                    'plugin' => $plugin,
                ],
            ]);
        }
    }

    public function find(string $status = 'active'): array {
        if (!$this->db || !$this->config->installed) {
            return [];
        }

        if ($status === 'active' && isset($this->boot_plugins)) {
            // boot_plugins is an already ordered list of plugins
            return array_values($this->boot_plugins);
        }
        
        $volatile_data_name = null;
        $site_guid = 1;

        // grab plugins
        $options = [
            'type' => 'object',
            'subtype' => 'plugin',
            'limit' => false,
            'order_by' => false,
        ];

        switch ($status) {
            case 'active':
                $options['relationship'] = 'active_plugin';
                $options['relationship_guid'] = $site_guid;
                $options['inverse_relationship'] = true;
                
                // shorten callstack
                $volatile_data_name = 'select:value';
                $options['select'] = ['n_table.value'];
                $options['metadata_names'] = [
                    \ElggPlugin::PRIORITY_SETTING_NAME,
                ];
                break;

            case 'inactive':
                $options['wheres'][] = function (QueryBuilder $qb, $main_alias) use ($site_guid) {
                    $subquery = $qb->subquery('entity_relationships', 'active_er');
                    $subquery->select('active_er.guid_one')
                        ->where($qb->compare('active_er.relationship', '=', 'active_plugin', ELGG_VALUE_STRING))
                        ->andWhere($qb->compare('active_er.guid_two', '=', $site_guid, ELGG_VALUE_GUID));

                    return $qb->compare("{$main_alias}.guid", 'NOT IN', $subquery->getSQL());
                };
                break;

            case 'all':
            default:
                break;
        }

        $old_ia = $this->session_manager->setIgnoreAccess(true);
        $plugins = elgg_get_entities($options) ?: [];
        $this->session_manager->setIgnoreAccess($old_ia);

        $result = $this->orderPluginsByPriority($plugins, $volatile_data_name);
        
        if ($status === 'active' && !isset($this->boot_plugins)) {
            // populate local cache if for some reason this is not set yet
            $this->setBootPlugins($result, false);
        }
        
        return $result;
    }
    
    protected function orderPluginsByPriority(array $plugins = [], string $volatile_data_name = null): array {
        $priorities = [];
        $sorted_plugins = [];
                
        foreach ($plugins as $plugin) {
            $priority = null;
            if (!empty($volatile_data_name)) {
                $priority = $plugin->getVolatileData($volatile_data_name);
            }
            
            if (!isset($priority)) {
                $priority = $plugin->getPriority();
            }
            
            $priorities[$plugin->guid] = (int) $priority;
            $sorted_plugins[$plugin->guid] = $plugin;
        }
        
        asort($priorities);
        
        return array_values(array_replace($priorities, $sorted_plugins));
    }

    public function setPriorities(array $order): bool {
        $name = \ElggPlugin::PRIORITY_SETTING_NAME;

        $plugins = $this->find('any');
        if (empty($plugins)) {
            return false;
        }

        // reindex to get standard counting. no need to increment by 10.
        // though we do start with 1
        $order = array_values($order);

        /* @var \ElggPlugin[] $missing_plugins */
        $missing_plugins = [];

        $priority = 0;
        foreach ($plugins as $plugin) {
            if (!$plugin->isEnabled()) {
                // disabled plugins should not have a priority
                if ($plugin->getPriority() !== null) {
                    // remove the priority
                    unset($plugin->$name);
                }
                
                continue;
            }
            
            $plugin_id = $plugin->getID();

            if (!in_array($plugin_id, $order)) {
                $missing_plugins[] = $plugin;
                continue;
            }

            $priority = array_search($plugin_id, $order) + 1;

            if (!$plugin->setMetadata($name, $priority)) {
                return false;
            }
        }

        // set the missing plugins' priorities
        if (empty($missing_plugins)) {
            return true;
        }

        foreach ($missing_plugins as $plugin) {
            $priority++;
            if (!$plugin->setMetadata($name, $priority)) {
                return false;
            }
        }

        return true;
    }

    public function reindexPriorities(): bool {
        return $this->setPriorities([]);
    }

    public function setPriority(\ElggPlugin $plugin, int $priority): int|false {
        $old_priority = $plugin->getPriority() ?: 1;

        $name = \ElggPlugin::PRIORITY_SETTING_NAME;

        if (!$plugin->setMetadata($name, $priority)) {
            return false;
        }

        if (!$plugin->guid) {
            return false;
        }

        $qb = Update::table('metadata');
        $qb->where($qb->compare('name', '=', $name, ELGG_VALUE_STRING))
            ->andWhere($qb->compare('entity_guid', '!=', $plugin->guid, ELGG_VALUE_INTEGER));

        if ($priority > $old_priority) {
            $qb->set('value', 'CAST(value AS UNSIGNED) - 1');
            $qb->andWhere($qb->between('CAST(value AS UNSIGNED)', $old_priority, $priority, ELGG_VALUE_INTEGER));
        } else {
            $qb->set('value', 'CAST(value AS UNSIGNED) + 1');
            $qb->andWhere($qb->between('CAST(value AS UNSIGNED)', $priority, $old_priority, ELGG_VALUE_INTEGER));
        }

        if (!$this->db->updateData($qb)) {
            return false;
        }

        return $priority;
    }
}