]> git.mxchange.org Git - friendica.git/blobdiff - src/App/Mode.php
AP endpoints are now cached
[friendica.git] / src / App / Mode.php
index 189573e3782d994afe95d684619c23a5cc3b5a80..3e7b9f0d1679a0fa07a362c8393c785d0d1452e9 100644 (file)
@@ -1,9 +1,30 @@
 <?php
+/**
+ * @copyright Copyright (C) 2010-2022, the Friendica project
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
+ */
 
 namespace Friendica\App;
 
-use Friendica\Core\Config;
-use Friendica\Database\DBA;
+use Detection\MobileDetect;
+use Friendica\Core\Config\ValueObject\Cache;
+use Friendica\Database\Database;
+use Friendica\Util\BasePath;
 
 /**
  * Mode of the current Friendica Node
@@ -12,17 +33,91 @@ use Friendica\Database\DBA;
  */
 class Mode
 {
-       const LOCALCONFIGPRESENT = 1;
-       const DBAVAILABLE = 2;
-       const DBCONFIGAVAILABLE = 4;
+       const LOCALCONFIGPRESENT  = 1;
+       const DBAVAILABLE         = 2;
+       const DBCONFIGAVAILABLE   = 4;
        const MAINTENANCEDISABLED = 8;
 
+       const UNDEFINED = 0;
+       const INDEX = 1;
+       const DAEMON = 2;
+       const WORKER = 3;
+
+       const BACKEND_CONTENT_TYPES = ['application/jrd+json', 'text/xml',
+               'application/rss+xml', 'application/atom+xml', 'application/activity+json'];
+
+       /**
+        * A list of modules, which are backend methods
+        *
+        * @var array
+        */
+       const BACKEND_MODULES = [
+               '_well_known',
+               'api',
+               'dfrn_notify',
+               'feed',
+               'fetch',
+               'followers',
+               'following',
+               'hcard',
+               'hostxrd',
+               'inbox',
+               'manifest',
+               'nodeinfo',
+               'noscrape',
+               'objects',
+               'outbox',
+               'poco',
+               'post',
+               'pubsub',
+               'pubsubhubbub',
+               'receive',
+               'rsd_xml',
+               'salmon',
+               'statistics_json',
+               'xrd',
+       ];
+
+       /***
+        * @var int The mode of this Application
+        *
+        */
+       private $mode;
+
        /***
-        * @var int the mode of this Application
+        * @var int Who executes this Application
         *
-        * Default is 0 (= not set)
         */
-       private static $mode = 0;
+       private $executor = self::UNDEFINED;
+
+       /**
+        * @var bool True, if the call is a backend call
+        */
+       private $isBackend;
+
+       /**
+        * @var bool True, if the call is a ajax call
+        */
+       private $isAjax;
+
+       /**
+        * @var bool True, if the call is from a mobile device
+        */
+       private $isMobile;
+
+       /**
+        * @var bool True, if the call is from a tablet device
+        */
+       private $isTablet;
+
+       public function __construct(int $mode = 0, bool $isBackend = false, bool $isAjax = false, bool $isMobile = false, bool $isTablet = false)
+       {
+               $this->mode      = $mode;
+               $this->isBackend = $isBackend;
+               $this->isAjax    = $isAjax;
+               $this->isMobile  = $isMobile;
+               $this->isTablet  = $isTablet;
+       }
 
        /**
         * Sets the App mode
@@ -31,37 +126,72 @@ class Mode
         * - App::MODE_MAINTENANCE: The maintenance mode has been set
         * - App::MODE_NORMAL     : Normal run with all features enabled
         *
-        * @param string $basepath the Basepath of the Application
+        * @return Mode returns the determined mode
         *
+        * @throws \Exception
         */
-       public static function determine($basepath)
+       public function determine(BasePath $basepath, Database $database, Cache $configCache)
        {
-               self::$mode = 0;
+               $mode = 0;
+
+               $basepathName = $basepath->getPath();
+
+               if (!file_exists($basepathName . '/config/local.config.php')
+                   && !file_exists($basepathName . '/config/local.ini.php')
+                   && !file_exists($basepathName . '/.htconfig.php')) {
+                       return new Mode($mode);
+               }
 
-               if (!file_exists($basepath . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'local.ini.php')
-                       && !file_exists($basepath . DIRECTORY_SEPARATOR . '.htconfig.php')) {
-                       return;
+               $mode |= Mode::LOCALCONFIGPRESENT;
+
+               if (!$database->connected()) {
+                       return new Mode($mode);
                }
 
-               self::$mode |= Mode::LOCALCONFIGPRESENT;
+               $mode |= Mode::DBAVAILABLE;
 
-               if (!DBA::connected()) {
-                       return;
+               if ($database->fetchFirst("SHOW TABLES LIKE 'config'") === false) {
+                       return new Mode($mode);
                }
 
-               self::$mode |= Mode::DBAVAILABLE;
+               $mode |= Mode::DBCONFIGAVAILABLE;
 
-               if (DBA::fetchFirst("SHOW TABLES LIKE 'config'") === false) {
-                       return;
+               if (!empty($configCache->get('system', 'maintenance')) ||
+                   // Don't use Config or Configuration here because we're possibly BEFORE initializing the Configuration,
+                   // so this could lead to a dependency circle
+                   !empty($database->selectFirst('config', ['v'], ['cat' => 'system', 'k' => 'maintenance'])['v'])) {
+                       return new Mode($mode);
                }
 
-               self::$mode |= Mode::DBCONFIGAVAILABLE;
+               $mode |= Mode::MAINTENANCEDISABLED;
+
+               return new Mode($mode, $this->isBackend, $this->isAjax, $this->isMobile, $this->isTablet);
+       }
 
-               if (Config::get('system', 'maintenance')) {
-                       return;
+       /**
+        * Checks if the site is called via a backend process
+        *
+        * @param bool             $isBackend    True, if the call is from a backend script (daemon, worker, ...)
+        * @param array            $server       The $_SERVER variable
+        * @param Arguments        $args         The Friendica App arguments
+        * @param MobileDetect     $mobileDetect The mobile detection library
+        *
+        * @return Mode returns the determined mode
+        */
+       public function determineRunMode(bool $isBackend, array $server, Arguments $args, MobileDetect $mobileDetect)
+       {
+               foreach (self::BACKEND_CONTENT_TYPES as $type) {
+                       if (strpos(strtolower($server['HTTP_ACCEPT'] ?? ''), $type) !== false) {
+                               $isBackend = true;
+                       }
                }
 
-               self::$mode |= Mode::MAINTENANCEDISABLED;
+               $isBackend = $isBackend || in_array($args->getModuleName(), static::BACKEND_MODULES);
+               $isMobile  = $mobileDetect->isMobile();
+               $isTablet  = $mobileDetect->isTablet();
+               $isAjax    = strtolower($server['HTTP_X_REQUESTED_WITH'] ?? '') == 'xmlhttprequest';
+
+               return new Mode($this->mode, $isBackend, $isAjax, $isMobile, $isTablet);
        }
 
        /**
@@ -71,21 +201,46 @@ class Mode
         *
         * @return bool returns true, if the mode is set
         */
-       public static function has($mode)
+       public function has($mode)
+       {
+               return ($this->mode & $mode) > 0;
+       }
+
+       /**
+        * Set the execution mode
+        *
+        * @param integer $executor Execution Mode
+        * @return void
+        */
+       public function setExecutor(int $executor)
        {
-               return self::$mode & $mode;
+               $this->executor = $executor;
+
+               // Daemon and worker are always backend
+               if (in_array($executor, [self::DAEMON, self::WORKER])) {
+                       $this->isBackend = true;
+               }
        }
 
+       /*isBackend = true;*
+        * get the execution mode
+        *
+        * @return int Execution Mode
+        */
+       public function getExecutor()
+       {
+               return $this->executor;
+       }
 
        /**
         * Install mode is when the local config file is missing or the DB schema hasn't been installed yet.
         *
         * @return bool
         */
-       public static function isInstall()
+       public function isInstall()
        {
-               return !self::has(Mode::LOCALCONFIGPRESENT) ||
-                       !self::has(MODE::DBCONFIGAVAILABLE);
+               return !$this->has(Mode::LOCALCONFIGPRESENT) ||
+                      !$this->has(MODE::DBCONFIGAVAILABLE);
        }
 
        /**
@@ -93,11 +248,51 @@ class Mode
         *
         * @return bool
         */
-       public static function isNormal()
+       public function isNormal()
+       {
+               return $this->has(Mode::LOCALCONFIGPRESENT) &&
+                      $this->has(Mode::DBAVAILABLE) &&
+                      $this->has(Mode::DBCONFIGAVAILABLE) &&
+                      $this->has(Mode::MAINTENANCEDISABLED);
+       }
+
+       /**
+        * Returns true, if the call is from a backend node (f.e. from a worker)
+        *
+        * @return bool Is it a backend call
+        */
+       public function isBackend()
+       {
+               return $this->isBackend;
+       }
+
+       /**
+        * Check if request was an AJAX (xmlhttprequest) request.
+        *
+        * @return bool true if it was an AJAX request
+        */
+       public function isAjax()
+       {
+               return $this->isAjax;
+       }
+
+       /**
+        * Check if request was a mobile request.
+        *
+        * @return bool true if it was an mobile request
+        */
+       public function isMobile()
+       {
+               return $this->isMobile;
+       }
+
+       /**
+        * Check if request was a tablet request.
+        *
+        * @return bool true if it was an tablet request
+        */
+       public function isTablet()
        {
-               return self::has(Mode::LOCALCONFIGPRESENT) &&
-                       self::has(Mode::DBAVAILABLE) &&
-                       self::has(Mode::DBCONFIGAVAILABLE) &&
-                       self::has(Mode::MAINTENANCEDISABLED);
+               return $this->isTablet;
        }
 }