dbxWebApp.class.php

Go to the documentation of this file.

<?php

class dbxWebApp {
 

    function get_base_url(string $uri): string {
        $base_url = dbx()->get_remember_var('base_url', 0, 'dbx');
 
        $protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off')
            ? 'https://' : 'http://';
        $host = $_SERVER['HTTP_HOST'] ?? ($_SERVER['SERVER_ADDR'] ?? 'localhost');
        $host = preg_replace('/:\d+$/', '', (string) $host);
 
        if ($host === 'heserver') {
            $host = 'heserver';
        } elseif ($host === 'localhost' || $host === '127.0.0.1') {
            $host = 'localhost';
        }
 
        $port = (int) ($_SERVER['SERVER_PORT'] ?? 0);
        $xport = ($port && $port != 80 && $port != 443) ? ":$port" : '';
        $request_origin = $protocol . $host . $xport;
 
        if ($base_url && $port != 4221) {
            $cached = parse_url((string) $base_url);
            $cached_scheme = strtolower((string) ($cached['scheme'] ?? ''));
            $cached_host = strtolower((string) ($cached['host'] ?? ''));
            $cached_port = (int) ($cached['port'] ?? ($cached_scheme === 'https' ? 443 : 80));
            $request_port = $port ?: ($protocol === 'https://' ? 443 : 80);
 
            if (
                $cached_scheme !== rtrim($protocol, ':/') ||
                $cached_host !== strtolower($host) ||
                $cached_port !== $request_port
            ) {
                $base_url = 0;
            }
        }
        
        if (!$base_url) {
            // Erstellt die Basis-URL
            $base_url = $request_origin . rtrim($uri, '/');
 
            // Falls der Port 4221 ist, wird die URL aus einer Datei gelesen
            if ($port == 4221) {
                $base_href_file = dbx_os_path_file(dbx_get_file_dir() . 'base_href.cfg');
                
                if (file_exists($base_href_file)) {
                    $base_url = trim(preg_replace('/[\x00-\x1F\x7F]/', '', file_get_contents($base_href_file)));
                }
            }
 
            // Ersetzt Backslashes durch Slashes und sorgt für einen abschließenden Slash
            $base_url = str_replace('\\', '/', rtrim($base_url, '\\'));
            if (!in_array(substr($base_url, -1), ['/', '?'])) {
                $base_url .= '/';
            }
 
            dbx()->set_remember_var('base_url', $base_url, 'dbx');
        }
 
        return $base_url;
    }
 
 
 

  function create_new_cfg($modul='dbx') {
     if ($modul == 'dbx') {
      $config['host']='localhost';
      $config['name']='';
      $config['user']='root';
      $config['password']='';
      $config['port']='';
      $config['default_lng']          ='de';
      $config['accessible_lng']       ='de,en,es';
      $config['default_color']        ='blau';
      $config['default_design_user']  ='lda';
      $config['default_design_admin'] ='_admin';
      $config['cache']=0;
      $config['intro']=0;
      $config['trace']=0;
      $config['construct']=0;
      $config['secure']='secure-key';
      $config['ok']=0;
      
     } else {
       // create Modul cfg; 
     }
     dbx()->set_config($modul,$config);
     return $config;
  }

  function check_uri() {
    $uri='';
    $request = $_SERVER['REQUEST_URI'];
 
    // Zerlege die URL in ihre Komponenten
    $url_components = parse_url($request);
 
    // Speichere den Pfad in $_GET mit dem Schlüssel 'dbx_request_path'
    if (isset($url_components['path'])) {
        $uri = $url_components['path'];
    }
 
    // Zerlege die Query-Parameter und speichere sie in $_GET
    if (isset($url_components['query'])) {
        parse_str($url_components['query'], $query_params);
        foreach ($query_params as $key => $value) {
            $_GET[$key] = $value;
        }
    }
    return $uri; 
}
 

function parse_route_url($url) {
  $url = trim(str_replace('&amp;', '&', (string) $url));
 
  $fragment = '';
  $hashPos = strpos($url, '#');
  if ($hashPos !== false) {
     $fragment = substr($url, $hashPos);
     $url = substr($url, 0, $hashPos);
  }
 
  $path = $url;
  $params = array();
 
  if (substr($url, 0, 1) === '?') {
     $query = substr($url, 1);
     if ($query !== '') {
        parse_str($query, $params);
     }
     return array(
        'permalink' => '',
        'params' => $this->normalize_route_params($params),
        'fragment' => $fragment,
     );
  }
 
  $delimPos = false;
  foreach (array('?', '&') as $delimiter) {
     $pos = strpos($url, $delimiter);
     if ($pos !== false && ($delimPos === false || $pos < $delimPos)) {
        $delimPos = $pos;
     }
  }
 
  if ($delimPos !== false) {
     $path = substr($url, 0, $delimPos);
     $query = substr($url, $delimPos + 1);
     if ($query !== '') {
        parse_str($query, $params);
     }
  }
 
  $path = $this->peel_glued_params_from_path($path, $params);
 
  return array(
     'permalink' => str_replace('\\', '/', $path),
     'params' => $this->normalize_route_params($params),
     'fragment' => $fragment,
  );
}

  function build_route_url($permalink, $params = array(), $fragment = '') {
     $permalink = str_replace('\\', '/', trim((string) $permalink));
     $permalink = trim($permalink, '/');
     $params = $this->normalize_route_params($params);
 
     if ($permalink === '') {
        if (empty($params)) {
           return '?' . $fragment;
        }
        return '?' . http_build_query($params, '', '&', PHP_QUERY_RFC3986) . $fragment;
     }
 
     if (empty($params)) {
        return $permalink . $fragment;
     }
 
     return $permalink . '?' . http_build_query($params, '', '&', PHP_QUERY_RFC3986) . $fragment;
  }

  function append_route_params($url, $params = array()) {
     $route = $this->parse_route_url($url);
     foreach ($params as $key => $value) {
        $route['params'][(string) $key] = (string) $value;
     }
     return $this->build_route_url($route['permalink'], $route['params'], $route['fragment']);
  }

  function route_param_prefix($url) {
     $route = $this->parse_route_url($url);
     if ($route['permalink'] === '') {
        return empty($route['params'])
           ? '?'
           : $this->build_route_url('', $route['params']) . '&';
     }
 
     if (empty($route['params'])) {
        return $route['permalink'] . '?';
     }
 
     return $this->build_route_url($route['permalink'], $route['params']) . '&';
  }

  function get_request_route_string($baseUri = '') {
     $requestUri = $_SERVER['REQUEST_URI'] ?? '';
     if ($requestUri === '') {
        return '';
     }
 
     if ($baseUri === '') {
        $baseUri = $this->get_base_uri();
     }
 
     $path = parse_url($requestUri, PHP_URL_PATH) ?? '';
     $path = str_replace('\\', '/', $path);
     $baseUri = str_replace('\\', '/', $baseUri);
 
     if ($baseUri !== '/' && $baseUri !== '' && strpos($path, $baseUri) === 0) {
        $path = substr($path, strlen($baseUri));
     }
 
     $route = ltrim($path, '/');
     $query = parse_url($requestUri, PHP_URL_QUERY);
 
     if ($query !== null && $query !== '') {
        if ($route === '') {
           return '?' . $query;
        }
        if (strpos($route, '?') === false && strpos($route, '&') === false) {
           return $route . '?' . $query;
        }
        return $route . '&' . $query;
     }
 
     return $route;
  }

  function strip_unwanted_route_params($params, $unwanted = '') {
     $remove = array_merge(
        explode(',', (string) $unwanted),
        $this->memory_switch_params()
     );
 
     foreach ($remove as $key) {
        $key = trim($key);
        if ($key === '') {
           continue;
        }
        unset($params[$key]);
     }
 
     return $params;
  }

function get_self_url($permalink,$unwanted) {
  $route = $this->parse_route_url($this->get_request_route_string($this->get_base_uri()));
  $params = $this->strip_unwanted_route_params($route['params'], $unwanted);
 
  if ($permalink !== '') {
     $route['permalink'] = str_replace('\\', '/', trim((string) $permalink, '/'));
  }
 
  return $this->build_route_url($route['permalink'], $params, $route['fragment']);
}

  function memory_switch_params() {
     return array('dbx_edit', 'dbx_design', 'dbx_color', 'dbx_lng');
  }

  function normalize_self_url($url) {
     $route = $this->parse_route_url($url);
     $route['params'] = $this->strip_unwanted_route_params($route['params']);
     return $this->build_route_url($route['permalink'], $route['params'], $route['fragment']);
  }

  function peel_glued_params_from_path($path, &$params = array()) {
     $path = str_replace('\\', '/', (string) $path);
     $changed = true;
 
     while ($changed) {
        $changed = false;
 
        if (preg_match('/^(.*)[?&]([a-zA-Z_][a-zA-Z0-9_]*)=([^\/&?#]+)$/', $path, $match)) {
           $path = $match[1];
           $params[$match[2]] = rawurldecode($match[3]);
           $changed = true;
           continue;
        }
 
        if (preg_match('/^(.*?)([a-zA-Z_][a-zA-Z0-9_]*)=([^\/&?#]+)$/', $path, $match)) {
           if (preg_match('/^dbx_/', $match[2]) || strpos($match[2], '_') !== false) {
              $path = $match[1];
              $params[$match[2]] = rawurldecode($match[3]);
              $changed = true;
           }
        }
     }
 
     return rtrim($path, '-&?/');
  }

  function normalize_route_params($params) {
     $normalized = array();
 
     if (!is_array($params)) {
        return $normalized;
     }
 
     foreach ($params as $key => $value) {
        if ($key === '' || $value === null) {
           continue;
        }
        if (is_array($value)) {
           $normalized[(string) $key] = implode(',', $value);
        } else {
           $normalized[(string) $key] = (string) $value;
        }
     }
 
     return $normalized;
  }
 

  function get_base_uri() {
    // Versuche zuerst, den URI aus $_SERVER['SCRIPT_NAME'] zu holen
    if (!empty($_SERVER['SCRIPT_NAME'])) {
        $uri = $_SERVER['SCRIPT_NAME'];
    } 
    // Fallback auf $_SERVER['PHP_SELF'], falls $_SERVER['SCRIPT_NAME'] nicht verfügbar ist
    elseif (!empty($_SERVER['PHP_SELF'])) {
        $uri = $_SERVER['PHP_SELF'];
    } 
    // Als letzte Option, versuche den URI aus $_SERVER['REQUEST_URI'] ohne Query-Parameter
    elseif (!empty($_SERVER['REQUEST_URI'])) {
        $uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
    } 
    // Falls keine der Optionen verfügbar ist, gib einen leeren String zurück oder eine Fehlermeldung
    else {
        $uri = ''; // Oder ein bestimmter Wert, z.B. "/unknown" oder ein Fehlerwert
    }
    
    // Entferne den Dateinamen, um nur das Verzeichnis zurückzugeben
    $uri=dirname($uri);
    if ($uri=='\\') $uri='/';
    $uri = str_replace('\\', '/', $uri);
    return $uri;
  }
 
 

  function get_permalink($uri) {
    $route = $this->parse_route_url($this->get_request_route_string($uri));
    return $route['permalink'];
  }
 

  function setRequestUriToGet() {
    $route = $this->parse_route_url($this->get_request_route_string($this->get_base_uri()));
    if (!empty($route['params'])) {
       $_GET = array_merge($_GET, $route['params']);
    }
  }
 

  function check_request()  {
    //dbx_debug("dbxApp check request");
    //dbx_debug('#INCOME-POST',$_POST);
    //dbx_debug('#INCOME-GET' ,$_GET);
    //dbx_debug("SERVER"      ,$_SERVER);
 
    // JSON-Body einlesen (z. B. von fetch)
    $raw = file_get_contents('php://input');
    $data = json_decode($raw, true);
 
    // Falls gültiges JSON → $_POST damit befüllen
    if (is_array($data)) {
        $_POST = array_merge($_POST, $data);
    }
 
 
    
    $pvx=array();   $gvx=array();
 
 
 
    if (isset($_POST['dbx_get'])) { // Ajax Formular
      $get = $_POST['dbx_get'];
      $get = ltrim($get, '?');
      parse_str($get, $gvx);
      $_GET=array_merge($_GET, $gvx);
      unset($_POST['dbx_get']);
    }
 
    if (isset($_POST['dbx_post'])) { // Ajax Formular
      $post= $_POST['dbx_post'];
      $post= ltrim($post, '?');
      parse_str($post, $pvx);
      $_POST=array_merge($_POST, $pvx);
      unset($_POST['dbx_post']);
    }
 
    /*
    if (!empty($_GET)) {
      // Hol den ersten Schlüssel und den ersten Wert
      $firstKey = array_key_first($_GET);
      $firstValue = $_GET[$firstKey];
  
      // Prüfen, ob das erste Zeichen des Schlüssels ein '?' ist
      if (strpos($firstKey, '?') === 0) {
          // Entferne den Eintrag mit dem alten Schlüssel
          dbx()->debug("FIX-GET Key ($firstKey)");
          unset($_GET[$firstKey]);
          // Entferne das '?' am Anfang des Schlüssels
          $newKey = ltrim($firstKey, '?');
          // Füge den Wert mit dem neuen Schlüssel hinzu
          $_GET[$newKey] = $firstValue;
      }
    }
    */
    
    
 
 
    $base_uri =$this->get_base_uri();
    $route = $this->parse_route_url($this->get_request_route_string($base_uri));
    if (!empty($route['params'])) {
       $_GET = array_merge($route['params'], $_GET);
    }
 
    //dbx_debug('#OUT-GET POST' ,$_GET,$_POST);
    
    $base_url =$this->get_base_url($base_uri);
    $permalink=$this->get_permalink($base_uri);
    $self_url =$this->get_self_url($permalink,'dbx_ajax,dbx_window,dbx_target,dbx_go');
    $go       = dbx()->get_request_var('dbx_go'    ,0,'parameter');
    $ajax     = dbx()->get_request_var('dbx_ajax'  ,0,'int');
    $window   = dbx()->get_request_var('dbx_window',0,'int'); 
    
 
    dbx()->debug("#SYS Self-url=($self_url) base-Url=($base_url) base_uri=($base_uri) Perma=($permalink)");
 
    //dbx_debug('#-POST',$_POST);
    //dbx_debug('#-GET' ,$_GET);
 
   
    
    dbx()->set_system_var('dbx_permalink',$permalink);
    dbx()->set_system_var('dbx_self_url' ,$self_url);
    dbx()->set_system_var('dbx_base_url' ,$base_url);  
    dbx()->set_system_var('dbx_base_uri' ,$base_uri);  
    dbx()->set_system_var('dbx_window'   ,$window);
    dbx()->set_system_var('dbx_ajax'     ,$ajax);
    dbx()->set_system_var('dbx_go'       ,$go);
 
 
  }
 

  function get_is_resorce($ext) {
     $ext=strtolower($ext);
     $extensions = ['gif', 'jpg', 'png', 'jpeg', 'pdf', 'css', 'js', 'exe'];
     // Überprüfen, ob die Erweiterung im Array vorhanden ist
     return in_array($ext, $extensions) ? 1 : 0;    
  }

  private function get_resource_file($permalink) {
    $path = str_replace('\\', '/', rawurldecode((string) $permalink));
    $path = ltrim($path, '/');
 
    if ($path === '' || strpos($path, "\0") !== false) {
      return '';
    }
 
    $parts = explode('/', $path);
    foreach ($parts as $part) {
      if ($part === '..') {
        return '';
      }
    }
 
    $base = realpath(dbx_get_base_dir());
    if (!$base) {
      return '';
    }
 
    $file = realpath($base . DIRECTORY_SEPARATOR . implode(DIRECTORY_SEPARATOR, $parts));
    if (!$file || !is_file($file)) {
      return '';
    }
 
    $baseCheck = rtrim(str_replace('\\', '/', strtolower($base)), '/') . '/';
    $fileCheck = str_replace('\\', '/', strtolower($file));
 
    if (strpos($fileCheck, $baseCheck) !== 0) {
      return '';
    }
 
    return $file;
  }

  private function get_resource_mime($ext) {
    $ext = strtolower((string) $ext);
 
    $types = array(
      'css'  => 'text/css; charset=UTF-8',
      'js'   => 'application/javascript; charset=UTF-8',
      'gif'  => 'image/gif',
      'jpg'  => 'image/jpeg',
      'jpeg' => 'image/jpeg',
      'png'  => 'image/png',
      'pdf'  => 'application/pdf',
      'exe'  => 'application/octet-stream',
    );
 
    return isset($types[$ext]) ? $types[$ext] : 'application/octet-stream';
  }

  private function send_resource_file($file, $ext) {
    if (headers_sent()) {
      return;
    }
 
    header('Content-Type: ' . $this->get_resource_mime($ext));
    header('X-Content-Type-Options: nosniff');
    header('Cache-Control: public, max-age=3600');
 
    readfile($file);
    exit;
  }
 
 

  function check_config() {
    $config=dbx()->get_config('dbx');
    if (!is_array($config)) { 
      $config=$this->create_new_cfg('dbx');
    } else {
      if (!isset($config['ok'])) $config=$this->create_new_cfg('dbx');
    }  
    dbx()->set_system_var('dbx_install'  ,$config['install']);
    dbx()->set_system_var('dbx_construct',$config['construct']);
    If (!$config['ok']) dbx()->set_system_var('dbx_install',1);
  }
 
 

  function check_missing() {
    $ext='dbx';
    $permalink=dbx()->get_system_var('dbx_permalink','','parameter+/');
 
    if ($permalink > ' ') {
      $info = pathinfo($permalink);
      if (isset($info['extension'])) $ext=$info['extension'];
      $ext=strtolower($ext);
 
      if ($this->get_is_resorce($ext)) { // request missing ressorce
        $resourceFile = $this->get_resource_file($permalink);
        if ($resourceFile) {
          dbx()->debug("## resource exists, not missing ($permalink) file=($resourceFile)");
          $this->send_resource_file($resourceFile, $ext);
          return;
        }
 
        dbx()->debug("## check missing ($permalink)");
 
        $ok = dbx()->log_missing($permalink);
        dbx()->debug("#MISSING# ($permalink) Ext=($ext) ok=($ok)");
        // maybe return default resource.$ext
        dbx()->debug('###EXIT###');
        exit; // !
      }
    }
  }

  public function check_remember() {
    // #Session switch values 
    //$page  =dbx()->get_remember_var('dbx_page'  ,'default','dbx');
    $design=dbx()->get_remember_var('dbx_design','user'   ,'dbx');
    $edit  =dbx()->get_remember_var('dbx_edit'  ,0        ,'dbx');
    $lng   =dbx()->get_remember_var('dbx_lng'   ,'de'     ,'dbx');
    $defaultColor = dbx()->normalize_skin((string) dbx()->get_config('dbx', 'default_color', 'blau'));
    $color = dbx()->get_remember_var('dbx_color', $defaultColor, 'dbx');
 
    //$page  =dbx()->get_request_var('dbx_page'  ,$page);
    $design=dbx()->get_request_var('dbx_design',$design);
    $edit  =dbx()->get_request_var('dbx_edit'  ,$edit);
    $lng   =dbx()->get_request_var('dbx_lng'   ,$lng);
    $color = dbx()->normalize_skin((string) dbx()->get_request_var('dbx_color', $color));
   
    //dbx()->set_remember_var('dbx_page'  ,$page  ,'dbx');
    dbx()->set_remember_var('dbx_design',$design,'dbx');
    dbx()->set_remember_var('dbx_edit'  ,$edit  ,'dbx');  
    dbx()->set_remember_var('dbx_lng'   ,$lng   ,'dbx');  
    dbx()->set_remember_var('dbx_color' ,$color ,'dbx');  
 
    dbx()->set_system_var('dbx_design', $design);
    dbx()->set_system_var('dbx_edit'  , $edit);
    dbx()->set_system_var('dbx_lng'   , $lng);
    dbx()->set_system_var('dbx_color' , $color);
    dbx()->set_system_var('dbx_last_editor_tpl_paths', array());
 
  }

  private function get_content_permalink_mode(): string {
     return dbx()->get_content_permalink_mode();
  }

  private function get_content_root(): int {
     $requestRoot = dbx()->get_request_var('root', '', 'int');
 
     if ($requestRoot !== '') {
        return (int) $requestRoot;
     }
 
     $configRoot = dbx()->get_config('dbxContent', 'root');
     if ($configRoot === 'undef' || $configRoot === '') {
        return 0;
     }
 
     return (int) $configRoot;
  }

  private function set_content_route(int $cid, string $source = ''): void {
     if ($cid <= 0) {
        return;
     }
 
     $mode = $this->get_content_permalink_mode();
     $root = $this->get_content_root();
 
     dbx()->set_system_var('dbx_modul', 'dbxContent');
     dbx()->set_system_var('dbx_cid', $cid);
     dbx()->set_system_var('cid', $cid);
     dbx()->set_system_var('dbx_content_route_cid', $cid);
     $source = (string) $source;
     $cacheableContentRoute = str_starts_with($source, 'permalink-');
     dbx()->set_system_var('dbx_content_permalink_request', $cacheableContentRoute ? 1 : 0);
 
     if ($mode === 'cms') {
        dbx()->set_system_var('dbx_run1', 'cms');
        dbx()->set_system_var('dbx_run2', 'show');
        dbx()->set_system_var('root', $root);
     } else {
        dbx()->set_system_var('dbx_run1', 'show');
     }
 
     dbx()->debug("#PERMALINK set dbxContent mode=($mode) root=($root) cid=($cid) source=($source)");
  }

  private function get_home_content_cid(): int {
     $this->load_content_cache_classes();
 
     return \dbx\dbxContent\dbxContentHome::resolveCid();
  }

  private function load_content_cache_classes(): void {
     dbx()->load_content_cache_classes();
  }

  public function check_perma() {
     $cid=0; $home=0;
     $permalink= dbx()->get_system_var('dbx_permalink');
     dbx()->set_system_var('dbx_content_permalink_request', 0);
     dbx()->set_system_var('dbx_content_route_cid', 0);
     dbx()->debug("check perma ($permalink)");
 
     if ($permalink =='undef') $permalink='';
     if ($permalink =='/')     $permalink='';
  
 
     $lng=dbx()->get_system_var('dbx_lng','de');
  
     $modul      = dbx()->get_request_var('dbx_modul');
     $action     = dbx()->get_request_var('dbx_run1');
     $hasExplicitRoute = ($modul !== '' && $action !== '');
 
      if ($hasExplicitRoute) {
        dbx()->set_system_var('dbx_modul', $modul);
        dbx()->set_system_var('dbx_run1', $action);
        dbx()->set_system_var('dbx_run2', dbx()->get_request_var('dbx_run2', '', 'parameter'));
        dbx()->set_system_var('root', dbx()->get_request_var('root', '', 'int'));
      }
 
      $requestCid = (int) dbx()->get_request_var('cid', 0, 'int');
      if (!$requestCid) $requestCid = (int) dbx()->get_request_var('dbx_cid', 0, 'int');
 
      if ($hasExplicitRoute) {
        dbx()->set_system_var('dbx_cid', $requestCid);
        dbx()->set_system_var('cid', $requestCid);
        return;
      }
 
      if ($requestCid > 0 && (!$modul || !$action || $modul === 'dbxHome')) {
        $this->set_content_route($requestCid, 'request-cid');
        return;
      }
 
      if (!$permalink  && !$modul) $home=1;
      if ( $modul=='dbxHome')      $home=1;
      if ($permalink === 'home' && !$modul) $home=1;
 
 
     if ($home) {
      $homeCid = $this->get_home_content_cid();
      if ($homeCid > 0) {
        $this->set_content_route($homeCid, ($permalink === 'home') ? 'permalink-home' : 'dbxHome-config');
        return;
      }
      dbx()->set_system_var('dbx_modul' ,'dbxHome');
      dbx()->set_system_var('dbx_run1','run');
      dbx()->set_system_var('dbx_design','user');
      return;
     }
 
     if ($permalink =='admin') {
      dbx()->set_system_var('dbx_modul','dbxAdmin');
      dbx()->set_system_var('dbx_run1','run');
      dbx()->set_system_var('dbx_design','admin');
      return;
    }
 
     if ($permalink === 'sitemap.xml' || $permalink === 'sitemap') {
      dbx()->set_system_var('dbx_modul', 'dbxContent');
      dbx()->set_system_var('dbx_run1', 'sitemap');
      return;
     }
 
     if ($permalink === 'robots.txt') {
      dbx()->set_system_var('dbx_modul', 'dbxContent');
      dbx()->set_system_var('dbx_run1', 'robots');
      return;
     } 
 
 
 
 
     $check_perma=dbx()->get_config('dbx','permalink');
     if ($permalink > ' ' && $check_perma) {
       //$permalink=strtolower($permalink);
       dbx()->debug("##Permalink## ($permalink) Lng=($lng) check content#");
       $permalink=trim((string)$permalink, '/');
 
       $this->load_content_cache_classes();
       $resolved = \dbx\dbxContent\dbxContentPermalinkIndex::resolve($permalink, $lng);
       if (is_array($resolved) && (int)($resolved['activ'] ?? 0) === 1) {
          $cid = (int)($resolved['cid'] ?? 0);
          if ($cid > 0) {
             $this->set_content_route($cid, 'permalink-content');
             return;
          }
       }
 
       dbx()->set_system_var('dbx_modul', 'dbxHome');
       dbx()->set_system_var('dbx_run1', 'run');
       dbx()->set_system_var('dbx_run2', '');
       dbx()->set_system_var('dbx_design', 'user');
       dbx()->set_system_var('dbx_cid', 0);
       dbx()->set_system_var('cid', 0);
       dbx()->debug("#PERMALINK not found -> dbxHome permalink=($permalink)");
       return;
     }
  }
  
  public function check_modul() {
      $modul=dbx()->get_system_var('dbx_modul');
      if (!dbx()->is_modul($modul)) $modul='dbxHome';
      dbx()->set_system_var('dbx_modul',$modul);
  }
 

  public function check_design() {
    $admin =dbx()->can('admin');
    $config=dbx()->get_config('dbx');
    $user_default = $config['default_design_user'];  
    $admin_default= $config['default_design_admin'];
    $construct    = $config['construct'];
    $intro        = (int) ($config['intro'] ?? 0);
    $ok           = (int) ($config['ok'] ?? 0);
 
    $design        = dbx()->get_remember_var('dbx_design',$user_default,'dbx');      
    //$page          = dbx()->get_remember_var('dbx_page' , 'default'    ,'dbx');
    $page          = dbx()->get_system_var('dbx_page' , 'default');
    $modul         = dbx()->get_system_var('dbx_modul'); 
    $admin_modul   = dbx()->has_text($modul,'_admin');
    
    
    if (!dbx()->is_design($design)) {
       $design='user';
    } else {
      if (!$admin && $design=='admin') $design='user';
      if ( $admin && $admin_modul)     $design='admin';
    }
 
 
    $ajax = (int) dbx()->get_system_var('dbx_ajax', 0, 'int');
    if ($intro && $ok && !$ajax) {
        $introShown = (int) dbx()->get_session_var('intro_shown', 0, 'ui', 'dbx');
        $requestModul = trim((string) dbx()->get_request_var('dbx_modul', '', 'parameter'));
        if (!$introShown && $requestModul === '') {
          $design = $user_default;
          $modul  = 'dbxHome';
          $page   = 'intro';
          dbx()->set_session_var('intro_shown', 1, 'ui', 'dbx');
        }
    }
 
    if (!$modul) {
        $design=$user_default;
        $modul='dbxHome';
        $page='home';
        $action='run';
    }
 
    if (!$ok) {
      dbx()->set_system_var('dbx_install', 1);
      $modul = 'dbxSetup';
      $design = '_install';
      $page   = 'install';
      dbx()->set_system_var('dbx_run1', 'install');
    }
 
    if ($design=='admin') $design=$admin_default;
    if ($design=='user')  $design=$user_default;
 
    dbx()->set_system_var('dbx_modul'  ,$modul);
    dbx()->set_system_var('dbx_design' ,$design);
    dbx()->set_system_var('dbx_page'   ,$page);
    $ajax=dbx()->get_system_var('dbx_ajax',0);
        
    //dbx_debug("##->check-design##=($design) Modul=($modul)Page=($page) Intro($intro) Ajax=($ajax)");                           
}
 

  public function check_lng() {
    $config=dbx()->get_config('dbx');
    $lng_default   =$config['default_lng'];
    $lng_accessible=$config['accessible_lng'];
    $lng=dbx()->get_system_var('dbx_lng',dbx()->get_remember_var('dbx_lng',$lng_default,'dbx'));
    if ($lng != $lng_default) {
      $ok=0;
      if (!is_array($lng_accessible)) $lng_accessible = explode(",", $lng_accessible);
      foreach ($lng_accessible as $no => $val) {
        if ($lng == $val) $ok=1;               
      }
      if (!$ok) $lng=$lng_default;
    }
    dbx()->set_remember_var('dbx_lng',$lng,'dbx');
    dbx()->set_system_var('dbx_lng', $lng);
  }

  public function translate($content,$lng=''){
    if (!$lng) $lng=dbx()->get_system_var('dbx_lng','de');
    $dir_file=dbx_get_base_dir().'dbx/translate.php';
    if (file_exists($dir_file)) {
        include $dir_file;
    }
    return $content;
  }
 
 
 

  public function del_add_css($content) {
    $css_content='';
    if (isset($_SESSION['dbx']['add_css'])) {
      $xcss=$_SESSION['dbx']['add_css'];
      if (is_array($xcss)) {
        foreach ($xcss as $no => $css) {  $css_content.=$css."\n"; }
      }
    }
    $content = (str_replace('[dbx:add_css]',$css_content,$content));
    return $content;
  }

   public function del_add_js($content) {
      $js_content='';
      if (isset($_SESSION['dbx']['add_js'])) {
        $xjs=$_SESSION['dbx']['add_js'];
        if (is_array($xjs)) {
          foreach ($xjs as $no => $js) {  $js_content.=$js."\n";         }
        }
      }
      $content = (str_replace('[dbx:add_js]',$js_content,$content));
      return $content;
   }
 
 

   public function out_filter($content) {
       include dbx_get_base_dir().'dbx/out_filter.php';
       return $content;
    }
 

   public function add_norep($content) {
      $oTPL = dbx()->get_system_obj('dbxTPL');
      if (is_object($oTPL) && method_exists($oTPL, 'cleanup_optional_placeholders')) {
        $content = $oTPL->cleanup_optional_placeholders((string)$content);
      }
 
      if (isset($_SESSION['dbx']['norep'])) {
        $xnorep=$_SESSION['dbx']['norep'];
        if (is_array($xnorep)) {
          for($i=0; $i < 2; $i++) { // noreps can include noraps
            foreach ($xnorep as $id => $norep) {
              $xid= '['.$id.']';
              $content = str_replace($xid,$norep,$content);
            }
          }
        }
      }
      return $content;
   }
 
 
   function get_session_rec($fld,$default='') {
      $value=$default;
      if ($fld != '*') {
        if (isset($_SESSION['dbx']['record'][$fld])) {
           $value=$_SESSION['dbx']['record'][$fld];
        }
      } else {
        $value=$_SESSION['dbx']['record'];
      }
      return $value;
   }
 
  function design_load($modul_content) {
    $ajax  =dbx()->get_system_var('dbx_ajax');
    $window=dbx()->get_system_var('dbx_window');
    
    $design=dbx()->get_system_var('dbx_activ_design',dbx()->get_system_var('dbx_design'));
    $page  =dbx()->get_system_var('dbx_activ_page'  ,dbx()->get_system_var('dbx_page'));
    $lng   =dbx()->get_system_var('dbx_activ_lng'   ,dbx()->get_system_var('dbx_lng'));
 
    //dbx_debug ("##DBX-CAll AJAX=($ajax) Get Ajax=($get_ajax) POST/GET",$_POST,$_GET);
 
    if (!$ajax)  {
        if ($window) $page='_window';
        $oTPL=dbx()->get_system_obj('dbxTPL');
        $content=$oTPL->get_design_tpl($design,$page,$lng,'htm',1);
 
        if (defined('dbxRunAsAdmin') && (int) constant('dbxRunAsAdmin') === 1) {
          $admin_bypass_alert=$oTPL->get_tpl('dbx|alert-warning', array(
            'msg' => 'Admin Bypass ist aktiv'
          ));
          $modul_content=$admin_bypass_alert.'<br>'.$modul_content;
        }
 
        $content = (str_replace("[dbx:content]",$modul_content,$content));
    } else {
        $content=$modul_content;
    }
    return $content;
  }
 
  function add_editor_files_data($content) {
    $edit = (int) dbx()->get_system_var('dbx_edit', 0, 'int');
 
    if (($edit < 4 || $edit > 8) && $edit !== 9) {
      return $content;
    }
 
    $all_files = dbx()->get_editor_files();
    $files = array();
 
    foreach ($all_files as $file) {
      if (!isset($file['kind'], $file['file'])) {
        continue;
      }
 
      if ($edit == 4 && $file['kind'] !== 'fd') {
        continue;
      }
 
      if ($edit == 5 && $file['kind'] !== 'dd') {
        continue;
      }
 
      if ($edit == 6 && $file['kind'] !== 'class') {
        continue;
      }
 
      if ($edit == 7 && $file['kind'] !== 'sysclass') {
        continue;
      }
 
      if ($edit == 8 && $file['kind'] !== 'config') {
        continue;
      }
 
      $key = $file['kind'] . '|' . $file['file'];
      $files[$key] = $file;
    }
 
    $payload = array(
      'mode'  => $edit,
      'files' => array_values($files),
    );
 
    $json = json_encode($payload, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
 
    if (!$json) {
      return $content;
    }
 
    $data = '<script type="application/json" class="dbx-editor-files-data">' .
            htmlspecialchars($json, ENT_NOQUOTES, 'UTF-8') .
            '</script>';
 
    if (strpos($content, '</body>') !== false) {
      return str_replace('</body>', $data . "\n</body>", $content);
    }
 
    return $data . $content;
  }
 
  private function render_editor_files_menu($edit, $files) {
    if (!is_array($files) || !count($files)) {
      return '';
    }
 
    $title = 'Editor Dateien';
    if ($edit == 4) $title = 'FD Dateien';
    if ($edit == 5) $title = 'DD Dateien';
    if ($edit == 6) $title = 'Modul PHP Dateien';
    if ($edit == 7) $title = 'myX SysClass Dateien';
    if ($edit == 8) $title = 'Config Dateien';
    if ($edit == 9) $title = 'Alle Editor Dateien';
 
    $html  = '<div id="dbxEditorFilesMenu" class="dbx-editor-files-menu" ';
    $html .= 'style="display:none;">';
    $html .= '<button type="button" class="dbx-editor-files-count" title="' . htmlspecialchars($title, ENT_QUOTES, 'UTF-8') . '" ';
    $html .= 'onclick="this.parentElement.classList.toggle(\'is-open\')" ';
    $html .= 'style="display:inline-flex;align-items:center;gap:6px;min-height:30px;padding:4px 8px;border:1px solid rgba(0,0,0,.18);border-radius:4px;background:#212529;color:#fff;box-shadow:0 4px 12px rgba(0,0,0,.18);">';
    $html .= '<i class="bi bi-pencil-square"></i><span>' . count($files) . '</span></button>';
    $html .= '<div class="dbx-editor-files-list" style="max-height:min(520px,calc(100vh - 96px));overflow:auto;padding:8px;border:1px solid rgba(0,0,0,.16);border-radius:4px;background:#fff;color:#212529;box-shadow:0 10px 28px rgba(0,0,0,.2);">';
    $html .= '<div class="dbx-editor-files-title" style="padding:4px 6px;font-weight:600;color:#495057;">' . htmlspecialchars($title, ENT_QUOTES, 'UTF-8') . '</div>';
 
    foreach ($files as $file) {
      if (!isset($file['file'])) {
        continue;
      }
 
      $path = $file['file'];
      $kind = isset($file['kind']) ? (string)$file['kind'] : '';
      $url  = $this->editor_file_url($kind, $path);
      $label = $this->short_editor_file_label($path);
 
      $html .= '<a href="' . htmlspecialchars($url, ENT_QUOTES, 'UTF-8') . '" ';
      $html .= 'data-url="' . htmlspecialchars($url, ENT_QUOTES, 'UTF-8') . '" data-title="' . htmlspecialchars($title, ENT_QUOTES, 'UTF-8') . '" ';
      $html .= 'style="display:grid;grid-template-columns:22px minmax(0,1fr);align-items:center;gap:6px;padding:5px 6px;border-radius:4px;color:#212529;text-decoration:none;" class="dbx-win">';
      $html .= '<i class="bi bi-filetype-php"></i>';
      $html .= '<span style="overflow:hidden;text-overflow:ellipsis;white-space:nowrap;">' . htmlspecialchars($label, ENT_QUOTES, 'UTF-8') . '</span>';
      $html .= '</a>';
    }
 
    $html .= '</div>';
    $html .= '</div>';
 
    return $html;
  }
 
  private function short_editor_file_label($path) {
    $path = str_replace('\\', '/', $path);
    $prefix = 'dbx/modules/';
 
    if (strpos($path, $prefix) === 0) {
      return substr($path, strlen($prefix));
    }
 
    return $path;
  }
 
  private function editor_file_url($kind, $path) {
    $kind = strtolower(trim((string)$kind));
    $path = str_replace('\\', '/', (string)$path);
 
    if ($kind === 'dd' && preg_match('#^dbx/modules/([^/]+)/dd/([^/]+)\.dd\.php$#', $path, $m)) {
      return '?dbx_modul=dbxAdmin&dbx_run1=edit_dd&modul=' . rawurlencode($m[1]) . '&dd=' . rawurlencode($m[2]);
    }
 
    if ($kind === 'fd' && preg_match('#^dbx/modules/([^/]+)/fd/([^/]+)\.fd\.php$#', $path, $m)) {
      return '?dbx_modul=dbxAdmin&dbx_run1=edit_fd&modul=' . rawurlencode($m[1]) . '&fd=' . rawurlencode($m[2]);
    }
 
    return '?dbx_modul=dbxEditor&dbx_run1=edit&file=' . rawurlencode($path);
  }
 
   // - - - - - - - - - - - - - - - - - - - - -
 
   function run() {
      $content='';
      $uid     =dbx()->user(); 
      $self    =dbx()->get_self_url();
      $design = dbx()->get_system_var('dbx_design');
      $page   = dbx()->get_system_var('dbx_page');
      $lng    = dbx()->get_system_var('dbx_lng');
      $edit   = dbx()->get_system_var('dbx_edit');
      $color  = dbx()->get_system_var('dbx_color');
      $modul  = dbx()->get_system_var('dbx_modul');
      $action = dbx()->get_system_var('dbx_run1');
      $api    = dbx()->get_system_var('dbx_api');
      $cid    = dbx()->get_system_var('dbx_cid',0);
      $run2   = dbx()->get_system_var('dbx_run2','');
      $root   = dbx()->get_system_var('root','');
      $install= dbx()->get_system_var('dbx_install',0);
 
      //$oInterpreter = dbx()->get_system_obj('dbxInterpreter');
 
      if ($api && $uid != 2) dbx()->login(2); // auto login for api access
 
      //dbx_debug("#WebApp run-> Design=($design) Page=($page) Modul=($modul) Action=($action) Api=($api) Install=($install) User=($uid)  Lng=($lng) Self=($self)");
      
 
      if ($modul) {
        $access=dbx()->can_modul($modul);
        if (!$access) {
            $perma=dbx()->get_system_var('dbx_permalink');
            if ( $perma && !$uid) dbx()->set_remember_var('dbx_redir_after_login',$perma,'dbx');
            if (!$perma && !$uid) dbx()->set_remember_var('dbx_redir_after_login',"?dbx_modul=$modul&dbx_run1=$action",'dbx');
 
            $content='[modul=dbxLogin]dbx_run1=login[/modul]';
        }
        if ($access) {
 
          dbx()->set_system_var('dbx_master_modul' , $modul);  // use 4 session
          dbx()->set_system_var('dbx_master_action',$action);  // use 4 session
          dbx()->set_system_var('dbx_activ_modul'  , $modul);  // use 4 session
          dbx()->set_system_var('dbx_activ_action' ,$action);  // use 4 session
 
          $dbxModul=dbx()->get_modul_obj($modul);
          $mid=dbx()->get_system_var('dbx_activ_modul_id',0,'*');
 
          dbx()->set_system_var('dbx_activ_modul_id',$mid);  
          dbx()->set_modul_var('dbx_modul_id',$mid); 
          dbx()->set_modul_var('dbx_modul'   ,$modul);
          dbx()->set_modul_var('dbx_run1'  ,$action);
          if ($run2 !== '') dbx()->set_modul_var('dbx_run2', $run2);
          dbx()->set_modul_var('dbx_cid'     ,$cid);     // come from permalink check()
          if ($cid) dbx()->set_modul_var('cid', $cid);
          if ($root !== '') dbx()->set_modul_var('root', $root);
 
          $content=dbx()->run_owner($dbxModul);
 
 
          if ($api) dbx()->set_system_var('dbx_page','api');
 
        }        
 
      }
      $mid=dbx()->get_system_var('dbx_activ_modul_id');
      $go =dbx()->get_system_var('dbx_go',0,'parameter');
      if ($go) { 
          $js ='$(document).ready(function() { ';
          $js.= "dbxGoTo('$go');";
          $js.=' } );';
          $js.="\n";
          $content.="<br><script>$js</script><div id=dbx_end></div>";
      }  
      //dbx_debug("#WebApp load-> Modul=($modul) Action=($action) Access=($access) Modul-id=($mid) go =($go)");
 
      return $content;
   }
 
 
} // class