Extension de fonctionnalités » History » Revision 6
Revision 5 (Simon, 07/03/2012 07:01 PM) → Revision 6/10 (Simon, 07/04/2012 09:48 AM)
{{>toc}}
h2. Généralités
Le système de plugins est conçu autour du composant "Event Dispatcher du framework symfony":http://components.symfony-project.org/event-dispatcher/documentation, basé sur le concept d'"Observer pattern":http://fr.wikipedia.org/wiki/Observateur_%28patron_de_conception%29. symfony":http://components.symfony-project.org/event-dispatcher/documentation.
A l'exception des classes systèmes externes et dela classe _culture_, les classes peuvent être étendues par le système de plugin et la fonction magique __call(). (voir "documentation":http://components.symfony-project.org/event-dispatcher/trunk/book/02-Recipes#chapter_02_adding_methods_to_a_class)
h2. Extension des fonctionnalités de l'application
Il est, via le [[Systeme de Plugins|système de plugins]], aisé d'écouter un événement pour exécuter une nouvelle action lors de son appel.
Nous allons par exemple créer un plugin qui logguera chaque tentative d'authentification.
La fonction _AuthenthificationProcess()_ dans le fichier _/lib/functions_auth.php_ déclare l'événement *authentication.main_authentication* :
<pre>
<code class="php">
function AuthenthificationProcess($login, $pass, $type)
{
// Notify the beginning of the current method
global $dispatcher;
$dispatcher->notify(new sfEvent(__FUNCTION__, 'authentication.main_authentication', array('login' => $login, 'password' => $pass, 'type' => $type)));
// .....
// Processus d'authentification
}
</code>
</pre>
Le fichier __init__.php du nouveau plugin devra contenir les instructions suivantes :
<pre>
<code class="php">
// Log de l'authentification dans [path to app]/tmp
function logAction(sfEvent $event) {
$a[0]= $event['login']. " s'est authentifé le ".date('d/n/Y à H:i:s')." depuis ". $event['type'];
logfile(SITE_PATH.'/tmp/auth.log', $a);
}
// Execute la fonction logAction lorsque l'événement authentication.main_authentication est notifié
$dispatcher->connect('authentication.main_authentication', 'logAction');
</code>
</pre>
Votre plugin est terminé! Chaque fois qu'un utilisateur s'authentifiera, le fichier _auth.log_ sera renseigné.
h2. Ajout d'une méthode grâce à la fonction magique __call()
La fonction magique __call() permet de traiter les méthodes non déclarées dans la classe. Couplée avec le motif de conception observeur/observable, elle va nous permettre d'étendre la classe.
Remarque : L'événement créé par Linea21 se nomme *[nom_de_la_class].extensible_function*.
A titre d'illustration, voici un exemple Exemple d'implémentation sur le module News (qui gère l'actualité) :
<pre><code class="php">
/**
*** news::CheckDataIntegrity()
*** Vérification intégrité des données
*** @access public
*** @param array $table : contient les composants Nécessaires d'une news
*** @return boolean true
*** si verifié, sinon string 'message d'erreur'
*/
public function __call($method, $arguments) CheckDataIntegrity($table)
{
$event = $this->dispatcher->notifyUntil(new new sfEvent($this, 'news.extensible_function', array(
'method' => $method,
'arguments' => $arguments 'news.before_data_check');
))); $this->dispatcher->filter($event, $table);
$table = $event->getReturnValue();
if (strlen($tabler0) < 3) return _t('news','no_title');
if (!$event->isProcessed()) (strlen($tabler1) < 3) return _t('news','no_header');
{
throw new Exception(sprintf('Call to undefined method %s::%s.', get_class($this), $method)); if (strlen($tabler2) < 3) return _t('news','no_body');
} if ($tabler3 <= 0 || !is_numeric($tabler3)) return _t('news','no_theme');
if ($tabler4 <= 0 || !is_numeric($tabler4)) return _t('news','no_scale');
if ($tabler6 <= 0 || !is_numeric($tabler6)) return _t('news','no_template');
return $event->getReturnValue(); true;
}
</code>
</pre>
Dans le <code>__init__.php</code> de mon plugin :
<pre><code class="php">
// 1 -Création de la classe extensibleNews() et ajout des méthodes
class extensibleNews global $dispatcher;
{
static public global $plug;
function listenToMethodNotFound(sfEvent $event)
NewsRemoveTitle(sfEvent $event, $a)
{
switch ($event['method'])
{
case 'performAction':
self::doTest($event->getSubject(), $event['arguments']);
return true;
default:
return false;
}
}
static private function performAction($subject, $arguments)
{
if(is_string($arguments)) $msg
$ar[0] = $arguments;
if(is_array($arguments)) $msg = join(', ', $arguments);
mail('info@xxxx.com', 'extension de Linea21', 'Voici les arguments passés à ma fonction ''; // Exemple : '. $msg);
_debug('[event/dispatcher] (INTERNAL) - we run ' . __FUNCTION__ . '() function by extensibleFunc() call with arguments : '. $msg);
}
}
on supprime le titre. Cela doit lever une erreur
return $a; // 2 - On connecte l'événement en précisant la classe et la méthode à appeler renvoie le résultat de l'opération
$dispatcher->connect('news.extensible_function', array('extensibleNews', 'listenToMethodNotFound')); }
$dispatcher->connect('news.before_data_check', 'FilterTestLinea21'); // 3 - Enfin, on appelle la nouvelle méthode depuis l'objet news connexion de l'évenement
// ici après un test conditionnel pour exécuter l'action sur la section 'news' seulement
if(isset($_REQUEST['rub']) && $_REQUEST['rub'] == 'news') {
include_once '../class/class.news.php';
$n = new news;
$n->performAction('arg 1', 'arg 2', 'arg 3');
}
</code>
</pre>