]> git.mxchange.org Git - friendica.git/blobdiff - src/App/Mode.php
Merge pull request #12583 from annando/delivery-queue
[friendica.git] / src / App / Mode.php
index 2a6722643eb9cd9cc1b10a6e398182eb39c51fee..59a47d8284360bf8838c826ebf52dc45f9105c14 100644 (file)
@@ -1,8 +1,28 @@
 <?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\Cache\ConfigCache;
+use Detection\MobileDetect;
+use Friendica\Core\Config\ValueObject\Cache;
 use Friendica\Database\Database;
 use Friendica\Util\BasePath;
 
@@ -18,21 +38,84 @@ class Mode
        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',
+               'pubsub',
+               'pubsubhubbub',
+               'receive',
+               'rsd_xml',
+               'salmon',
+               'statistics_json',
+               'xrd',
+       ];
+
        /***
         * @var int The mode of this Application
         *
         */
        private $mode;
 
+       /***
+        * @var int Who executes this Application
+        *
+        */
+       private $executor = self::UNDEFINED;
+
        /**
         * @var bool True, if the call is a backend call
         */
        private $isBackend;
 
-       public function __construct(int $mode = 0, bool $isBackend = false)
+       /**
+        * @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;
        }
 
        /**
@@ -46,7 +129,7 @@ class Mode
         *
         * @throws \Exception
         */
-       public function determine(BasePath $basepath, Database $database, ConfigCache $configCache)
+       public function determine(BasePath $basepath, Database $database, Cache $configCache): Mode
        {
                $mode = 0;
 
@@ -81,23 +164,33 @@ class Mode
 
                $mode |= Mode::MAINTENANCEDISABLED;
 
-               return new Mode($mode, $this->isBackend);
+               return new Mode($mode, $this->isBackend, $this->isAjax, $this->isMobile, $this->isTablet);
        }
 
        /**
         * Checks if the site is called via a backend process
         *
-        * @param Module $module The pre-loaded module (just name, not class!)
-        * @param array $server The $_SERVER variable
+        * @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 determineBackend(Module $module, array $server)
+       public function determineRunMode(bool $isBackend, array $server, Arguments $args, MobileDetect $mobileDetect): Mode
        {
-               $isBackend = basename(($server['PHP_SELF'] ?? ''), '.php') !== 'index' ||
-                            $module->isBackend();
+               foreach (self::BACKEND_CONTENT_TYPES as $type) {
+                       if (strpos(strtolower($server['HTTP_ACCEPT'] ?? ''), $type) !== false) {
+                               $isBackend = true;
+                       }
+               }
 
-               return new Mode($this->mode, $isBackend);
+               $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);
        }
 
        /**
@@ -107,18 +200,43 @@ class Mode
         *
         * @return bool returns true, if the mode is set
         */
-       public function has($mode)
+       public function has(int $mode): bool
        {
                return ($this->mode & $mode) > 0;
        }
 
+       /**
+        * Set the execution mode
+        *
+        * @param integer $executor Execution Mode
+        * @return void
+        */
+       public function setExecutor(int $executor)
+       {
+               $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(): int
+       {
+               return $this->executor;
+       }
 
        /**
         * Install mode is when the local config file is missing or the DB schema hasn't been installed yet.
         *
-        * @return bool
+        * @return bool Whether installation mode is active (local/database configuration files present or not)
         */
-       public function isInstall()
+       public function isInstall(): bool
        {
                return !$this->has(Mode::LOCALCONFIGPRESENT) ||
                       !$this->has(MODE::DBCONFIGAVAILABLE);
@@ -129,7 +247,7 @@ class Mode
         *
         * @return bool
         */
-       public function isNormal()
+       public function isNormal(): bool
        {
                return $this->has(Mode::LOCALCONFIGPRESENT) &&
                       $this->has(Mode::DBAVAILABLE) &&
@@ -142,8 +260,38 @@ class Mode
         *
         * @return bool Is it a backend call
         */
-       public function isBackend()
+       public function isBackend(): bool
        {
                return $this->isBackend;
        }
+
+       /**
+        * Check if request was an AJAX (xmlhttprequest) request.
+        *
+        * @return bool true if it was an AJAX request
+        */
+       public function isAjax(): bool
+       {
+               return $this->isAjax;
+       }
+
+       /**
+        * Check if request was a mobile request.
+        *
+        * @return bool true if it was an mobile request
+        */
+       public function isMobile(): bool
+       {
+               return $this->isMobile;
+       }
+
+       /**
+        * Check if request was a tablet request.
+        *
+        * @return bool true if it was an tablet request
+        */
+       public function isTablet(): bool
+       {
+               return $this->isTablet;
+       }
 }