Le Temple du Argh tout puissant

Traduction du billet It's here! patTemplate 3.0.0 stable released de php-tools:

Stéphane a publié la première version stable de patTemplate, notre librairie de templates. Comlètement reprogrammé pour la version 3, patTemplate a aussi vu des chamgements au niveau de son architecture. Voivi une liste non ehaustive des fonctionalités actuelles:

• basé sur des balises XML
• Architecture très flexible
• Lecteurs interchangeables: lire à partir de fichiers, de variables, d'autres formats de template
• Filtrage de données entrantes
• Filtrage de données sortantes
• Modificateurs de variables
• Asiément extensible en liant des objets PHP à des balises
• Accepte des chaînes de caractere, des tableaux et des objets
• Templates avec des conditions spéciales (impair, pair, premier ou dernière répétition)

Pour une liste complète des fonctionnalités, vous pouvez regarder les exemples en ligne, ou le blog de php-tools. Toujours pas convaincu? Peut-être qu ce petit bout d'information va vous convaincre: patTemplate a éte adopté par le CMS Mambo pour la prochaine version majeure.

Et pour télécharger, c'est sur notre site, ou pour être à la pointe du développement et se faire quelques frissons, il y aussi les instantanés CVS.

Traduction du billet Services_Ebay 0.8.0 released de php-tools:

Stéphane a publié une nouvelle version de sa librairie Services_Ebay dans PEAR, avec un changement en alpha comme l'interface commence à être plus stable. Cette version inclut quelques fonctionalités intéressantes: Services_Ebay offre maintenant une sorte d'introspection en permettant d'accéder a une liste de toutes les fonctions de l'interface en utilisant Services_Ebay::getAvailableCalls(). De plus, il est maintenant possible de changer 'identiofiant de site (siteId), ce qui veut dire que la librairie n'est plus limitée à ebay.com. Pour aider dans le débogage d'une application utilisant Services_Ebay, et aider Stéphane à analyser les bogues, il est aussi possible de capturer les donées XML brutes envoyées et reçues par le WebService d'Ebay.

Mais la fonctionalité la plus intéressante, c'est surtout les modèles sur mesure, une idée partie du Power Workshop de Toby et Lukas. Ils utilisaient Services_Ebay en conjonction avec d'autres librairies de PEAR, mais voulaient enregistrer des données supplémentaires pour les articles dans une base de données. Pour y arriver, ils ont crée un object qui contenait une référence à un objet du type Services_Ebay_Model_Item, ainsi que les données additionnelles à enregistrer. Ca marchait, mais ça n'était pas très joli et peut vite devenir bordellique.

Pour arriver au même résultat, il est maintenant possible de créer des modèles sur mesure pour remplacer ceux offerts par Services_Ebay - donc, de créer des classes pour les utilisateurs, articles, contacts, etc. Les données requises seront automatiquement enregistrées par Services_Ebay. Voilà un petit exemple comment on peut y arriver:

<?php;
require_once 'Services/Ebay.php';

// classe sur mesure très simple
class myItem extends Services_Ebay_Model_Item
{
// méthode exemple - tout est possible ici...
public function StoreItem()
{
echo "Vous pourriez par ex. enregistrer les données dans une base de données ici...";
}
}

Services_Ebay::useModelClass('Item', 'myItem');

$session = Services_Ebay::getSession($devId, $appId, $certId);
$session->setToken($token);
$ebay = new Services_Ebay($session);

$item = $ebay->GetItem('4501296414');
$item->StoreItem();
?>
C'est super simple et permet d'ajouter toutes les fonctionnalités dont vous pouvez avoir besoin sans encapsuler des méthodes ou de dupliquer du code.

Traduction du billet 'Data filters for patForms' de php-tools:

Inspiré par les commentaires de Helgi sur patForms, Stéphane a commencé une nouvelle approche des filtres de données.

Les filtres de données de patForms sont bien plus puissants que les filtres dans d'autres outils comme QuickForm, par ex - et voici pourquoi:

• Les filtres fonctionnent dans deux sens: il est par ex. possible d'enregistrer une durée en secondes dans une base de données, mais de permettre l'utilisateur d'entrer la durée en heures en utilisant un filtre de multiplication.
• Les filtres peuvent être appliqués avant que les données du formulaire ne soient validés: nous les appelons des filtres HTTP, comme ils se trouvent entre le navigateur et patForms.
• Les filtres peuvent être appliqués après que les données du formaulaire aient été validées: nous les appelons des filtres PHP comme ils se trouvent entre patForms et l'application.

Parcontre, l'utilisation de ces filtres est quand-même plus hardue que les filtres de QuickForm, comme chaque filtre (indépendamment de sa réelle complexité) est un objet et doit être instancé avant d'être utilisable. On se retrouvait donc avec quelque-chose comme-ça:
<?php
// instancer le filtre
$filter =& patForms::createFilter( 'Trim' );

// accéder à l'élément cible
$el =& $form->getElementByName( 'username' );

// appliquer le filtre à l'élément
$el->applyFilter( $filter );
?>
Helgi s'est plaint que dans la plupart des cas, on ne voudra appliquer que des fonctions PHP natives aux valeurs du formulaire, et que pour ça c'est un peu overkill (p.s. quelqu'un connaît une bonne traduction de overkill?)... Finalement, fidèle à lui-même, Stéphane a trouvé une petite idée qui vaut le détour: il a crée un nouvel objet filtre qui peut appliquer n'importe-quelle fonction native de PHP aux valeurs d'un formulaire. Jusque-là, rien d'extraordinaire - mais avec une nouvelle fonction dans la classe de base d'un élément, il est possible d'instancer et de configurer cet objet avec seulement une ligne de code. Ca réduit le code nécessaire en gardant la flexibilité originelle des filtres:

<?php
// get the element
$el =& $form->getElementByName( 'username' );

// apply an HTTP filter for incoming data
$el->applySimpleFilter('strtolower');
?>
En plus d'une fonction qui filtre les données entrantes, il est possible d'en définir une seconde qui filtrera les données sortantes (vers le navigateur). Bien sûr applySimpleFilter() accepte aussi des méthodes statiques ou méthodes d'objets.