<?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 Detection\MobileDetect;
-use Friendica\Core\Config\Cache;
+use Friendica\Core\Config\ValueObject\Cache;
use Friendica\Database\Database;
use Friendica\Util\BasePath;
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 Who executes this Application
+ *
+ */
+ private $executor = self::UNDEFINED;
+
/**
* @var bool True, if the call is a backend call
*/
*
* @throws \Exception
*/
- public function determine(BasePath $basepath, Database $database, Cache $configCache)
+ public function determine(BasePath $basepath, Database $database, Cache $configCache): Mode
{
$mode = 0;
/**
* 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 Module $module The pre-loaded module (just name, not class!)
- * @param array $server The $_SERVER variable
- * @param MobileDetect $mobileDetect The mobile detection library
+ * @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, Module $module, array $server, MobileDetect $mobileDetect)
+ public function determineRunMode(bool $isBackend, array $server, Arguments $args, MobileDetect $mobileDetect): Mode
{
- $isBackend = $isBackend ||
- $module->isBackend();
+ foreach (self::BACKEND_CONTENT_TYPES as $type) {
+ if (strpos(strtolower($server['HTTP_ACCEPT'] ?? ''), $type) !== false) {
+ $isBackend = true;
+ }
+ }
+
+ $isBackend = $isBackend || in_array($args->getModuleName(), static::BACKEND_MODULES);
$isMobile = $mobileDetect->isMobile();
$isTablet = $mobileDetect->isTablet();
$isAjax = strtolower($server['HTTP_X_REQUESTED_WITH'] ?? '') == 'xmlhttprequest';
*
* @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);
*
* @return bool
*/
- public function isNormal()
+ public function isNormal(): bool
{
return $this->has(Mode::LOCALCONFIGPRESENT) &&
$this->has(Mode::DBAVAILABLE) &&
*
* @return bool Is it a backend call
*/
- public function isBackend()
+ public function isBackend(): bool
{
return $this->isBackend;
}
*
* @return bool true if it was an AJAX request
*/
- public function isAjax()
+ public function isAjax(): bool
{
return $this->isAjax;
}
*
* @return bool true if it was an mobile request
*/
- public function isMobile()
+ public function isMobile(): bool
{
return $this->isMobile;
}
*
* @return bool true if it was an tablet request
*/
- public function isTablet()
+ public function isTablet(): bool
{
return $this->isTablet;
}