File Source for requisicao.classe.php

<?php
/**
* requisicao.classe.php
*
* @copyright 2008 Soomp
* @author Marcio Merlone <mmerlone@gmail.com>
* @version 1.0
* @since 18/01/2007
* @package Soomp
*/
/* $Id: requisicao.classe.php,v 1.25 2007/05/29 20:39:13 mmerlone Exp $ */
require_once(CFG_LOCAL_FRAMEWORK.'modulo.classe.php');
/**
* Processa toda a requisição, gerencia sessão, verifica módulo e ação
* solicitados, permissões, formato dos módulos, etc.
* - Lê o config.php e módulos existentes
* - Limpa a requisição
* - Define o idioma da requisição
* - Armazena o usuário logado, caso algum
* - Précarrega o módulo solicitado, caso algum
* - Exibe a saída html resultante ou dados solicitados caso ajax, soap, etc.
* O objeto nunca deve ser instanciado com new requisicao(); mas:
* <code>
* $req = requisicao::getInstance(CFG_MODULOS);
* </code>
*/
class requisicao extends modulo{
/**
* @var string $strLang armazena o idioma utilizado na requisição
*/
private $strLang;
/**
* @var object $objUser armazena o usuário logado no sistema
*/
private $objUser = null;
/**
* @var integer $intTsReq armazena o timestamp de criação da requisição.
*/
private $intTsReq;
/**
* @var object $instance instância da classe
*/
private static $instance = null;
/**
* Processa toda a requisição, gerencia sessão, verifica módulo e ação
* solicitados, permissões, formato dos módulos, etc.
* - Lê o config.php e módulos existentes
* - Limpa a requisição
* - Define o idioma da requisição
* - Armazena o usuário logado, caso algum
* - Précarrega o módulo solicitado, caso algum
* - Exibe a saída html resultante ou dados solicitados caso ajax, soap, etc.
* O objeto nunca deve ser instanciado com new requisicao(); mas:
* <code>
* $req = requisicao::getInstance(CFG_MODULOS);
* </code>
* @param array $CFG_MODULOS array com os modulos ativos no sistema (config.php)
*/
public function __construct(&$CFG_MODULOS){
$this->arrModulos = $CFG_MODULOS;
$this->_cleanRequest(); // Trata $_GET, $_POST, $_REQUEST, etc
$this->_setLang(); // $this->strLang Define o idioma a ser usado
$this->_setUser(); // $this->objUser Instancia a classe usuário
$this->run(); // processa o módulo
$this->save(); // Limpa objetos desnecessários, serializa e armazena na sessão
}
/**
* Overload de propriedades privadas
* @param string $var nome da propriedade
* @param mixed $value valor da propriedade
*/
private function __set($var, $value){
$this->$var = $value;
}
/**
* Overload de propriedades privadas
* @param string $var nome da propriedade
* @return mixed valor da propriedade
*/
private function __get($var){
return $this->$var;
}
/**
* Singleton - retorna o objeto já instanciado ou armazenado na sessão.
*/
public static function getInstance(&$CFG_MODULOS){
if(isset($_SESSION['req'])){
self::$instance = unserialize($_SESSION['req']);
self::$instance->__construct($CFG_MODULOS);
}else{
if(!self::$instance = self::_getInstanceDb()){
self::$instance = new requisicao($CFG_MODULOS);
self::$instance->intTsReq = time();
}
}
return self::$instance;
}
/**
* Finaliza a requisição baseado no retorno do módulo
* @param string $retorno retorno do módulo:
* - string com a ação ('lista' por exemplo)
* - string com um url completo ('index.php?m=bla&a=foo' por exemplo)
* - bool ou nulo indica o sucesso da execução da ação (nulo é considerado true)
* Se is_bool($ret) então a execução continua até __outpuFoot
* Caso contrário cai em $this->redireciona($url);
*/
protected function endRequest($retorno){
if(is_bool($retorno) || is_null($retorno)){
// Execução continua com _outputFoot();
return is_null($retorno) ? true : $retorno;
}else{
// Se tem o caractere ponto (.) considera-se como uma url.
if(!strpos($retorno, '.')){
$url = !is_null($retorno) ? 'index.php?m='.$this->strModule.'&a='.$retorno : null;
}else{
$url = $retorno;
}
if(!is_null($url) && $this->_smarty()){
return $this->redireciona($url);
}elseif(defined('AJAX')){
return $retorno;
}
}
}
/**
* Redireciona para um módulo e ação especificados, útil para os casos
* após um POST para evitar repetição.
* @param string $url url relativa ou absoluta a redirecionar
* Exibe ao browser:
* <code>
* <script type="text/javascript">document.location=$url;</script>
* </code>
*/
protected function redireciona($url = 'index.php'){
$this->save();
if(is_numeric($url)){
$url = 'index.php?s='.$url;
}
if(defined('CFG_DEBUG_REDIRECT') && CFG_DEBUG_REDIRECT){
$this->outputHead();
$this->msg(0, '<a href="'.$url.'" title="Desative o CFG_DEBUG no config.php para redirecionar automaticamente.">Continuar em '.$url.'</a>', 'sucesso');
$this->outputFoot();
}elseif($this->_smarty()){
header('Location:'.$url);
}
exit;
}
/**
* Limpa o objeto requisicao dos objetos auxiliares (smarty, ado, etc)
* e grava na sessão quando da serialização da requisição.
*/
protected function save(){
$this->db = null;
$this->dbUser = null;
$this->smarty = null;
$_SESSION['req'] = serialize($this);
}
/**
* Busca a instância do objeto requisição no banco de dados.
* @todo implementar o armazenamento e recuperação da requisição no banco.
*/
private static function _getInstanceDb(){
/*
* Implementar
*/
return false;
}
/**
* Faz a limpeza básica de variáveis de requisição
* @todo usar array_walk
* @todo melhorar muito isso
* @todo Implementar CFG_USUARIO_SECURITY
* @link http://us2.php.net/manual/en/function.array-walk.php
*/
private function _cleanRequest(){
/**
* Busca em $_REQUEST SQL injection
*/
// implementar
/**
* Verifica se o ip do acesso atual é o mesmo armazenado em $this->objUser->ip
*/
if(defined('CFG_USUARIO_CHECK_IP') && CFG_USUARIO_CHECK_IP && isset($this->objUser->ip) && $this->objUser->ip != $_SERVER['REMOTE_ADDR']){
$this->objUser = null;
$this->msg(0, 'Sessão expirada.', 'sucesso');
}
/**
* Escapa aspas, html, etc.
*/
foreach(array('_POST', '_GET', '_COOKIE') as $request){
if (!empty($$request)){
foreach ($$request as $key => $linha) {
if (is_string($$request[$key])) $$request[$key] = htmlentities(addslashes($linha), ENT_QUOTES, CFG_CHARSET);
}
}
}
}
/**
* Define o idioma a ser utilizado na requisição
*/
private function _setLang(){
require_once(CFG_LOCAL_FRAMEWORK.'idioma.classe.php');
$idioma = idioma::getInstance();
$this->strLang = $_SESSION['lang'] = $idioma->strLang;
switch($this->strLang){
case 'pt':
$LC_ALL = 'pt_BR';
break;
case 'en':
$LC_ALL = 'en_US';
break;
default:
$LC_ALL = 'pt_BR';
break;
}
setlocale(LC_ALL, $LC_ALL);
}
/**
* Define $this->objUser
*/
private function _setUser(){
if(isset($CFG['usuario']) && $CFG['usuario']){
$this->objUser = is_object($this->objUser) ? $this->objUser : new usuario();
if(defined('CFG_SESSION_EXPIRE') && CFG_SESSION_EXPIRE &&
property_exists($this->objUser, 'TS_LOGIN') &&
!empty($this->objUser->TS_LOGIN) &&
strtotime($this->objUser->TS_LOGIN)+CFG_SESSION_EXPIRE < time()){
$this->objUser = null;
$this->_logout();
}
}
if($this->_smarty()){
$this->smarty->assign('CFG_USUARIO_DB_PK', CFG_USUARIO_DB_PK);
$this->smarty->assign('CFG_USUARIO_DB_USERNAME', CFG_USUARIO_DB_USERNAME);
$this->smarty->assign('CFG_USUARIO_DB_SENHA', CFG_USUARIO_DB_SENHA);
$this->smarty->assign('CFG_USUARIO_DB_NOME', CFG_USUARIO_DB_NOME);
$this->smarty->assign('CFG_USUARIO_DB_EMAIL', CFG_USUARIO_DB_EMAIL);
$this->smarty->assign('CFG_USUARIO_GRUPO_DB_FK_GRUPO', CFG_USUARIO_GRUPO_DB_FK_GRUPO);
$this->smarty->assign('CFG_USUARIO_DB_TS', CFG_USUARIO_DB_TS);
$this->smarty->assign('CFG_GRUPO_DB_PK', CFG_GRUPO_DB_PK);
$this->smarty->assign('CFG_GRUPO_DB_NOME', CFG_GRUPO_DB_NOME);
$this->smarty->assign('CFG_GRUPO_DB_TS', CFG_GRUPO_DB_TS);
}
}
}
?>

Documentation generated on Sun, 09 Mar 2008 23:53:00 -0300 by phpDocumentor 1.4.0

Source for file requisicao.classe.php