CLICK HERE TO BUY IT TODAY! OR GET IT FREE VIA TRIALPAY  

PHP Demo Application - Source Code

/Framework/Controller/Libraries/Input.php

<?php
/**
* Script Contents: Apeel_Framework_Controller_Libraries_Input Class
* @package Apeel_Framework_Controller 
*/

/**
* Input handling library

* A static library providing input handling methods that ensure the requested
* index exists and the value is properly escaped.  Primarily used for Requests,
* Session and Arrays
*
* @package      Apeel_Framework_Controller 
* @version      1.1.0
* @author       John W. King (email: contact@apeelframework.net)
* @copyright    City Business Logic Limited 2001-2011
* @license      Dual MIT / GNU Lesser General Public License Version 3
*/
class Apeel_Framework_Controller_Libraries_Input {
    
    
/**
    * Retrieve value matching the given index from the php $_REQUEST object
    * 
    * Checks whether the requested index exists in the $_REQUEST object, if so
    * it escapes the value (to guard against injection attack) and returns the
    * sanitized value.  
    * 
    * If the indexed value does not exist, the method returns the given default 
    * value (which itself defaults to an empty string if not supplied).  
    *
    * @param mixed $index
    * @param mixed $default [optional] - value to return if index does not exist.
    * @param mixed $emptyValue [optional] - value to return if value empty.
    * @return mixed
    */    
    
public static function request($index$default ''$emptyValue '') {
        if (isset(
$_REQUEST[$index])) {
            
$value = ($_REQUEST[$index]);
            if (
$value == '') {
                
$value $emptyValue;
            }
            return 
$value;
        } else {
            return 
$default;
        }
    }

    
    
/**
    * Retrieve value matching the given index from the supplied array
    * 
    * Checks whether the requested index exists in the supplied array, if so it
    * escapes the value (to guard against injection attack) and returns the
    * sanitized value.  
    * 
    * If the indexed value does not exist, the method returns the given default 
    * value (which itself defaults to an empty string if not supplied).  
    *
    * @param array $array 
    * @param mixed $index
    * @param mixed $default [optional] - value to return if index does not exist.
    * @return mixed
    */      
    
public static function getArrayValueByIndex($array$index$default '') {
        if (isset(
$array[$index])) {
            return 
$array[$index];
        } else {
            return 
$default;
        }
    }
    

    
/**
    * Retrieve value matching the given index from the supplied array or throw
    * exception
    * 
    * Checks whether the requested index exists in the supplied array, if so it
    * escapes the value (to guard against injection attack) and returns the
    * sanitized value.  
    * 
    * If the indexed value does not exist, an exception is thrown, using the
    * $arrayDescription parameter to describe the type of item that was being
    * looked up.  
    *
    * @param array $array 
    * @param mixed $index
    * @param mixed $arrayDescription [optional] - used in exception message to 
    * describe the type of item being looked up
    * @return mixed
    */ 
    
public static function getArrayValueByIndexMustExist($array$index$arrayDescription '') {
        if (
$index == '') {
            return 
$array;
        } elseif (isset(
$array[$index])) {
            return 
$array[$index];
        } else {
            throw new 
Exception($index ' does not exist in ' $arrayDescription);
        }
    }
    

    
/**
    * Retrieve value matching the given index from the php $_SESSION object
    * 
    * Checks whether the requested index exists in the $_SESSION object, if so
    * it escapes the value (to guard against injection attack) and returns the
    * sanitized value.  
    * 
    * If the indexed value does not exist, the method returns the given default 
    * value (which itself defaults to an empty string if not supplied).  
    *
    * @param mixed $index
    * @param mixed $default [optional] - value to return if index does not exist.
    * @return mixed
    */    
    
public static function session($index$default '') {
        if (isset(
$_SESSION[$index])) {
            return 
addslashes($_SESSION[$index]);
        } else {
            return 
$default;
        }
    }
    
    
    
/**
    * Clear current page from browser cache to ensure that the file is always 
    * processed and retrieved by the server.  
    * 
    * For example, is useful for AJAX queries.  
    * 
    * N.B. Must be called before any other output on page.  
    * 
    */
    
public static function clearCache() {
        
header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");
        
header("Last-Modified: " gmdate("D, d M Y H:i:s") . " GMT"); 
        
header("Cache-Control: no-store, no-cache, must-revalidate"); 
        
header("Cache-Control: post-check=0, pre-check=0"false);
        
header("Pragma: no-cache");     
    }
    
}

?>

PHP Demo Source Code Index