PDF rausgenommen

msd2/tracking/piwik/core/Application/Kernel/EnvironmentValidator.php

@@ -0,0 +1,143 @@
+<?php
+/**
+ * Piwik - free/libre analytics platform
+ *
+ * @link http://piwik.org
+ * @license http://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
+ */
+
+namespace Piwik\Application\Kernel;
+
+use Piwik\Common;
+use Piwik\Exception\NotYetInstalledException;
+use Piwik\Filechecks;
+use Piwik\Piwik;
+use Piwik\SettingsPiwik;
+use Piwik\SettingsServer;
+use Piwik\Translation\Translator;
+
+/**
+ * Validates the Piwik environment. This includes making sure the required config files
+ * are present, and triggering the correct behaviour if otherwise.
+ */
+class EnvironmentValidator
+{
+    /**
+     * @var GlobalSettingsProvider
+     */
+    protected $settingsProvider;
+
+    /**
+     * @var Translator
+     */
+    protected $translator;
+
+    public function __construct(GlobalSettingsProvider $settingsProvider, Translator $translator)
+    {
+        $this->settingsProvider = $settingsProvider;
+        $this->translator = $translator;
+    }
+
+    public function validate()
+    {
+        $this->checkConfigFileExists($this->settingsProvider->getPathGlobal());
+
+        if(SettingsPiwik::isPiwikInstalled()) {
+            $this->checkConfigFileExists($this->settingsProvider->getPathLocal(), $startInstaller = false);
+            return;
+        }
+
+        $startInstaller = true;
+
+        if(SettingsServer::isTrackerApiRequest()) {
+            // if Piwik is not installed yet, the piwik.php should do nothing and not return an error
+            throw new NotYetInstalledException("As Matomo is not installed yet, the Tracking API cannot proceed and will exit without error.");
+        }
+
+        if(Common::isPhpCliMode()) {
+            // in CLI, do not start/redirect to installer, simply output the exception at the top
+            $startInstaller = false;
+        }
+
+        // Start the installation when config file not found
+        $this->checkConfigFileExists($this->settingsProvider->getPathLocal(), $startInstaller);
+
+    }
+
+    /**
+     * @param $path
+     * @param bool $startInstaller
+     * @throws \Exception
+     */
+    private function checkConfigFileExists($path, $startInstaller = false)
+    {
+        if (is_readable($path)) {
+            return;
+        }
+
+        $message = $this->getSpecificMessageWhetherFileExistsOrNot($path);
+
+        $exception = new NotYetInstalledException($message);
+
+        if ($startInstaller) {
+            $this->startInstallation($exception);
+        } else {
+            throw $exception;
+        }
+    }
+
+    /**
+     * @param $exception
+     */
+    private function startInstallation($exception)
+    {
+        /**
+         * Triggered when the configuration file cannot be found or read, which usually
+         * means Piwik is not installed yet.
+         *
+         * This event can be used to start the installation process or to display a custom error message.
+         *
+         * @param \Exception $exception The exception that was thrown by `Config::getInstance()`.
+         */
+        Piwik::postEvent('Config.NoConfigurationFile', array($exception), $pending = true);
+    }
+
+    /**
+     * @param $path
+     * @return string
+     */
+    private function getMessageWhenFileExistsButNotReadable($path)
+    {
+        $format = " \n<b>» %s </b>";
+        if(Common::isPhpCliMode()) {
+            $format = "\n » %s \n";
+        }
+
+        return sprintf($format,
+            $this->translator->translate('General_ExceptionConfigurationFilePleaseCheckReadableByUser',
+                array($path, Filechecks::getUser())));
+    }
+
+    /**
+     * @param $path
+     * @return string
+     */
+    private function getSpecificMessageWhetherFileExistsOrNot($path)
+    {
+        if (!file_exists($path)) {
+            $message = $this->translator->translate('General_ExceptionConfigurationFileNotFound', array($path));
+            if (Common::isPhpCliMode()) {
+                $message .= $this->getMessageWhenFileExistsButNotReadable($path);
+            }
+        } else {
+            $message = $this->translator->translate('General_ExceptionConfigurationFileExistsButNotReadable',
+                array($path));
+            $message .= $this->getMessageWhenFileExistsButNotReadable($path);
+        }
+
+        if (Common::isPhpCliMode()) {
+            $message = "\n" . $message;
+        }
+        return $message;
+    }
+}

msd2/tracking/piwik/core/Application/Kernel/GlobalSettingsProvider.php

@@ -0,0 +1,111 @@
+<?php
+/**
+ * Piwik - free/libre analytics platform
+ *
+ * @link http://piwik.org
+ * @license http://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
+ */
+
+namespace Piwik\Application\Kernel;
+
+use Piwik\Config;
+use Piwik\Config\IniFileChain;
+
+/**
+ * Provides global settings. Global settings are organized in sections where
+ * each section contains a list of name => value pairs. Setting values can
+ * be primitive values or arrays of primitive values.
+ *
+ * Uses the config.ini.php, common.ini.php and global.ini.php files to provide global settings.
+ *
+ * At the moment a singleton instance of this class is used in order to get tests to pass.
+ */
+class GlobalSettingsProvider
+{
+    /**
+     * @var IniFileChain
+     */
+    protected $iniFileChain;
+
+    /**
+     * @var string
+     */
+    protected $pathGlobal = null;
+
+    /**
+     * @var string
+     */
+    protected $pathCommon = null;
+
+    /**
+     * @var string
+     */
+    protected $pathLocal = null;
+
+    /**
+     * @param string|null $pathGlobal Path to the global.ini.php file. Or null to use the default.
+     * @param string|null $pathLocal Path to the config.ini.php file. Or null to use the default.
+     * @param string|null $pathCommon Path to the common.ini.php file. Or null to use the default.
+     */
+    public function __construct($pathGlobal = null, $pathLocal = null, $pathCommon = null)
+    {
+        $this->pathGlobal = $pathGlobal ?: Config::getGlobalConfigPath();
+        $this->pathCommon = $pathCommon ?: Config::getCommonConfigPath();
+        $this->pathLocal = $pathLocal ?: Config::getLocalConfigPath();
+
+        $this->iniFileChain = new IniFileChain();
+        $this->reload();
+    }
+
+    public function reload($pathGlobal = null, $pathLocal = null, $pathCommon = null)
+    {
+        $this->pathGlobal = $pathGlobal ?: $this->pathGlobal;
+        $this->pathCommon = $pathCommon ?: $this->pathCommon;
+        $this->pathLocal = $pathLocal ?: $this->pathLocal;
+
+        $this->iniFileChain->reload(array($this->pathGlobal, $this->pathCommon), $this->pathLocal);
+    }
+
+    /**
+     * Returns a settings section.
+     *
+     * @param string $name
+     * @return array
+     */
+    public function &getSection($name)
+    {
+        $section =& $this->iniFileChain->get($name);
+        return $section;
+    }
+
+    /**
+     * Sets a settings section.
+     *
+     * @param string $name
+     * @param array $value
+     */
+    public function setSection($name, $value)
+    {
+        $this->iniFileChain->set($name, $value);
+    }
+
+    public function getIniFileChain()
+    {
+        return $this->iniFileChain;
+    }
+
+    public function getPathGlobal()
+    {
+        return $this->pathGlobal;
+    }
+
+    public function getPathLocal()
+    {
+        return $this->pathLocal;
+    }
+
+    public function getPathCommon()
+    {
+        return $this->pathCommon;
+    }
+}

msd2/tracking/piwik/core/Application/Kernel/PluginList.php

@@ -0,0 +1,193 @@
+<?php
+/**
+ * Piwik - free/libre analytics platform
+ *
+ * @link http://piwik.org
+ * @license http://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
+ */
+
+namespace Piwik\Application\Kernel;
+
+use Piwik\Plugin\MetadataLoader;
+
+/**
+ * Lists the currently activated plugins. Used when setting up Piwik's environment before
+ * initializing the DI container.
+ *
+ * Uses the [Plugins] section in Piwik's INI config to get the activated plugins.
+ *
+ * Depends on GlobalSettingsProvider being used.
+ *
+ * TODO: parts of Plugin\Manager edit the plugin list; maybe PluginList implementations should be mutable?
+ */
+class PluginList
+{
+    /**
+     * @var GlobalSettingsProvider
+     */
+    private $settings;
+
+    /**
+     * Plugins bundled with core package, disabled by default
+     * @var array
+     */
+    private $corePluginsDisabledByDefault = array(
+        'DBStats',
+        'ExampleCommand',
+        'ExampleSettingsPlugin',
+        'ExampleUI',
+        'ExampleVisualization',
+        'ExamplePluginTemplate',
+        'ExampleTracker',
+        'ExampleLogTables',
+        'ExampleReport',
+        'MobileAppMeasurable',
+        'Provider',
+        'TagManager'
+    );
+
+    // Themes bundled with core package, disabled by default
+    private $coreThemesDisabledByDefault = array(
+        'ExampleTheme'
+    );
+
+    public function __construct(GlobalSettingsProvider $settings)
+    {
+        $this->settings = $settings;
+    }
+
+    /**
+     * Returns the list of plugins that should be loaded. Used by the container factory to
+     * load plugin specific DI overrides.
+     *
+     * @return string[]
+     */
+    public function getActivatedPlugins()
+    {
+        $section = $this->settings->getSection('Plugins');
+        return @$section['Plugins'] ?: array();
+    }
+
+    /**
+     * Returns the list of plugins that are bundled with Piwik.
+     *
+     * @return string[]
+     */
+    public function getPluginsBundledWithPiwik()
+    {
+        $pathGlobal = $this->settings->getPathGlobal();
+
+        $section = $this->settings->getIniFileChain()->getFrom($pathGlobal, 'Plugins');
+        return $section['Plugins'];
+    }
+
+    /**
+     * Returns the plugins bundled with core package that are disabled by default.
+     *
+     * @return string[]
+     */
+    public function getCorePluginsDisabledByDefault()
+    {
+        return array_merge($this->corePluginsDisabledByDefault, $this->coreThemesDisabledByDefault);
+    }
+
+    /**
+     * Sorts an array of plugins in the order they should be loaded. We cannot use DI here as DI is not initialized
+     * at this stage.
+     *
+     * @params string[] $plugins
+     * @return \string[]
+     */
+    public function sortPlugins(array $plugins)
+    {
+        $global = $this->getPluginsBundledWithPiwik();
+        if (empty($global)) {
+            return $plugins;
+        }
+
+        // we need to make sure a possibly disabled plugin will be still loaded before any 3rd party plugin
+        $global = array_merge($global, $this->corePluginsDisabledByDefault);
+
+        $global = array_values($global);
+        $plugins = array_values($plugins);
+
+        $defaultPluginsLoadedFirst = array_intersect($global, $plugins);
+
+        $otherPluginsToLoadAfterDefaultPlugins = array_diff($plugins, $defaultPluginsLoadedFirst);
+
+        // sort by name to have a predictable order for those extra plugins
+        natcasesort($otherPluginsToLoadAfterDefaultPlugins);
+
+        $sorted = array_merge($defaultPluginsLoadedFirst, $otherPluginsToLoadAfterDefaultPlugins);
+
+        return $sorted;
+    }
+
+    /**
+     * Sorts an array of plugins in the order they should be saved in config.ini.php. This basically influences
+     * the order of the plugin config.php and which config will be loaded first. We want to make sure to require the
+     * config or a required plugin first before loading the plugin that requires it.
+     *
+     * We do not sort using this logic on each request since it is much slower than `sortPlugins()`. The order
+     * of plugins in config.ini.php is only important for the ContainerFactory. During a regular request it is otherwise
+     * fine to load the plugins in the order of `sortPlugins()` since we will make sure that required plugins will be
+     * loaded first in plugin manager.
+     *
+     * @param string[] $plugins
+     * @param array[] $pluginJsonCache  For internal testing only
+     * @return \string[]
+     */
+    public function sortPluginsAndRespectDependencies(array $plugins, $pluginJsonCache = array())
+    {
+        $global = $this->getPluginsBundledWithPiwik();
+
+        if (empty($global)) {
+            return $plugins;
+        }
+
+        // we need to make sure a possibly disabled plugin will be still loaded before any 3rd party plugin
+        $global = array_merge($global, $this->corePluginsDisabledByDefault);
+
+        $global = array_values($global);
+        $plugins = array_values($plugins);
+
+        $defaultPluginsLoadedFirst = array_intersect($global, $plugins);
+
+        $otherPluginsToLoadAfterDefaultPlugins = array_diff($plugins, $defaultPluginsLoadedFirst);
+
+        // we still want to sort alphabetically by default
+        natcasesort($otherPluginsToLoadAfterDefaultPlugins);
+
+        $sorted = array();
+        foreach ($otherPluginsToLoadAfterDefaultPlugins as $pluginName) {
+            $sorted = $this->sortRequiredPlugin($pluginName, $pluginJsonCache, $otherPluginsToLoadAfterDefaultPlugins, $sorted);
+        }
+
+        $sorted = array_merge($defaultPluginsLoadedFirst, $sorted);
+
+        return $sorted;
+    }
+
+    private function sortRequiredPlugin($pluginName, &$pluginJsonCache, $toBeSorted, $sorted)
+    {
+        if (!isset($pluginJsonCache[$pluginName])) {
+            $loader = new MetadataLoader($pluginName);
+            $pluginJsonCache[$pluginName] = $loader->loadPluginInfoJson();
+        }
+
+        if (!empty($pluginJsonCache[$pluginName]['require'])) {
+            $dependencies = $pluginJsonCache[$pluginName]['require'];
+            foreach ($dependencies as $possiblePluginName => $key) {
+                if (in_array($possiblePluginName, $toBeSorted, true) && !in_array($possiblePluginName, $sorted, true)) {
+                    $sorted = $this->sortRequiredPlugin($possiblePluginName, $pluginJsonCache, $toBeSorted, $sorted);
+                }
+            }
+        }
+
+        if (!in_array($pluginName, $sorted, true)) {
+            $sorted[] = $pluginName;
+        }
+
+        return $sorted;
+    }
+}