Génération de flux RSS en PHP

21 08 2007

RSSRSS pour Really Simple Syndication, est une des récentes technologies qui popularisent le web 2.0. Le format RSS est un flux de données XML regroupant diverses informations sur des ressources accessiblent depuis le réseau.

Dans le cas d’un site d’actualités, les flux RSS du site regrouperont les nouveaux articles publiés et les commentaires récents qui permettront aux utilisateurs de voir l’évolution du site sans avoir besoin de s’y connecter en permanence.

Générer un flux RSS 2.0 à l’heure actuelle peut rester facile pour n’importe quel développeur. Cependant, générer de multiples flux devient vite une tâche fastidieuse. Jj’ai donc décidé d’écrire un jeu de classes PHP, pour me simplifier la production de flux de type RSS.

Un exemple concret de construction de flux à partir de ces classes vous montrera la marche à suivre. Notre exemple se base sur le listage d’un répertoire distant, à travers un flux RSS.

<?php

include('myrss.class.php');

$rss = new RSS('Contenu du répertoire', 'http://url.du.repertoire', 'Description du répertoire');

if ($handle = opendir('.')) {
  while (false !== ($file = readdir($handle)))
    if ($file != "." && $file != "..") {
      $file_info = stat($file);
      $desc = is_dir($file) ? 'Dossier créé ' : 'Fichier de '.round(
      $file_info['size'] / (1024 * 1024), 2).' Mo';
      $desc .= strftime('le %A %d/%m/%Y à %H:%M:%S', $file_info['atime']);
      $date = strftime('%D');
      // Remplissage du flux
     $item = new Item($file, 'http://url.du.repertoire/'.$file, $desc, $date);
     $rss->add($item);
    }
  closedir($handle);
}

print $rss->publish();

?>

Et voilà comment en moins de 20 lignes de codes ont contruit notre flux. Le travail du développeur se concentre sur la création des données à afficher, et non sur la gestion du format en lui même.

La création du flux se fait l’instanciation de la classe RSS prenant en paramètres comme indiqué dans l’exemple, un titre, une url, une description, et éventuellement la locale du flux, pratique pour la gestion des dates de publication.

Les éléments constituant le flux, se crées dans la classe Item. Elle se compose aussi d’un titre, d’une url, d’une description, et optionnellement d’une date de création. Une fois l’instance de d’Item créée, on l’ajoute dans notre objet RSS par la méthode add. Une fois tous les éléments ajoutés dans l’objet RSS, on affiche le retour de la méthode publish.

Et voila le tour est joué !
Lire la suite »



Service class design

19 05 2007

PHP.jpgAvant de faire du Python par la force des choses et d’en découvrir la toute puissance.

J’ai commencé la programmation sur le web avec PHP, et me suis particulièrement interessé aux moyens de communication à travers les différentes technologies qui composent internet.

A la suite de plusieurs projets plus ou moins grands, une subtilité m’apparait, peu importe la technologie, du moment que les programmes ont accès aux mêmes ressources, et qu’ils partagent le même langue pour communiquer, il n’y a pas de problèmes.

D’où l’idée de centraliser les tâches à partir d’un même noyau qui sera accessible par n’importe quels types de technologies.

Dans le cas d’un blog, les différents articles qui le composent doivent au minimum pouvoir être créés, édités et supprimés.

Donc si on veut pouvoir faire une interface pour administrer tout cela, disons dans une page, on va rédiger du code pour apporter ces fonctionalités. Maintenant nous voulons pouvoir administrer les articles pour pouvoir les éditer à partir d’un client quelconque. Doit-on une fois de plus recoder ces fonctionnalités ? Non ! Cela serait une énorme perte de temps.

A l’heure du web 2.0 et de la centralisation des données, il est temps de se simplifier la tâche.

La solution proposée est de fournir un service accesible de n’importe où et qui centralisera toutes les actions faites aux articles du blog. L’accès aux ressources se fera donc par HTTP, le minimum je pense.

Ecrire un service qui soit fiable et qui reste souple à l’ajout de fonctionnalités est facilité grâce à la classe Service pour PHP4 présentée ci-dessous. J’ai développé cette classe d’implémentation à partir du modèle MVC pour PHP4 car c’est ce qu’on trouvera le plus en terme de configuration de serveur web. Le Python m’aurait bien tenté, mais bon dommage, le mod_python n’est pas encore disponible partout chez les hébergeurs.

class ServiceImplemented extends Service {
  var $name;

  function ServiceImplemented($action, $parameters=NULL,
                                          $mandatory=NULL) {
    /*
    ** Les variables $parameters et $mandatory sont
    ** respectivement une table de hash contentant les
    ** paramètres nécessaire à l'éxécution de la
    ** méthode servie, et une liste de paramètres
    ** obligatoires pour éxécuter la méthode.
    */


    parent::Service($action, $parameters, $mandatory);
    $this->name = 'toto';
    $this->run();
  }

  function hello() {
    return 'Hello world from : '.$this->name;
  }

}

//Coté serveur on apelle le service requis
$si = ServiceImplemented('hello');
$si->publish();

Le code de la classe est téléchargeable avec une suite de tests pour les utilisateurs de SimpleTest.

Actuellement cette implémentation dans la code source du blog de shao197 permet l’édition de son blog en AJAX et en Python à partir d’un client graphique basé sur wxWidget.