X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=inc%2Fclasses%2Fmain%2Fresponse%2Fimage%2Fclass_ImageResponse.php;fp=inc%2Fclasses%2Fmain%2Fresponse%2Fimage%2Fclass_ImageResponse.php;h=c03e6ea6e5519c2672449525fa6634bd68a83328;hb=886d3459eb15f9bc6b15051b2fe2d3605c19a5d4;hp=0000000000000000000000000000000000000000;hpb=7be9aec7da3a85e55153376faada5388f4876541;p=mailer.git

diff --git a/inc/classes/main/response/image/class_ImageResponse.php b/inc/classes/main/response/image/class_ImageResponse.php
new file mode 100644
index 0000000000..c03e6ea6e5
--- /dev/null
+++ b/inc/classes/main/response/image/class_ImageResponse.php
@@ -0,0 +1,268 @@
+<?php
+/**
+ * A class for an image response on an HTTP request
+ *
+ * @author		Roland Haeder <webmaster@ship-simu.org>
+ * @version		0.0.0
+ * @copyright	Copyright (c) 2007, 2008 Roland Haeder, this is free software
+ * @license		GNU GPL 3.0 or any newer version
+ * @link		http://www.ship-simu.org
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU 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 General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ * The extended headers are taken from phpMyAdmin setup tool, written by
+ * Michal Cihar <michal@cihar.com>, licensed under GNU GPL 2.0.
+ */
+class ImageResponse extends BaseResponse implements Responseable {
+	/**
+	 * Instance of the image
+	 */
+	private $imageInstance = null;
+
+	/**
+	 * Protected constructor
+	 *
+	 * @return	void
+	 */
+	protected function __construct () {
+		// Call parent constructor
+		parent::__construct(__CLASS__);
+	}
+
+	/**
+	 * Creates an object of this class
+	 *
+	 * @param	$appInstance		An instance of a manageable application
+	 * @return	$responseInstance	A prepared instance of this class
+	 */
+	public final static function createImageResponse (ManageableApplication $appInstance) {
+		// Get a new instance
+		$responseInstance = new ImageResponse();
+
+		// Set the application instance
+		$responseInstance->setApplicationInstance($appInstance);
+
+		// Initialize the template engine here
+		$responseInstance->initTemplateEngine($appInstance);
+
+		// Return the prepared instance
+		return $responseInstance;
+	}
+
+	/**
+	 * Initializes the template engine instance
+	 *
+	 * @param	$appInstance	An instance of a manageable application
+	 * @return	void
+	 */
+	public final function initTemplateEngine (ManageableApplication $appInstance) {
+		// Get config instance
+		$cfg = $this->getConfigInstance();
+
+		// Set new template engine
+		$cfg->setConfigEntry('template_class'         , $cfg->readConfig('image_template_class'));
+		$cfg->setConfigEntry('raw_template_extension' , ".img");
+		$cfg->setConfigEntry('code_template_extension', ".itp");
+		$cfg->setConfigEntry('tpl_base_path'          , "templates/images/");
+		$cfg->setConfigEntry('code_template_type'     , "image");
+
+		// Get a prepared instance
+		$this->setTemplateInstance($this->prepareTemplateInstance($appInstance));
+	}
+
+	/**
+	 * Adds a cookie to the response
+	 *
+	 * @param	$cookieName		Cookie's name
+	 * @param	$cookieValue	Value to store in the cookie
+	 * @param	$encrypted		Do some extra encryption on the value
+	 * @param	$expires		Timestamp of expiration (default: configured)
+	 * @return	void
+	 * @throws	ResponseHeadersAlreadySentException		If headers are already sent
+	 * @todo	Encryption of cookie data not yet supported.
+	 * @todo	Why are these parameters conflicting?
+	 * @todo	If the return statement is removed and setcookie() commented out,
+	 * @todo	this will send only one cookie out, the first one.
+	 */
+	public function addCookie ($cookieName, $cookieValue, $encrypted = false, $expires = null) {
+		// Are headers already sent?
+		if (headers_sent()) {
+			// Throw an exception here
+			throw new ResponseHeadersAlreadySentException($this, self::EXCEPTION_HEADERS_ALREADY_SENT);
+		} // END - if
+
+		// Shall we encrypt the cookie?
+		if ($encrypted === true) {
+		} // END - if
+
+		// For slow browsers set the cookie array element first
+		$_COOKIE[$cookieName] = $cookieValue;
+
+		// Get all config entries
+		if (is_null($expires)) {
+			$expires = (time() + $this->getConfigInstance()->readConfig('cookie_expire'));
+		} // END - if
+
+		$path = $this->getConfigInstance()->readConfig('cookie_path');
+		$domain = $this->getConfigInstance()->readConfig('cookie_domain');
+
+		setcookie($cookieName, $cookieValue, $expires);
+		//, $path, $domain, (isset($_SERVER['HTTPS']))
+		return;
+
+		// Now construct the full header
+		$cookieString = $cookieName . "=" . $cookieValue . "; ";
+		$cookieString .= "expires=" . date("D, d-F-Y H:i:s", $expires) . " GMT";
+		// $cookieString .= "; path=".$path."; domain=".$domain;
+
+		// Set the cookie as a header
+		$this->cookies[$cookieName] = $cookieString;
+	}
+
+	/**
+	 * Redirect to a configured URL. The URL can be absolute or relative. In
+	 * case of relative URL it will be extended automatically.
+	 *
+	 * @param	$configEntry	The configuration entry which holds our URL
+	 * @return	void
+	 * @throws	ResponseHeadersAlreadySentException		If headers are already sent
+	 */
+	public function redirectToConfiguredUrl ($configEntry) {
+		// Is the header not yet sent?
+		if (headers_sent()) {
+			// Throw an exception here
+			throw new ResponseHeadersAlreadySentException($this, self::EXCEPTION_HEADERS_ALREADY_SENT);
+		} // END - if
+
+		// Assign application data
+		$this->getTemplateInstance()->assignApplicationData($this->getApplicationInstance());
+
+		// Get the url from config
+		$url = $this->getConfigInstance()->readConfig($configEntry);
+
+		// Compile the URL
+		$url = $this->getTemplateInstance()->compileRawCode($url);
+
+		// Do we have a "http" in front of the URL?
+		if (substr(strtolower($url), 0, 4) != "http") {
+			// Is there a / in front of the relative URL?
+			if (substr($url, 0, 1) == "/") $url = substr($url, 1);
+
+			// No, then extend it with our base URL
+			$url = $this->getConfigInstance()->readConfig('base_url') . "/" . $url;
+		} // END - if
+
+		// Add redirect header
+		$this->addHeader("Location", $url);
+
+		// Set correct response status
+		$this->setResponseStatus("301 Moved Permanently");
+
+		// Clear the body
+		$this->setResponseBody("");
+
+		// Flush the result
+		$this->flushBuffer();
+
+		// All done here...
+		exit();
+	}
+
+	/**
+	 * Flushs the cached HTTP response to the outer world
+	 *
+	 * @param	$force	Wether we shall force the output or abort if headers are
+	 *					already sent with an exception
+	 * @return	void
+	 */
+	public function flushBuffer ($force = false) {
+		// Finish the image
+		$this->getImageInstance()->finishImage();
+
+		// Get image content
+		$content = $this->getImageInstance()->getContent();
+
+		// Set it as response body
+		$this->setResponseBody($content);
+
+		// Set content type
+		$this->addHeader('Content-type', "image/".$this->getImageInstance()->getImageType());
+
+		// Call parent method
+		parent::flushBuffer($force);
+	}
+
+	/**
+	 * Expires the given cookie if it is set
+	 *
+	 * @param	$cookieName		Cookie to expire
+	 * @return	void
+	 */
+	public function expireCookie ($cookieName) {
+		// Is the cookie there?
+		if (isset($_COOKIE[$cookieName])) {
+			// Then expire it with 20 minutes past
+			$this->addCookie($cookieName, "", false, (time() - 1200));
+
+			// Remove it from array
+			unset($_COOKIE[$cookieName]);
+		} // END - if
+	}
+
+	/**
+	 * Refreshs a given cookie. This will make the cookie live longer
+	 *
+	 * @param	$cookieName		Cookie to refresh
+	 * @return	void
+	 */
+	public function refreshCookie ($cookieName) {
+		// Only update existing cookies
+		if (isset($_COOKIE[$cookieName])) {
+			// Update the cookie
+			$this->addCookie($cookieName, $_COOKIE[$cookieName], false);
+		} // END - if
+	}
+
+	/**
+	 * Setter for image instanxe
+	 *
+	 * @param	$imageInstance	An instance of an image
+	 * @return	void
+	 */
+	public final function setImageInstance (BaseImage $imageInstance) {
+		$this->imageInstance = $imageInstance;
+	}
+
+	/**
+	 * Getter for image instanxe
+	 *
+	 * @return	$imageInstance	An instance of an image
+	 */
+	public final function getImageInstance () {
+		return $this->imageInstance;
+	}
+
+	/**
+	 * Getter for default command
+	 *
+	 * @return	$defaultCommand		Default command for this response
+	 */
+	public function getDefaultCommand () {
+		$defaultCommand = $this->getConfigInstance()->readConfig('default_image_command');
+		return $defaultCommand;
+	}
+}
+
+// [EOF]
+?>