php-tools

Traduction du billet 'php-tools.net relaunch plans' de php-tools:

Nous avons décidé de faire une remise à neuf du site php-tools.net, et aimerions savoir si vous avez des idées comment nous pouvons l'améliorer. Nous savons déjà assez bien ce que nous allons faire, mais vous pouvez encore nous aider. Dites-nous simplement ce qui vous plaisait le moins et le plus sur le site actuel, et quelles fonctions vous manquaient le plus. Envoyez-moi un mail à argh [@] php-tools [.] net avec vous idées / critiques / demandes de fonctionnalités.

Merci d'avance de toute l'équipe!

Traduction du billet 'All new pat channel server' de php-tools:

Depuis que Greg Beaver a inventé la classe PEAR_Server et que Davey Shafik a crée un package très pratique pour mettre en place sa propre interface pour un serveur de canaux PEAR, ça nous démangeait d'en faire un pour pat. Stéphane a installé l'interface sur pear.php-tools.net, et après que mes yeux de designer ont arrêté de saigner en voyant la mise en page par défaut de la bête (@Davey: je sais que ce n'est qu'un exemple ), j'ai fait un petit design pour pat et c'est parti.

Pour l'instant seulement quatre de nos librairies sont disponibles par notre canal, mais nous allons ajouter les autres au fur et à mesure.

Vous pouvez trouver plus d'infos sur PEAR_Server dans le blog de Greg, ainsi que sur l'interface de Davey dans son blog.

Traduction du billet 'New releases of patConfiguration and patTemplate' de php-tools:

Hier Stéphane a publié patTemplate 3.1.0a1, la premiere version alpha de la branche 3.1 de la librairie. Cette version ajoute des dizaines de nouvelles fonctions, et même si elle est encore alpha elle est déjà très stable. Stéphane l'utilise même dans un de ses projets avec près de 400.000 visiteurs par jour.

La version v2.0.0b2 de patConfiguration contient principalement des corrections, et est censée être la dernière version avant la publication de la premiere version estampillée stable.

Si vous utilisez une de ces librairies et ces versions, testez-les et signalez tous les bogues que vous trouvez. Si vous utilisez PEAR 1.4.0, vous pouvez aussi les installer par notre serveur de canaux.

Traduction du billet 'patConfiguration 2.0.0b1 released' de php-tools:

Stéphane a publié la première beta publique de son lecteur de configurations patConfiguration. À partir de cette version, la classe est basée sur des drivers avec une architecture unifiée pour lire les configurations à partir de fichiers XML, INI et WDDX avec la même interface.

Le driver XML est le plus puissant, puisqu'il permet de définier commetn les balises doivent être traitées. Il est ainsi par ex. possible de définir une balise <foo one="1" bar="totmato"/> pour qu'elle soit automatiquement convertie en tableau avec les attributs comme clés et valeurs. Bien sûr on peut aussi choisir pour chaque attribut quel type de variable y est stocké pour que les valeurs soient automatiquement convertis en valeurs booléennes, nombres, chaînesde caractère et même des objets.

Pour cela, patConfiguration propose une balise spéciale très simple:

<!-- définir un espace de nom -->
<define ns="boutique">
    <!-- définir une balise dans un espace de nom -->
    <define tag="articles" type="array"/>

    <!-- définir une balise sans nom (tableau indexé) -->
    <define tag="article" name="_none" type="array">
        <!-- définir trois attributs pour cette balise -->
        <define attribute="vendeur" type="string"/>
        <define attribute="titre" type="string"/>
        <define attribute="prix" type="float" default="99.99"/>
    </define>
</define>

Maintenant que les balises sont définies et que patConfiguration sait comment les integréter, on peut les utliser dans la configuration XML:

<boutique:articles>
    <boutique:article titre="Hache médiévale" vendeur="Argh"/>
    <boutique:article titre="Oeuf de dragon" vendeur="Merlin" prix="500"/>
</boutique:articles>

Lire cette configuration à partir d'un fichier est très simple:

<?php
$conf = new patConfiguration(
                            array(
                                'configDir' => './config'
                                )
                            );
// parse config file
$conf->loadConfig('example_define_basic.xml');

$config = $conf->getConfigValue('articles');
?>

Si vous êtes inquiet que le temps que de parser des fichiers XML à chaque requête ralentit votre application, vous pouvez activer le système de cache qui rend le chargement encore plus rapide que de stocker la configuration dans un fichier PHP. Si vous voulez utiliser les définitions des balises dans plusieurs fichiers, vous pouvez utiliser des entités externes ou des balises xInclude - patConfiguration gère les deux, même sous PHP4.

Après chargement avec patConfiguration, voilà le tableau résultant de notre exemple:
Array
(
    [0] => Array
        (
            [vendeur] => Argh
            [titre] => Hache Médiévale
            [prix] => 99.99
         )

    [1] => Array
        (
            [vendeur] => Merlin
            [titre] => Oeuf de dragon
            [prix] => 500
         )
)

patConfiguration permet en outre d'accéder à la configuration complète, ou juste des parties en utilisant une mixture de la syntaxe d'accès aux tableaux dans PHP et de syntaxe de chemins à la JavaScript (boutique.articles[0], par ex.) Pour voir la liste complète des possibilités qu'offre patConfiguration, il y a les exemples en ligne ou vous pouvez télécharger le package entier par notre site.

Si vous utilisez déjà PEAT 1.4.0, vous pouvez aussi l'installer par notre serveur de canaux:
$ pear channel-discover pear.php-tools.net
$ pear install --alldeps pat/patConfiguration

En cas de bogue, utilisez notre patBugzilla.

Traduction du billet 'Welcome to patPortal, Wiegi' de php-tools:

Depuis hier, Daniel a rejoint l'équipe de php-tools. Participant à la traditionnelle soirée programmation chaque mardi, il a d'ailleurs faite une entrée haute en couleurs en contribuant une nouveau filtre de réponse à patPortal. patPortal est un système de création d'applications Web basé sur un ensemble de composantes interconnectées. La grande particularité du projet est le très haut niveau d'abstraction - en effet, on n'accède par ex. jamais directement aux données d'une requête (GET, POST...), seulement par le biais d'un objet de requête. Le grand avantage étant que la même interface peut être utilisée pour des applications basées sur le protocole HTTP, sur des requêtes SOAP ou encore des applications CLI (ligne de commande).

Le même principe s'applique donc aux réponses - toutes les données sortantes de l'application passent par un objet de réponse. Le filtre de réponse de Daniel, StripWhitespace, permet d'enlever les espaces des données sortantes avant qu'elles ne soient envoyées.

Bienvenue donc à Daniel! Vous pouvez le joindre par son adresse wiegi[at]php-tools[dot]net (en anglais, de préférence, vu qu'il est allemand comme tout le reste de l'équipe - sans me compter moi, bien sûr...).

Traduction du billet 'New release of PEAR:: Date_Holidays' de php-tools:

Carsten a publié une nouvelle version de Date_Holidays, la v0.13.0. Cette librairie disponible dans PEAR est spécialisée pour les calculs de jours fériés ou autres jours spéciaux.

Carsten est aussi en train d'écrire un article à ce sujet pour le prochain numéro du International PHP-Magazine, ce qui lui a donné l'idée pour quelques nouvelles fonctionnalités:

• Il a adapté les calculs existants et ajouté un nouveau driver qui calcule les anniversaires des gens qui ont bien voulu nous donner leur date de naissance (voir mon billet précédent à ce sujet).
• Il a ajouté des objects filtre qui permettent de filtrer les dates calculées à l'aide de blacklists, whitelists et filtres composites.

Stéphane a une fois de plus pu contribuer en conseils et relecture de l'article

Pour tous ceux qui ont déjà été confronté au calcul de dates un peu spéciales, cette librairie et l'article à paraître sont un bon point de départ pour se rendre la vie plus facile. D'après le International PHP Magazine, l'article de Carsten sera disponible online un peu après la parution du magazine.

Traduction du billet 'The day you were born ...' de php-tools:

Pour tous ceux d'entre vous qui font partie des développeurs PEAR: Carsten aimerait que vous lui donniez votre date et lieu de naissance pour son projet Date_Holidays. Il est en train de programmer un Driver pour calculer les anniversaires de tous les contributeurs de php.net dans le cadre d'un article qu'il écrit pour le magazine PHP international.

Il a besoin de votre:

- nom
- date de naissance
- pays

Envoyez-lui un email avec ces informations à l'adresse suivante: luckec -at- php -dot- net. Merci d'avance!

Traduction du billet 'Services_Ebay 0.11.0 released' de php-tools:

Stéphane a publié une nouvelle version de Services_Ebay, avec deux nouvelles fonctionnalités et plusieurs méthodes. La première fonctionnalité est le système de cache des réponses du WebService d'eBay: intégré dans les modèles de classes de Services_Ebay, ceci permet de mettre les réponses des requêtes faites à eBay dans un cache local pour éviter les temps de transfert souvent assez longs de ces requêtes.

L'utilisation du cache est très simple:

<?php
$session = Services_Ebay::getSession($devId, $appId, $certId);
$session->setToken($token);

// choisir le cache local sous forme de fichiers
$userCache = Services_Ebay::loadCache('Filesystem', array('path' => './cache'));

// le fichier cache expirera après 15 minutes
$userCache->setExpiry('Static', 15);

// utiliser ce cache pour tous les modèles utilisateur
Services_Ebay_Model_User::setCache($userCache);

// charger un modèle d'utilisateur
$user = Services_Ebay::loadModel('User', 'superman-74', $session);

if ($user->isCached()) {
echo 'donées dans le cache';
print_r($user->toArray());
} else {
echo 'requête des donées online';
$user->Get();

print_r($user->toArray());
}
?>

Après avoir instancié un nouveau cache, on définit la durée de validité des données enregistrées. Pour l'instant, il est seulement possible de définir une durée fixe, mais comme les vérifications de durée sont des objets, il est facile d'en ajouter d'autres. Stéphane compte ajouter un objet de vérifiaction de validité qui diminuera automatiquement la durée du cache plus la fin de l'enchère approche. Il pense aussi ajouter un cache qui enregistre les données dans une base de données au lieu de fichiers, pour permettre un stockage plus flexible.

La deuxième fonctionnalité (avec un peu d'aide du fabuleux Adam Trachtenberg) est l'implémentation de la recherche de produits. Disponible sur eBay sous forme de fomrulaires permettant de rechercher des produits par une série de critères de recherche, Services_Ebay permet maintenant d'y accéder de manière très simple. eBay offre deux manières d'y accéder:

• par GetProductFinder, qui livre du XML contentant les informations nécessaires sous forme brute (champs de formulaire et valeurs pour la catégorie de produits choisie)
• pat getProductFinderXSL qui livre la feuille de style XSL qu'eBay utilise pour le rendu du HTML à partir des données XML brutes.

Comme l'accès à ces données se fait par un modèle dans Services_Ebay, il est tres simple d'y accéder:

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

// charger la feuille de style (enregistrée localement, ce serait trop
// long de la charger a chaque fois)
$xsl = file_get_contents('product_finder.xsl');

// charger la recherche de produits et l'afficher
list($productFinder) = $ebay->GetProductFinder(1909);
echo $productFinder->render($xsl);
}
?>
Ce petit bout de code affiche un formulaire incluant un peu de javascript, permettant à l'utilisateur de choisir ses produits à partir des critères disponibles.

Cette nouvelle version est aussi la première publication incluant des parties contribuées par Carsten Lucke. Carsten a ajouté des méthodes spécifiques pour les enchères et utilisateurs Néerlandais, ainsi que les modèles nécessaires.

Traduction du billet 'Tutorial for Services_Ebay' de php-tools:

Adam Trachtenberg, responsable technique chez eBay, a écrit un tutoriel d'introduction à Services_Ebay, la librairie d'accès aux WebServices d'eBay écrite par Stéphane.

Bien que relativement court, ce tutoriel aborde des aspects intéressants de la librairie en montrant les possibilités qu'offre la surcharge ('overloading' en anglais) d'objets. Il montre aussi comment définir ses propres modèles en les utilisant comme couche de présentation avec la méthode __toString().

Pour démarrer avec Services_Ebay, ce tutoriel est une bonne référence.

Traduction du billet 'International PHP 2005 Conference - Spring Edition' de php-tools:

Stéphane va tenir deux séances à la Conférence Internationale PHP de cette année qui se tiendra à Amsterdam:

1. Go OO! - Real-life patterns in PHP5
   Cette séance montrera comment on peut utiliser les nouvelles possibilités de programmation orientée objet avec PHP5, ainsi que les interfaces de la nouvelle librairie SPL.
2. Component and event-driven architectures in PHP5
   Cette séance montrera des nouveaux concepts de programmation évenementielle pour rendre vos applications plus flexibles par l'ajout d'une gestion d'évènements.

Stéphane fera aussi un 'Power Workshop' d'une journée intitulé 'XML and Web services with PHP5 and PEAR' avec Tobias Schlitt, et qui approfondira l'utilisation de WebServices avec PHP et les librairies disponibles dans PEAR.

Traduction du billet 'PEAR is getting event support' de php-tools:

Bertrand Mansion (en) a proposé une nouvelle librairie pour inclusion dans PEAR, Event_Dispatcher (en). Celle-ci offre une gestion simple d'évènements facile à intégrer dans une application PHP. Bertrand a déjà démarré l'appel au vote (en), mais comme nous utilisons déjà cette technique dans patPortal (en), et Stéphane dans son boulot chez 1et1 allemagne (de), il l'a essayé:

L'architecture de la librairie est assez simple: la classe Event_Dispatcher peut contenir des observateurs (appels natifs PHP) pour divers types de notifications. Ces observateurs sont informés de chaque évènement par une notification sous la forme d'un objet (la notification) très simple qui contient des informations sur l'évènement. Dans la vie de tous les jours, cette technique permet d'ajouter des fonctionalités à une application existante sans avoir à modifier le code source. Dans le site de 1et1 dont s'occupe Stéphane, il envoie une notification à chaque commande (évènement onOrder) en y ajoutant l'objet gérant la commande comme information. De cette manière, il est facile d'intégrer nombre d'objects pour par ex. écrire des logs, mettre à jour des cookies ou d'envoyer des suivis à des partenaires affiliés.

L'architecture simple de Event_Dispatcher est un atout, mais on arrive vite à des limites - dans ses essais, Stéphane a trouvé quelques lacunes. La première chose est qu'un observateur ne peut pas annuler (arrêter) un évènement: cela permettrait par ex. d'ajouter une ultime vérification avant que la commande d'un client ne soit envoyée, et d'annuler la commande le cas échéant. La deuxième chose est que la remontée d'évènements ('event bubbling' en anglais) n'est pas possible: cela permettrait des niveaux illimités de gestion dévènements, chaque évènement pouvant remonter toute la hiérarchie des observateurs. Enfin, il n'est pas possible de définir une classe sur mesure pour les notifications (ce qui peut être nécessaire selon le type d'informations qu'on veut y stocker).

Stéphane a implémenté toutes ces fonctionnalités dans le code de Bertrand, en espérant qu'il voudra bien inclure ces changements dans la version officielle de Event_Dispatcher lors de sa publication (si elle est acceptée par la communauté des développeurs de PEAR... votez!).

Traduction du billet 'HTTP_SessionServer 0.4.0 available' de php-tools:

Stéphane (de) vient de publier une nouvelle version de sa librairie HTTP_SessionServer (en), un serveur de session qui permet de stocker des paires clé/valeur et communique avec n'importe-quel type de client avec un protocole très simple. À part quelques petits changements purement cosmétiques, cette version (en) a aussi un nouveau module de stockage contribué par Carsten Lucke (en). Ce module enregistre les données de session dans une base de données en utilisant la librairie d'abstraction DB de PEAR.

Pour démarrer avec HTTP_SessionServer, le mieux est pour l'instant la présentation (en) que Stéphane a faite à la conférence PHP de Frankfort l'année dernière. Mais non, pas 2003 - 2004! je dis ça parce-qu'il y en a qui n'ont pas encore imprimé que le champagne, la teuf jusqu'à tôt le lendemain et les bises à minuit c'était justement pour que ça ne passe pas inaperçu...

Traduction du billet 'New release of PEAR-Date_Holidays' de php-tools:

Stéphane a publié une nouvelle version de la librairie PEAR-Date_Holidays (en), la v0.12.0. Nouveau avec cette version: des nouvelles langues - allemand pour USA-Holidays et italien pour Christian holidays, et la méthode getHolidayForDate() a été améliorée grâce à un très bon patch de Lorenzo (en), qui la rend beaucoup plus rapide.

Date_Holidays est une librairie qui permet de gérer des dates spéciales comme les vacances ou jours fériés de maniere transparente. Elle a été créee par Carsten (en), à qui je fais un petit clin d'oeil en passant

Traduction du billet 'New versions of XML_Parser and XML_Serializer released' de php-tools:

Stéphane a publié une nouvelle version de deux de ses librairies PEAR: XML_Parser 1.2.2 et XML_Serializer 0.14.0. Tandis que la nouvelle version du XML_Parser ne corrige que deux bogues, la nouvelle version du XML_Serializer ajoute de nouvelles fonctions bien pratiques:

1. En séparant les agents SAX de la librairie XML_Parser (ce qui est possible depuis la version 1.2.0), il est maintenant possible de définir l'encodage du document source et du document cible. Cela permet par ex. de lire des fichiers encodés en UTF-8 et de les convertir en ISO-8859-1.
2. La nouvelle option 'encodeFunction' permet de définir une fonction PHP ou une méthode d'un objet qui sera utilisée pour toutes les données et attributs avant qu'ils ne soient ajoutés au document XML. Il est ainsi possible, par ex. d'encoder vos données en UTF-8 avant de créer le document XML. Comme le XML_Unserializer propose les fonctions de décodage correspondantes, cette option permet aussi d'encrypter et de décrypter des documents XML de manière tout à fait transparente.

Stéphane a ajouté ces deux nouvelles fonctions comme il travaille en ce moment sur sa librairie Services_Ebay - et Ebay ne travaille qu'avec des documents XML encodés en UTF-8. Cependant, il est vrai que ces fonctions peuvent permettre de gagner du temps de développement dans bien des cas.

Traduction du billet 'Two new articles published' de php-tools:

La semaine dernière, deux nouveaux articles de Stéphane sont parus: le premier est une introduction à XUL, publié dans le numéro 1.05 du magazine allemand "Java Magazin". Le XUL est un langage de type XML qui permet de modeler des interfaces utilisateur pour Mozilla. Si le sujet vous intéresse, et que vous avez encore un petit peu de mal avec l'allemand (c'est facile, pourtant ), Stéphane a aussi publié une librairie dans PEAR, XML_XUL, avec laquelle on peut créer des applications XUL chez soi avec PHP. Même sans l'article, il y a une série d'exemples fournis avec qui permettent de débuter facilement.

Le second article est sur la librairie XML_Serializer de Stéphane, publié dans le dernier numéro du International PHP Magazine. Le XML_Serializer est une librairie très puissante qui permet de sérialiser presque n'importe-quelle structure PHP en XML et inversement. Un bon exemple est qu'on peut sérialiser un objet complet en XML, et le récupérer tel quel plus tard - ou l'utiliser tout simplement pour lire n'importe-quel document XML sans avoir à le parser soi-même.

Dans ma fanpage pour le jeu Etherlords, les Ether Planes, j'ai utilisé le XML_Serializer pour lire les données des cartes, qui étaient entièrement en XML. Le petit bout de code ci-dessous faisait la plupart du boulot:

// inclure le Unserializer
include_once( 'XML/Unserializer.php' );

// créer l'objet - on veut aussi avoir les attributs
// des balises, donc on définit l'option au démarrage
$unserializer = new XML_Unserializer( array( 'parseAttributes' => true ) );

// désérialisation des données XML
$unserializer->unserialize( 'maps/etherlords.xml', true );

// et voilà un joli tableau contenant les données
// du ficher XML. Simple, non?
$data = $unserializer->getUnserializedData();

Le XML_Serializer a aussi une interface SimpleXML, qui permet d'accéder aux données XML un peu comme avec la nouvelle extension PHP (dans certaines limites, bien sûr, vu que certaines choses ne sont pas possibles avec PHP4) - j'adore cette librairie, vu que je ne fais pas partie de ces gens qui adorent écrire des parseurs XML