%PDF- %PDF-
Direktori : /www/varak.net/mail2.varak.net/program/lib/Roundcube/ |
Current File : /www/varak.net/mail2.varak.net/program/lib/Roundcube/rcube_output.php |
<?php /** +-----------------------------------------------------------------------+ | This file is part of the Roundcube webmail client | | | | Copyright (C) The Roundcube Dev Team | | | | Licensed under the GNU General Public License version 3 or | | any later version with exceptions for skins & plugins. | | See the README file for a full license statement. | | | | CONTENTS: | | Abstract class for output generation | +-----------------------------------------------------------------------+ | Author: Thomas Bruederli <roundcube@gmail.com> | | Author: Aleksander Machniak <alec@alec.pl> | +-----------------------------------------------------------------------+ */ /** * Class for output generation * * @package Framework * @subpackage View */ abstract class rcube_output { public $browser; protected $app; protected $config; protected $charset = RCUBE_CHARSET; protected $env = []; protected $skins = []; /** * Object constructor */ public function __construct() { $this->app = rcube::get_instance(); $this->config = $this->app->config; $this->browser = new rcube_browser(); } /** * Magic getter */ public function __get($var) { // allow read-only access to some members switch ($var) { case 'env': return $this->env; case 'skins': return $this->skins; case 'charset': return $this->charset; } } /** * Setter for output charset. * To be specified in a meta tag and sent as http-header * * @param string $charset Charset name */ public function set_charset($charset) { $this->charset = $charset; } /** * Getter for output charset * * @return string Output charset name */ public function get_charset() { return $this->charset; } /** * Set environment variable * * @param string $name Property name * @param mixed $value Property value */ public function set_env($name, $value) { $this->env[$name] = $value; } /** * Environment variable getter. * * @param string $name Property name * * @return mixed Property value */ public function get_env($name) { return $this->env[$name] ?? null; } /** * Delete all stored env variables and commands */ public function reset() { $this->env = []; } /** * Invoke display_message command * * @param string $message Message to display * @param string $type Message type [notice|confirm|error] * @param array $vars Key-value pairs to be replaced in localized text * @param bool $override Override last set message * @param int $timeout Message displaying time in seconds */ abstract function show_message($message, $type = 'notice', $vars = null, $override = true, $timeout = 0); /** * Redirect to a certain url. * * @param array|string $p Either a string with the action or url parameters as key-value pairs * @param int $delay Delay in seconds */ abstract function redirect($p = [], $delay = 1); /** * Send output to the client. */ abstract function send(); /** * Send HTTP headers to prevent caching a page */ public function nocacheing_headers() { if (headers_sent()) { return; } header("Expires: ".gmdate("D, d M Y H:i:s")." GMT"); header("Last-Modified: ".gmdate("D, d M Y H:i:s")." GMT"); // We need to set the following headers to make downloads work using IE in HTTPS mode. if ($this->browser->ie && rcube_utils::https_check()) { header('Pragma: private'); header("Cache-Control: private, must-revalidate"); } else { header("Cache-Control: private, no-cache, no-store, must-revalidate, post-check=0, pre-check=0"); header("Pragma: no-cache"); } } /** * Send header with expire date 30 days in future * * @param int $offset Expiration time in seconds */ public function future_expire_header($offset = 2600000) { if (headers_sent()) { return; } header("Expires: " . gmdate("D, d M Y H:i:s", time()+$offset) . " GMT"); header("Cache-Control: max-age=$offset"); header("Pragma: "); } /** * Send browser compatibility/security/privacy headers * * @param bool $privacy Enable privacy headers */ public function common_headers($privacy = true) { if (headers_sent()) { return; } $headers = []; // Unlock IE compatibility mode if ($this->browser->ie) { $headers['X-UA-Compatible'] = 'IE=edge'; } if ($privacy) { // Request browser to disable DNS prefetching (CVE-2010-0464) $headers['X-DNS-Prefetch-Control'] = 'off'; // Request browser disable Referer (sic) header $headers['Referrer-Policy'] = 'same-origin'; } // send CSRF and clickjacking protection headers if ($xframe = $this->app->config->get('x_frame_options', 'sameorigin')) { $headers['X-Frame-Options'] = $xframe; } $plugin = $this->app->plugins->exec_hook('common_headers', ['headers' => $headers, 'privacy' => $privacy]); foreach ($plugin['headers'] as $header => $value) { header("$header: $value"); } } /** * Send headers related to file downloads. * * @param string $filename File name * @param array $params Optional parameters: * type - File content type (default: 'application/octet-stream') * disposition - Download type: 'inline' or 'attachment' (default) * length - Content length * charset - File name character set * type_charset - Content character set * time_limit - Script execution limit (default: 3600) */ public function download_headers($filename, $params = []) { // For security reasons we validate type, filename and charset params. // Some HTTP servers might drop a header that is malformed or very long, this then // can lead to web browsers unintentionally executing javascript code in the body. if (empty($params['disposition'])) { $params['disposition'] = 'attachment'; } $ctype = 'application/octet-stream'; $disposition = $params['disposition']; if (!empty($params['type']) && is_string($params['type']) && strlen($params['type']) < 256 && preg_match('/^[a-z0-9!#$&.+^_-]+\/[a-z0-9!#$&.+^_-]+$/i', $params['type']) ) { $ctype = $params['type']; } // Send unsafe content as plain text if ($disposition == 'inline') { if (preg_match('~(javascript|jscript|ecmascript|xml|html|text/)~i', $ctype)) { $ctype = 'text/plain'; } if (stripos($ctype, 'text') === 0) { $charset = $this->charset; if (!empty($params['type_charset']) && rcube_charset::is_valid($params['type_charset'])) { $charset = $params['type_charset']; } $ctype .= "; charset={$charset}"; } } if (is_string($filename) && strlen($filename) > 0 && strlen($filename) <= 1024) { // For non-ascii characters we'll use RFC2231 syntax if (!preg_match('/[^a-zA-Z0-9_.:,?;@+ -]/', $filename)) { $disposition .= "; filename=\"{$filename}\""; } else { $filename = rawurlencode($filename); $charset = $this->charset; if (!empty($params['charset']) && rcube_charset::is_valid($params['charset'])) { $charset = $params['charset']; } $disposition .= "; filename*={$charset}''{$filename}"; } } header("Content-Disposition: {$disposition}"); header("Content-Type: {$ctype}"); if ($params['disposition'] == 'attachment' && $this->browser->ie) { header("Content-Type: application/force-download"); } if (isset($params['length'])) { header("Content-Length: " . $params['length']); } // Use strict security policy to make sure no javascript content is executed // img-src is needed to be able to print attachment preview page header("Content-Security-Policy: default-src 'none'; img-src 'self'"); // don't kill the connection if download takes more than 30 sec. if (!array_key_exists('time_limit', $params)) { $params['time_limit'] = 3600; } if (is_numeric($params['time_limit'])) { @set_time_limit($params['time_limit']); } } /** * Show error page and terminate script execution * * @param int $code Error code * @param string $message Error message */ public function raise_error($code, $message) { // STUB: to be overloaded by specific output classes fwrite(STDERR, "Error $code: $message\n"); exit(-1); } /** * Create an edit field for inclusion on a form * * @param string $name Field name * @param string $value Field value * @param array $attrib HTML element attributes for the field * @param string $type HTML element type (default 'text') * * @return string HTML field definition */ public static function get_edit_field($name, $value, $attrib = [], $type = 'text') { static $colcounts = []; $fname = '_' . $name; $attrib['name'] = $fname . (!empty($attrib['array']) ? '[]' : ''); $attrib['class'] = trim((!empty($attrib['class']) ? $attrib['class'] : '') . ' ff_' . $name); if ($type == 'checkbox') { $attrib['value'] = '1'; $input = new html_checkbox($attrib); } else if ($type == 'textarea') { if (!empty($attrib['size'])) { $attrib['cols'] = $attrib['size']; } $input = new html_textarea($attrib); } else if ($type == 'select') { $input = new html_select($attrib); if (empty($attrib['skip-empty'])) { $input->add('---', ''); } if (!empty($attrib['options'])) { $input->add(array_values($attrib['options']), array_keys($attrib['options'])); } } else if ($type == 'password' || (isset($attrib['type']) && $attrib['type'] == 'password')) { $input = new html_passwordfield($attrib); } else { if (!isset($attrib['type']) || ($attrib['type'] != 'text' && $attrib['type'] != 'hidden')) { $attrib['type'] = 'text'; } $input = new html_inputfield($attrib); } // use value from post if (isset($_POST[$fname])) { $postvalue = rcube_utils::get_input_value($fname, rcube_utils::INPUT_POST, true); if (!empty($attrib['array'])) { if (!isset($colcounts[$name])) { $colcounts[$name] = 0; } $idx = intval($colcounts[$name]++); $value = $postvalue[$idx] ?? null; } else { $value = $postvalue; } } return $input->show($value); } /** * Convert a variable into a javascript object notation * * @param mixed $input Input value * @param bool $pretty Enable JSON formatting * @param bool $inline Enable inline mode (generates output safe for use inside HTML) * * @return string Serialized JSON string */ public static function json_serialize($input, $pretty = false, $inline = true) { $options = JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_IGNORE; // JSON_HEX_TAG is needed for inlining JSON inside of the <script> tag // if input contains a html tag it will cause issues (#6207) if ($inline) { $options |= JSON_HEX_TAG; } if ($pretty) { $options |= JSON_PRETTY_PRINT; } return json_encode($input, $options); } }