]> git.mxchange.org Git - friendica.git/blobdiff - src/Core/System.php
Remove confirm template obsolete uses (except for contacts)
[friendica.git] / src / Core / System.php
index 7aba0653e1afcd74dde753e3c80f92a8fecf28a2..e84fcb5737733f649f13bf3ed4c2a3e34c51e4fe 100644 (file)
@@ -1,79 +1,67 @@
 <?php
 /**
- * @file src/Core/System.php
+ * @copyright Copyright (C) 2020, Friendica
+ *
+ * @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\Core;
 
-use Friendica\App\BaseURL;
-use Friendica\BaseObject;
+use Friendica\DI;
 use Friendica\Network\HTTPException\InternalServerErrorException;
 use Friendica\Util\XML;
 
 /**
- * @file include/Core/System.php
- *
- * @brief Contains the class with system relevant stuff
- */
-
-
-/**
- * @brief System methods
+ * Contains the class with system relevant stuff
  */
-class System extends BaseObject
+class System
 {
        /**
-        * @brief Retrieves the Friendica instance base URL
+        * Returns a string with a callstack. Can be used for logging.
         *
-        * @param bool $ssl Whether to append http or https under BaseURL::SSL_POLICY_SELFSIGN
-        * @return string Friendica server base URL
-        * @throws InternalServerErrorException
-        */
-       public static function baseUrl($ssl = false)
-       {
-               return self::getClass(BaseURL::class)->get($ssl);
-       }
-
-       /**
-        * @brief Removes the baseurl from an url. This avoids some mixed content problems.
-        *
-        * @param string $orig_url The url to be cleaned
-        *
-        * @return string The cleaned url
-        * @throws \Exception
-        */
-       public static function removedBaseUrl(string $orig_url)
-       {
-               return self::getApp()->removeBaseURL($orig_url);
-       }
-
-       /**
-        * @brief Returns a string with a callstack. Can be used for logging.
-        * @param integer $depth optional, default 4
+        * @param integer $depth  How many calls to include in the stacks after filtering
+        * @param int     $offset How many calls to shave off the top of the stack, for example if
+        *                        this is called from a centralized method that isn't relevant to the callstack
         * @return string
         */
-       public static function callstack($depth = 4)
+       public static function callstack(int $depth = 4, int $offset = 0)
        {
                $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
 
-               // We remove the first two items from the list since they contain data that we don't need.
-               array_shift($trace);
-               array_shift($trace);
+               // We remove at least the first two items from the list since they contain data that we don't need.
+               $trace = array_slice($trace, 2 + $offset);
 
                $callstack = [];
-               $previous = ['class' => '', 'function' => ''];
+               $previous = ['class' => '', 'function' => '', 'database' => false];
 
                // The ignore list contains all functions that are only wrapper functions
-               $ignore = ['fetchUrl', 'call_user_func_array'];
+               $ignore = ['call_user_func_array'];
 
                while ($func = array_pop($trace)) {
                        if (!empty($func['class'])) {
-                               // Don't show multiple calls from the "dba" class to show the essential parts of the callstack
-                               if ((($previous['class'] != $func['class']) || ($func['class'] != 'Friendica\Database\DBA')) && ($previous['function'] != 'q')) {
+                               // Don't show multiple calls from the Database classes to show the essential parts of the callstack
+                               $func['database'] = in_array($func['class'], ['Friendica\Database\DBA', 'Friendica\Database\Database']);
+                               if (!$previous['database'] || !$func['database']) {     
                                        $classparts = explode("\\", $func['class']);
                                        $callstack[] = array_pop($classparts).'::'.$func['function'];
                                        $previous = $func;
                                }
                        } elseif (!in_array($func['function'], $ignore)) {
+                               $func['database'] = ($func['function'] == 'q');
                                $callstack[] = $func['function'];
                                $func['class'] = '';
                                $previous = $func;
@@ -119,7 +107,7 @@ class System extends BaseObject
        }
 
        /**
-        * @brief Send HTTP status header and exit.
+        * Send HTTP status header and exit.
         *
         * @param integer $val     HTTP status result value
         * @param string  $message Error message. Optional.
@@ -143,18 +131,19 @@ class System extends BaseObject
        }
 
        /**
-        * @brief Encodes content to json.
+        * Encodes content to json.
         *
         * This function encodes an array to json format
         * and adds an application/json HTTP header to the output.
         * After finishing the process is getting killed.
         *
-        * @param mixed  $x The input content.
-        * @param string $content_type Type of the input (Default: 'application/json').
+        * @param mixed   $x The input content.
+        * @param string  $content_type Type of the input (Default: 'application/json').
+        * @param integer $options JSON options
         */
-       public static function jsonExit($x, $content_type = 'application/json') {
+       public static function jsonExit($x, $content_type = 'application/json', int $options = 0) {
                header("Content-type: $content_type");
-               echo json_encode($x);
+               echo json_encode($x, $options);
                exit();
        }
 
@@ -184,7 +173,7 @@ class System extends BaseObject
                if (is_bool($prefix) && !$prefix) {
                        $prefix = '';
                } elseif (empty($prefix)) {
-                       $prefix = hash('crc32', self::getApp()->getHostName());
+                       $prefix = hash('crc32', DI::baseUrl()->getHostname());
                }
 
                while (strlen($prefix) < ($size - 13)) {
@@ -253,7 +242,7 @@ class System extends BaseObject
        }
 
        /**
-        * @brief Returns the system user that is executing the script
+        * Returns the system user that is executing the script
         *
         * This mostly returns something like "www-data".
         *
@@ -270,7 +259,7 @@ class System extends BaseObject
        }
 
        /**
-        * @brief Checks if a given directory is usable for the system
+        * Checks if a given directory is usable for the system
         *
         * @param      $directory
         * @param bool $check_writable
@@ -307,16 +296,32 @@ class System extends BaseObject
                return true;
        }
 
+       /**
+        * Exit method used by asynchronous update modules
+        *
+        * @param string $o
+        */
+       public static function htmlUpdateExit($o)
+       {
+               header("Content-type: text/html");
+               echo "<!DOCTYPE html><html><body>\r\n";
+               // We can remove this hack once Internet Explorer recognises HTML5 natively
+               echo "<section>";
+               // reportedly some versions of MSIE don't handle tabs in XMLHttpRequest documents very well
+               echo str_replace("\t", "       ", $o);
+               echo "</section>";
+               echo "</body></html>\r\n";
+               exit();
+       }
+
        /// @todo Move the following functions from boot.php
        /*
-       function killme()
        function local_user()
        function public_contact()
        function remote_user()
        function notice($s)
        function info($s)
        function is_site_admin()
-       function get_server()
        function get_temppath()
        function get_cachefile($file, $writemode = true)
        function get_itemcachepath()