JezK

Edit File: Console.php

<?php

/**
 * Matomo - free/libre analytics platform
 *
 * @link    https://matomo.org
 * @license https://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
 */
namespace Piwik;

use Exception;
use Matomo\Dependencies\Monolog\Handler\FingersCrossedHandler;
use Piwik\Application\Environment;
use Piwik\Config\ConfigNotFoundException;
use Piwik\Container\StaticContainer;
use Piwik\Plugin\Manager as PluginManager;
use Piwik\Plugins\Monolog\Handler\FailureLogMessageDetector;
use Piwik\Log\LoggerInterface;
use Matomo\Dependencies\Symfony\Bridge\Monolog\Handler\ConsoleHandler;
use Matomo\Dependencies\Symfony\Component\Console\Application;
use Matomo\Dependencies\Symfony\Component\Console\Command\Command;
use Matomo\Dependencies\Symfony\Component\Console\Input\InputInterface;
use Matomo\Dependencies\Symfony\Component\Console\Input\InputOption;
use Matomo\Dependencies\Symfony\Component\Console\Output\OutputInterface;
class Console extends Application
{
    /**
     * @var Environment
     */
    private $environment;
    public function __construct(?Environment $environment = null)
    {
        $this->setServerArgsIfPhpCgi();
        parent::__construct('Matomo', \Piwik\Version::VERSION);
        $this->environment = $environment;
        $option = new InputOption('matomo-domain', null, InputOption::VALUE_OPTIONAL, 'Matomo URL (protocol and domain) eg. "http://matomo.example.org"');
        $this->getDefinition()->addOption($option);
        $option = new InputOption('xhprof', null, InputOption::VALUE_NONE, 'Enable profiling with XHProf');
        $this->getDefinition()->addOption($option);
        $option = new InputOption('ignore-warn', null, InputOption::VALUE_NONE, 'Return 0 exit code even if there are warning logs or error logs detected in the command output.');
        $this->getDefinition()->addOption($option);
    }
    public function renderThrowable(\Throwable $e, OutputInterface $output) : void
    {
        $logHandlers = StaticContainer::get('log.handlers');
        $hasFingersCrossed = \false;
        foreach ($logHandlers as $handler) {
            if ($handler instanceof FingersCrossedHandler) {
                $hasFingersCrossed = \true;
                break;
            }
        }
        if ($hasFingersCrossed && !$output->isVerbose()) {
            $output->setVerbosity(OutputInterface::VERBOSITY_VERBOSE);
        }
        parent::renderThrowable($e, $output);
    }
    public function doRun(InputInterface $input, OutputInterface $output)
    {
        try {
            return $this->doRunImpl($input, $output);
        } catch (\Exception $ex) {
            try {
                \Piwik\FrontController::generateSafeModeOutputFromException($ex);
            } catch (\Exception $ex) {
                // ignore, we re-throw the original exception, not a wrapped one
            }
            throw $ex;
        }
    }
    /**
     * Makes parent doRun method available
     *
     * @param InputInterface  $input
     * @param OutputInterface $output
     * @return int
     */
    public function originDoRun(InputInterface $input, OutputInterface $output)
    {
        return parent::doRun($input, $output);
    }
    private function doRunImpl(InputInterface $input, OutputInterface $output)
    {
        if ($input->hasParameterOption('--xhprof')) {
            \Piwik\Profiler::setupProfilerXHProf(\true, \true);
        }
        $this->initMatomoHost($input);
        $this->initEnvironment($output);
        $this->initLoggerOutput($output);
        try {
            self::initPlugins();
        } catch (ConfigNotFoundException $e) {
            // Piwik not installed yet, no config file?
            \Piwik\Log::warning($e->getMessage());
        }
        $this->initAuth();
        $commands = $this->getAvailableCommands();
        foreach ($commands as $command) {
            $this->addCommandIfExists($command);
        }
        $exitCode = null;
        /**
         * @ignore
         */
        \Piwik\Piwik::postEvent('Console.doRun', [&$exitCode, $input, $output]);
        if ($exitCode === null) {
            $self = $this;
            /*
             * Ensure to run console command with super user permission. Otherwise any permission check would fail,
             * as we do not have any user session or authentication in place.
             */
            $exitCode = \Piwik\Access::doAsSuperUser(function () use($input, $output, $self) {
                return call_user_func(array($self, 'originDoRun'), $input, $output);
            });
        }
        $importantLogDetector = StaticContainer::get(FailureLogMessageDetector::class);
        if (!$input->hasParameterOption('--ignore-warn') && $exitCode === 0 && $importantLogDetector->hasEncounteredImportantLog()) {
            $output->writeln("Error: error or warning logs detected, exit 1");
            $exitCode = 1;
        }
        return $exitCode;
    }
    private function addCommandIfExists($command)
    {
        if (!class_exists($command)) {
            \Piwik\Log::warning(sprintf('Cannot add command %s, class does not exist', $command));
        } elseif (!is_subclass_of($command, 'Piwik\\Plugin\\ConsoleCommand')) {
            \Piwik\Log::warning(sprintf('Cannot add command %s, class does not extend Piwik\\Plugin\\ConsoleCommand', $command));
        } else {
            /** @var Command $commandInstance */
            $commandInstance = new $command();
            // do not add the command if it already exists; this way we can add the command ourselves in tests
            if (!$this->has($commandInstance->getName())) {
                $this->add($commandInstance);
            }
        }
    }
    /**
     * Returns a list of available command classnames.
     *
     * @return string[]
     */
    private function getAvailableCommands()
    {
        $commands = $this->getDefaultPiwikCommands();
        $detected = PluginManager::getInstance()->findMultipleComponents('Commands', 'Piwik\\Plugin\\ConsoleCommand');
        $commands = array_merge($commands, $detected);
        /**
         * Triggered to filter / restrict console commands. Plugins that want to restrict commands
         * should subscribe to this event and remove commands from the existing list.
         *
         * **Example**
         *
         *     public function filterConsoleCommands(&$commands)
         *     {
         *         $key = array_search('Piwik\Plugins\MyPlugin\Commands\MyCommand', $commands);
         *         if (false !== $key) {
         *             unset($commands[$key]);
         *         }
         *     }
         *
         * @param array &$commands An array containing a list of command class names.
         */
        \Piwik\Piwik::postEvent('Console.filterCommands', array(&$commands));
        $commands = array_values(array_unique($commands));
        return $commands;
    }
    private function setServerArgsIfPhpCgi()
    {
        if (\Piwik\Common::isPhpCgiType()) {
            $_SERVER['argv'] = array();
            foreach ($_GET as $name => $value) {
                $argument = $name;
                if (!empty($value)) {
                    $argument .= '=' . $value;
                }
                $_SERVER['argv'][] = $argument;
            }
            if (!defined('STDIN')) {
                define('STDIN', fopen('php://stdin', 'r'));
            }
        }
    }
    public static function isSupported()
    {
        return \Piwik\Common::isPhpCliMode() && !\Piwik\Common::isPhpCgiType();
    }
    protected function initMatomoHost(InputInterface $input)
    {
        $matomoHostname = $input->getParameterOption('--matomo-domain');
        if (empty($matomoHostname)) {
            $matomoHostname = $input->getParameterOption('--url');
        }
        $matomoHostname = \Piwik\UrlHelper::getHostFromUrl($matomoHostname);
        \Piwik\Url::setHost($matomoHostname);
    }
    protected function initEnvironment(OutputInterface $output)
    {
        try {
            if ($this->environment === null) {
                $this->environment = new Environment('cli');
                $this->environment->init();
            }
            $config = \Piwik\Config::getInstance();
            return $config;
        } catch (\Exception $e) {
            $output->writeln($e->getMessage() . "\n");
        }
    }
    /**
     * Register the console output into the logger.
     *
     * Ideally, this should be done automatically with events:
     * @see https://symfony.com/fr/doc/current/components/console/events.html
     * @see Symfony\Bridge\Monolog\Handler\ConsoleHandler::onCommand()
     * But it would require to install Symfony's Event Dispatcher.
     */
    private function initLoggerOutput(OutputInterface $output)
    {
        /** @var ConsoleHandler $consoleLogHandler */
        $consoleLogHandler = StaticContainer::get('Matomo\\Dependencies\\Symfony\\Bridge\\Monolog\\Handler\\ConsoleHandler');
        $consoleLogHandler->setOutput($output);
    }
    public static function initPlugins()
    {
        \Piwik\Plugin\Manager::getInstance()->loadActivatedPlugins();
        \Piwik\Plugin\Manager::getInstance()->loadPluginTranslations();
    }
    private function getDefaultPiwikCommands()
    {
        $commands = array('Piwik\\CliMulti\\RequestCommand');
        $commandsFromPluginsMarkedInConfig = $this->getCommandsFromPluginsMarkedInConfig();
        $commands = array_merge($commands, $commandsFromPluginsMarkedInConfig);
        return $commands;
    }
    private function getCommandsFromPluginsMarkedInConfig()
    {
        $plugins = \Piwik\Config::getInstance()->General['always_load_commands_from_plugin'];
        $plugins = explode(',', $plugins);
        $commands = array();
        foreach ($plugins as $plugin) {
            $instance = new \Piwik\Plugin($plugin);
            $commands = array_merge($commands, $instance->findMultipleComponents('Commands', 'Piwik\\Plugin\\ConsoleCommand'));
        }
        return $commands;
    }
    private function initAuth()
    {
        \Piwik\Piwik::postEvent('Request.initAuthenticationObject');
        try {
            StaticContainer::get('Piwik\\Auth');
        } catch (Exception $e) {
            $message = "Authentication object cannot be found in the container. Maybe the Login plugin is not activated?\n                        You can activate the plugin by adding:\n                        Plugins[] = Login\n                        under the [Plugins] section in your config/config.ini.php";
            StaticContainer::get(LoggerInterface::class)->warning($message);
        }
    }
}