WebSVN – Sites.tela-botanica.org – Diff – /trunk/scripts/bibliotheque/noyau/aModule.class.php


<?php
 
abstract class aModule {
	
	/*** Constantes : ***/
	
	const TPL_NULL = 'NULL';
	const TPL_PHP = 'PHP';
	const TPL_PHP_MAIL = 'PHP_MAIL';
	const TPL_IT = 'IT';
	const TPL_FPDI = 'FPDI';
	const SORTIE_NULL = 'NULL';
	const SORTIE_EXIT = 'EXIT';
	const SORTIE_MAIL_SMTP = 'email';
	const SORTIE_HTML = 'html';
	const SORTIE_EXIT_HTML = 'exit.html';
	const SORTIE_XML = 'xml';
	const SORTIE_PDF = 'pdf';
	
	/*** Attributs : ***/
	private $registre;
	private $cache;
	private $actions_chainees = null;
	
	/*** Constructeur : ***/
	
	public function __construct()
    {
    	$this->registre = Registre::getInstance();
		$this->registre->set('squelette_moteur', aModule::TPL_PHP);
		$this->registre->set('format', aModule::SORTIE_HTML);
		$applette_dossier = preg_replace('/([a-z])([A-Z])/', '$1_$2', get_class($this));
		
		// Nous créons automatiquement les chemins vers les différents dossier de l'application
		$this->registre->set('chemin_module', SC_CHEMIN_MODULE.strtolower($applette_dossier).DIRECTORY_SEPARATOR);
		$this->registre->set('chemin_module_config', $this->registre->get('chemin_module').'configuration'.DIRECTORY_SEPARATOR);
		$this->registre->set('chemin_module_squelette', $this->registre->get('chemin_module').'squelettes'.DIRECTORY_SEPARATOR);
		
		// Nous définissons si oui ou non le cache sera utilisé
		if (defined('SC_BOOL_STOCKAGE_CACHE')) {
			$this->cache_bool = SC_BOOL_STOCKAGE_CACHE;
		} else {
			$this->cache_bool = false;
			$e = 'La constante SC_BOOL_STOCKAGE_CACHE est indéfinie. Le cache a été désactivé!';
			trigger_error($e, E_USER_WARNING);
		}
		
		// Nous chargeons le fichier de config de l'appli s'il existe
		if ($this->getConfigFichier()) {
			require_once $this->getConfigFichier();
		}
    }
 
    /*** Accesseurs : ***/
    public function getRegistre()
    {
    	return $this->registre;
    }
    
    public function setCacheBool($cb)
    {
    	return $this->cache_bool = $cb;
    }
    
    /*** Méthodes : ***/
    
    public function getCacheId()
    {
    	if ($this->getActionNom() != null) {
    		$methode_cache_id = 'getCacheId'.$this->getActionNom();
    		if (method_exists($this, $methode_cache_id) && !is_null($this->$methode_cache_id())) {
    			return call_user_func(array($this, $methode_cache_id));
    		}
    	}
    	return null;
    }
    
    public function getCacheFichier()
    {
    	$fichier_cache = EF_CHEMIN_STOCKAGE_CACHE.$this->getCacheId();
    	if (!is_null($this->getCacheDuree())) {
    		$fichier_cache .= '_['.$this->getCacheDuree().']';
    	}
    	$fichier_cache .= '.cache.'.$this->getRegistre()->get('format');
    	
    	return $fichier_cache;
    }
    
    public function getCacheDuree()
    {
    	$dlc = null;
    	$methode_cache_dlc = 'getCacheDlc'.$this->getActionNom();
    	if (method_exists($this, $methode_cache_dlc) && !is_null($this->$methode_cache_dlc())) {
    		$dlc = call_user_func(array($this, $methode_cache_dlc)); // dlc en seconde
    	}
    	return $dlc;
    }
    
    public function getActionNom()
    {
		if ($this->getRegistre()->get('action') != null) {
			return $action = str_replace(' ', '', ucwords(str_replace('_', ' ', $this->getRegistre()->get('action'))));
		}
		return null;
    }
    
    public function setDebogage($d, $e = E_USER_NOTICE)
    {
    	if (is_array($d) || is_object($d)) {
    		trigger_error(print_r($d, true), $e);
    	} else {
    		trigger_error($d, $e);
    	}
    }
    
    public function setChrono($balise)
    {
		// Mesure du temps d'éxecution
		$class = new ReflectionClass($this);
		$GLOBALS['_SCRIPT_']['chrono']->setTemps(array($class->getName().'-'.$balise => microtime()));
    }
    
    public function getSqueletteFichier()
    {
		// Par défaut le nom du fichier de squelette est construit à partir du nom de l'action.
		if (is_null($this->getRegistre()->get('squelette_fichier'))) {
			$this->getRegistre()->set('squelette_fichier', $this->getRegistre()->get('action'));
		}
 
		// Nous recherchons s'il existe un squelette spécifique à la distribution
		$fichier_tpl_defaut =  	$this->getRegistre()->get('chemin_module_squelette').
								$this->getRegistre()->get('squelette_fichier').'.tpl.'.$this->registre->get('format');
		if (defined('SC_DISTRIBUTION') && SC_DISTRIBUTION != ''&& !is_null(SC_DISTRIBUTION)) {
			$fichier_tpl_projet =  	$this->getRegistre()->get('chemin_module_squelette').
									strtolower(SC_DISTRIBUTION).DIRECTORY_SEPARATOR.
									$this->getRegistre()->get('squelette_fichier').'.tpl.'.$this->getRegistre()->get('format');
			if (file_exists($fichier_tpl_projet)) {
				return $fichier_tpl_projet;
			}
		}
		if (file_exists($fichier_tpl_defaut)) {
			return $fichier_tpl_defaut;
		}
		return false;
    }
    
    public function getConfigFichier()
    {
		$fichier_conf_defaut = $this->getRegistre()->get('chemin_module_config').'config.inc.php';
		if (defined('SC_DISTRIBUTION') && SC_DISTRIBUTION != '') {
			
			$fichier_conf_projet = 	$this->getRegistre()->get('chemin_module_config').
									'config.'.strtolower(SC_DISTRIBUTION).'.inc.php';
			if (file_exists($fichier_conf_projet)) {
				return $fichier_conf_projet;
			}
		}
		if (file_exists($fichier_conf_defaut)) {
			return $fichier_conf_defaut;
		}
		return false;
    }
    
    public function getActionsChainees()
    {
    	// Création du tableau si nécessaire
		if (is_null($this->actions_chainees)) {
			$this->actions_chainees = array();
			$this->actions_chainees[] = $this->getRegistre()->get('action');
		}
		return $this->actions_chainees;
    }
    
    public function poursuivreVers($action)
    {
		// Ajout de l'action suivante
   		$this->actions_chainees[] = $action;
    }
    
	public function traiterAction()
    {	
		// Gestion des actions chainées si nécessaire
		$sortie = '';
		$module_nom = strtolower(get_class($this));
		$i = 0;
		while ($i < count($this->getActionsChainees())) {
			// Initialisation de variables
			$actions = $this->getActionsChainees();
			$action = $actions[$i++];
			
			// Remise à défaut des valeurs du Registre pour la prochaine action
			$this->getRegistre()->set('action', $action);
			$this->getRegistre()->set('format', aModule::SORTIE_HTML);
			$this->getRegistre()->set('squelette_fichier', null);
			$this->getRegistre()->set('squelette_moteur', aModule::TPL_PHP);
			
			// Gestion du multilinguisme
			/*
			if (isset($GLOBALS['_EF_']['i18n'][$module_nom][$action]) || isset($GLOBALS['_EF_']['i18n']['_defaut_'][$action])) {
				$this->getRegistre()->set('module_i18n', $GLOBALS['_EF_']['i18n']['_defaut_']['general']);
				if (isset($GLOBALS['_EF_']['i18n']['_defaut_'][$action])) {
					$this->getRegistre()->set('module_i18n', $GLOBALS['_EF_']['i18n']['_defaut_'][$action]);
				}
				if (isset($GLOBALS['_EF_']['i18n'][$module_nom][$action])) {
					$this->getRegistre()->set('module_i18n', $GLOBALS['_EF_']['i18n'][$module_nom][$action]);
				}
				
				$aso_donnees = $this->getRegistre()->get('squelette_donnees');
				$aso_donnees['i18n'] = $this->getRegistre()->get('module_i18n');
				$this->getRegistre()->set('squelette_donnees', $aso_donnees);
				
			}
			*/
			// Exécution du rendu de l'action
			$sortie .= $this->traiterRendu($action);
		}
		
		// Gestion de la sortie finale
		return $sortie;
    }
	
	private function traiterRendu()
    {		
		// Gestion du cache : avant toute chose, retour du cache s'il existe
    	if ($this->cache_bool) {
			//$this->setDebogage($this->getCacheId());
			if (!is_null($this->getCacheId())) {
				if (file_exists($this->getCacheFichier())) {
					// Gestion de la DLC
					if (	(is_null($this->getCacheDuree())) ||
							(!is_null($this->getCacheDuree()) && (time() < (filemtime($this->getCacheFichier()) + $this->getCacheDuree())))) {
						$this->registre->set('sortie', file_get_contents($this->getCacheFichier()));
						return $this->traiterSortie();
					}
				}
			}
		}
		
		// Attribution si nécessaire de l'encodage de sortie
		if (!$this->registre->get('charset')) {
			$this->registre->set('charset', 'ISO-8859-1');
		}
		
    	// Execution de l'action
		$methode_action = 'executer';
		if ($this->getActionNom() != null) {
			$methode_action .= $this->getActionNom();
		}
    	if (method_exists($this, $methode_action)) {
    		call_user_func(array($this, $methode_action));
    	} else if (!$this->getSqueletteFichier()) {
    		// Tentative de recherche de l'action dans le module des Communs
    		$fichier_communs = SC_CHEMIN_MODULE.'communs'.DIRECTORY_SEPARATOR.'Communs.class.php';
    		if (file_exists($fichier_communs)) {
    			include_once $fichier_communs;
				$Commun = new Communs();
				$sortie_commun = $Commun->traiterAction();
    		}
			if (isset($sortie_commun)) {
				return $sortie_commun;
			} else {
    			$e = 'Aucun squelette ou méthode "'.$methode_action.'" n\'existe pour l\'action '.$this->registre->get('action');
    			trigger_error($e, E_USER_WARNING);
    			return null;
			}
    	}
 
    	// Gestion du rendu en fonction du type de template
    	switch($this->registre->get('squelette_moteur')) {
			case aModule::TPL_PHP_MAIL :
			case aModule::TPL_PHP :
 
 
				$Squelette = new SquelettePhp();
				$Squelette->set($this->getRegistre()->get('squelette_donnees'));
				if ($this->getSqueletteFichier()) {
					$sortie = $Squelette->analyser($this->getSqueletteFichier());
					if ($this->registre->get('squelette_moteur') == aModule::TPL_PHP_MAIL) {
						// Traitement spécial pour les mails
						if (preg_match_all('/<(html|txt|file)(?:>(.*?)<\/\\1>|\s+src="(.*)"\s+type="(.*)"\s*\/>\s*$)/ism', $sortie, $decoupage, PREG_SET_ORDER)) {
							$this->registre->set('sortie_mail_mime', $decoupage);
						}
					} else {
						$this->registre->set('sortie', $sortie);
					}
				} else {
					$e = 'Action : '.$this->getRegistre()->get('action').' fichier de squelette introuvable !';
					trigger_error($e, E_USER_WARNING);
					return null;
				}
				break;
    		case aModule::TPL_NULL :
    			// Nous ne faisons rien, nous passons à la gestion du type de sortie
    			break;
    		default :
    			trigger_error('Moteur de squelette inconnu', E_USER_WARNING);
    			return null;
    	}
    	
    	// Gestion du cache : écriture du fichier
		if ($this->cache_bool) {
			if (!is_null($this->getCacheId())) {
				if (!file_put_contents($this->getCacheFichier(), $this->getRegistre()->get('sortie'))) {
					$e = 'Écriture du fichier de cache impossible : '.$this->getCacheFichier();
					trigger_error($e, E_USER_WARNING);
				}
			 }
		}
		
		// Gestion du format de sortie
		return $this->traiterSortie();
    }
    
    private function traiterSortie()
    {
    	switch($this->getRegistre()->get('format')) {
			case aModule::SORTIE_HTML :
				// +--------------------------------------------------------------------------------------------------+
				// A FAIRE : Gestion des statistiques
 
				// +--------------------------------------------------------------------------------------------------+				
				// Gestion du cache : affichage de la date du cache
				if ($this->cache_bool) {
					if (!is_null($this->getCacheId())) {
						$e = 	'Cache, généré le '.date('D d M Y à H:i:s', filemtime($this->getCacheFichier())).
								' sera généré à nouveau le '.
								date('D d M Y à H:i:s', (filemtime($this->getCacheFichier()) + $this->getCacheDuree()))." \n";
						trigger_error($e, E_USER_NOTICE);
					}
				}
				return $this->getRegistre()->get('sortie');
				break;
			case aModule::SORTIE_EXIT_HTML :
				echo $this->getRegistre()->get('sortie');
				exit();
				break;
			case aModule::SORTIE_XML :
				header('Content-Type: application/xhtml+xml; charset='.$this->registre->get('charset'));
				echo $this->registre->get('sortie');
				exit();
				break;
			case aModule::SORTIE_PDF :
				header('Content-type: application/pdf');
				header('Content-Length: '.strlen($this->getRegistre()->get('sortie')));
				header('Content-Disposition: inline; filename='.str_replace(' ', '_', $GLOBALS['_SCRIPT_']['titre_fichier']).'.pdf');//
				echo $this->registre->get('sortie');
				break;
			case aModule::SORTIE_MAIL_SMTP :
				//trigger_error(print_r($this->getRegistre()->get('sortie_mail_mime'), true), E_USER_NOTICE);
				// TODO : réseoudre le problème de l'autoload pour les fichiers PEAR ci-dessous
				include_once 'Mail.php';
				include_once 'Mail/smtp.php';
				$sortie_mail = '';
				// Nous vérifions si nous avons à faire à un mail mime ou pas
				if (is_null($this->getRegistre()->get('sortie_mail_mime'))) {
					$sortie_mail = $this->getRegistre()->get('sortie');
				} else {
					// Pour l'instant supporte du html et son alternative en txt plus des fichiers attachés
					// TODO : Les mails multiparts contenant des imbrications de html et de txt ne sont pas encore pris en compte...
					include_once 'Mail/mime.php';
					$MailMime = new Mail_mime("\n");
					foreach ($this->getRegistre()->get('sortie_mail_mime') as $valeur) {
						switch (strtolower($valeur[1])) {
							case 'txt' :
								// Syntaxe multiligne: <txt>mettre ici du texte brute</txt>
								$MailMime->setTXTBody($valeur[2]);
								break;
							case 'html' :
								// Syntaxe multiligne: <html>mettre ici votre html</html>
								$MailMime->setHTMLBody($valeur[2]);
								break;
							case 'file' :
								// Syntaxe sur une ligne: <file src="/tmp/un_test.txt" type="text/plain" />
								$e = $MailMime->addAttachment($valeur[3], $valeur[4]);
								if ($e instanceof PEAR_Error) {
									trigger_error($e->getMessage(), E_USER_NOTICE);
								}
								break;
							default :
								trigger_error('Type de balise inconnue :'.$valeur[1], E_USER_WARNING);
						}
					}
					//do not ever try to call these lines in reverse order
					$sortie_mail = $MailMime->get();
					$this->getRegistre()->set('sortie_mail_smtp_entete', $MailMime->headers($this->getRegistre()->get('sortie_mail_smtp_entete')));
				}
				$mail_object = new Mail_smtp($this->getRegistre()->get('sortie_mail_smtp_params'));
				$message = $mail_object->send(	$this->getRegistre()->get('sortie_mail_smtp_destinataire'), 
												$this->getRegistre()->get('sortie_mail_smtp_entete'), 
												$sortie_mail);
				$this->getRegistre()->set('sortie_mail_smtp_info', $message);
				return null;
				break;
			case aModule::SORTIE_EXIT :
    			// Nous ne faisons rien, nous terminons seulement le programme ici
    			exit();
    			break;
			case aModule::SORTIE_NULL :
    			// Nous ne faisons rien, nous retournons null
    			return null;
    			break;
			default :
    			trigger_error('Type de sortie inconnu', E_USER_ERROR);
		}
    }
}
?>

Subversion Repositories Sites.tela-botanica.org

(root)/trunk/scripts/bibliotheque/noyau/aModule.class.php – Rev 376 → 381

Rev 376		Rev 381
1	`<?php`	1	`<?php`
2		2
3	`abstract class aModule {`	3	`abstract class aModule {`
4		4
5	`/* Constantes : */`	5	`/* Constantes : */`
6		6
7	`const TPL_NULL = 'NULL';`	7	`const TPL_NULL = 'NULL';`
8	`const TPL_PHP = 'PHP';`	8	`const TPL_PHP = 'PHP';`
9	`const TPL_PHP_MAIL = 'PHP_MAIL';`	9	`const TPL_PHP_MAIL = 'PHP_MAIL';`
10	`const TPL_IT = 'IT';`	10	`const TPL_IT = 'IT';`
11	`const TPL_FPDI = 'FPDI';`	11	`const TPL_FPDI = 'FPDI';`
12	`const SORTIE_NULL = 'NULL';`	12	`const SORTIE_NULL = 'NULL';`
13	`const SORTIE_EXIT = 'EXIT';`	13	`const SORTIE_EXIT = 'EXIT';`
14	`const SORTIE_MAIL_SMTP = 'email';`	14	`const SORTIE_MAIL_SMTP = 'email';`
15	`const SORTIE_HTML = 'html';`	15	`const SORTIE_HTML = 'html';`
16	`const SORTIE_EXIT_HTML = 'exit.html';`	16	`const SORTIE_EXIT_HTML = 'exit.html';`
17	`const SORTIE_XML = 'xml';`	17	`const SORTIE_XML = 'xml';`
18	`const SORTIE_PDF = 'pdf';`	18	`const SORTIE_PDF = 'pdf';`
19		19
20	`/* Attributs : */`	20	`/* Attributs : */`
21	`private $registre;`	21	`private $registre;`
22	`private $cache;`	22	`private $cache;`
23	`private $actions_chainees = null;`	23	`private $actions_chainees = null;`
24		24
25	`/* Constructeur : */`	25	`/* Constructeur : */`
26		26
27	`public function __construct()`	27	`public function __construct()`
28	`{`	28	`{`
29	`$this->registre = Registre::getInstance();`	29	`$this->registre = Registre::getInstance();`
30	`$this->registre->set('squelette_moteur', aModule::TPL_PHP);`	30	`$this->registre->set('squelette_moteur', aModule::TPL_PHP);`
31	`$this->registre->set('format', aModule::SORTIE_HTML);`	31	`$this->registre->set('format', aModule::SORTIE_HTML);`
32	`$applette_dossier = preg_replace('/([a-z])([A-Z])/', '$1_$2', get_class($this));`	32	`$applette_dossier = preg_replace('/([a-z])([A-Z])/', '$1_$2', get_class($this));`
33		33
34	`// Nous créons automatiquement les chemins vers les différents dossier de l'application`	34	`// Nous créons automatiquement les chemins vers les différents dossier de l'application`
35	`$this->registre->set('chemin_module', SC_CHEMIN_MODULE.strtolower($applette_dossier).DIRECTORY_SEPARATOR);`	35	`$this->registre->set('chemin_module', SC_CHEMIN_MODULE.strtolower($applette_dossier).DIRECTORY_SEPARATOR);`
36	`$this->registre->set('chemin_module_config', $this->registre->get('chemin_module').'configuration'.DIRECTORY_SEPARATOR);`	36	`$this->registre->set('chemin_module_config', $this->registre->get('chemin_module').'configuration'.DIRECTORY_SEPARATOR);`
37	`$this->registre->set('chemin_module_squelette', $this->registre->get('chemin_module').'squelettes'.DIRECTORY_SEPARATOR);`	37	`$this->registre->set('chemin_module_squelette', $this->registre->get('chemin_module').'squelettes'.DIRECTORY_SEPARATOR);`
38		38
39	`// Nous définissons si oui ou non le cache sera utilisé`	39	`// Nous définissons si oui ou non le cache sera utilisé`
40	`if (defined('SC_BOOL_STOCKAGE_CACHE')) {`	40	`if (defined('SC_BOOL_STOCKAGE_CACHE')) {`