PHPUnit permet de tester nos blocs de code indépendamment les uns des autres. Lors de la création d’un test de fonctionnalité, nous devons donner une valeur à notre fonction. PHPUnit s’assurera que la valeur retournée par la fonction sera la valeur attendue. Plus la fonction sera étendue afin de supporter de nouveaux paramètres, plus les tests nous permettront de nous assurer qu’aucune fonctionnalité précédemment développée ne sera brisée.

Installation

Le mode d’installation à été trouvé sur PHPUnit.de. Il nous permet d’installer la version via les canaux PEAR.

Installer xdebug

Installer PHPUnit

sudo pear channel-discover pear.phpunit.de

sudo pear install –alldeps phpunit/PHPUnit

Une fois que PHPUnit est installé et fonctionnel, vous êtes prêt à créer votre premier test. Idéalement, si vous utilisez une librairie ou un framework, vous voudrez sans doute vouloir configurer vos tests afin que chacun utilise les classes de votre librairie. Pour cela, je vous suggère de vous créer une classe qui servira de « bootstrap » et qui sera appelée avant chaque test.

Voici un exemple de « bootstrap ».

setup.php

class Setup {

public static function init() {

// Root, libraries, classes and tests directories.
$root       = dirname(dirname(__FILE__));
$config     = $root} . ‘/config’;
$librairies = $root . ‘/libraries’;
$tests      = $root . ‘/tests’;

// Empêche le coverage du dossier de tests.
PHPUnit_Util_Filter::addDirectoryToFilter($tests);

// Update include path.
$path = array($config, $librairies, $tests, get_include_path());
set_include_path(implode(PATH_SEPARATOR, $path));

// Add files to the PHPUnit code coverage whitelist.
if (version_compare(PHPUnit_Runner_Version::id(), ’3.1.6′, ‘>=’)) {
PHPUnit_Util_Filter::addDirectoryToWhitelist($starLib);

}

}

Votre classe de test

Blog.php

require_once ‘PHPUnit/Framework.php’;
//require_once dirname(__FILE__) . ‘/setup.php’;

class Blog extends PHPUnit_Framework_TestCase {

public function test_failed() {

$this->assertFalse(true, ‘Ce test ne fonctionne pas’);

}

public function test_success() {

$this->assertTrue(true, ‘Ce test fonctionne’);

}

}

Une fois ces étapes réalisées, vous n’avez qu’à exécuter le fichier Blog.php pour obtenir ce résultat:

phpunit –colors Blog.php

Pour plus d’informations sur l’utilisation de PHPUnit, voir sur le site .

Bon test !

C’est la raison pour laquelle j’ai décidé aujourd’hui, de vous parler d’une astuce que j’ai appris il y a de cela quelques mois. Les logiciels libres c’est avant tout un partage de connaissances!

Flexform et itemsProcFunc

Récemment, j’ai dû développer une extension qui liste des enregistrements provenant du DAM (Digital Assets Management). Très simple me diriez-vous? C’est vrai lorsque nous sommes seul à gérer un site. La plupart du temps, les sites web et les intranets que nous développons pour nos clients sont beaucoup plus complexes que ça. Ils impliquent un grand nombre d’intervenants (utilisateurs back-end BE) et un grand nombre de rôles et de permissions (groupes back-end BE). Le choix des enregistrements dans le formulaire back-end créé grâce à un « flexform » dépend donc des permissions accordées à l’utilisateur BE courant et aux groupes auxquels ce dernier appartient.

Supposons par exemple que notre utilisateur BE appartienne à un groupe BE qui a pour « filemount » un dossier bien précis. Il ne faudrait pas dans ce cas, lui afficher des enregistrements du DAM qui ne sont pas inclus dans ce dossier.

Exemple :

Un champ de type select dans un flexform

<config>
  <type>select</type>
  <foreign_table>table</foreign_table>
  <foreign_table_where>
      AND table.champ_1 = x  AND table.champ_2 = y
      AND table.deleted = 0 AND table.hidden = 0
      ORDER BY table.champ_3 ASC
  </foreign_table_where>
</config>

Dans un flexform, nous pouvons utiliser un « select » avec un « foreign_table » et faire des requêtes simples avec « foreign_table_where » comme dans l’exemple ci-haut. Par contre, la tâche devient plus ardue lorsqu’on arrive au point où il faut jouer dans plusieurs tables de la base de données et chercher dans des relations stockées dans un champ grâce à des indentifiants séparés par des virgules.  Heureusement que TYPO3 est assez flexible pour nous permettre de tout configurer selon nos besoins. Dans le « flexform » nous pouvons utiliser « itemsProcFunc », qui nous permet d’aller chercher les items de notre « select » dans une userfunc.

Dans la classe user_maclass, il suffit d’avoir une fonction addElements qui nous permettra de faire les requêtes les plus complexes possibles. Cette fonction peut recevoir deux variables par référence : &$config et &$ref. La première contient toute la configuration du champ du flexform en question. On pourra alors accéder à la valeur du paramètre « exemple » dans $config['config']['exemple']. Nous pouvons aussi modifier les valeurs dynamiquement, seulement en les attribuant à la variable : $config['items'] = array_merge($config['items'],$optionList);.

Flexform :

 <config>
  <type>select</type>
  <itemsProcFunc>user_maclass->addElement</itemsProcFunc>
  <exemple>valeur</exemple>
</config>

class PHP :

 class user_maclass {        
   function addElement(&$config) {
      $optionList = $this->getList($config);
      if(is_array($optionList)){	    
         $config['items'] = array_merge($config['items'],$optionList);
      }	    
   }
}

Attention – la class class.user_maclass.php doit être incluse par le fichier ext_tables.php de la façon suivante :

include_once(t3lib_extMgm::extPath($_EXTKEY).'class.user_maclass.php');

Pour accéder aux données de l’utilisateur BE courant, nous avons la variable globale $BE_USER.

Exemple :

global $BE_USER;

if(!$BE_USER->isAdmin()){        
   //Récuperer les usergroup de l'utilisateur actuel    
   $ug = $BE_USER->user['usergroup'];    
   $arrug = explode(',',$ug);
}

On pourra toujours affirmer que TYPO3 est difficile à apprendre, du moins, pour les développeurs et non pas pour l’utilisateur final. Mais personne ne peut nier la force et la flexibilité de ce SGC.

       Ça vous dit quelque chose?

Dernièrement, j’ai tenté de mettre du code en production. C’est alors que ces caractères plutôt étranges sont apparus dans le haut de ma page. J’ai d’abord pensé que c’était un problème d’encodage. Je me suis donc mis à la recherche d’un saut de ligne ou d’un autre caractère qui pouvait être rendu avant le doctype. Il m’a fallu bien peu de temps pour me rendre compte que ces recherches ne règleraient en rien mon problème. J’ai donc regardé l’encodage des fichiers sur le serveur afin de les comparer avec l’encodage de la page dans Firefox. Mon constat : les deux étaient identiques, soit UTF-8.

J’ai alors eu l’idée d’utiliser le « valideur W3C»  afin de vérifier s’il n’y avait pas d’autres problèmes sur la page en question. À ma grande surprise, cette note est apparue:

Byte-Order Mark found in UTF-8 File

Le Byte-Order Mark permet aux programmes de comprendre que le texte est en UTF-8, UTF-16 ou UTF-32. Le BOM est un espace insécable de largeur nulle zero-width no-break space. Certains encodages tel que UTF-16 ont besoin des BOM pour bien fonctionner. Pour ce qui est de UTF-8, il n’est pas nécessaire et est plutôt mal supporté par les IDE. Par contre, certains programmes peuvent l’ajouter pour diverses raisons. Puisque les BOM ne sont pas visibles, nous sommes incapables de les remplacer avec un « search/replace ».

On peut corriger ce problème en utilisant un éditeur qui permet d’enregistrer un fichier dans un encodage sans BOM. En faisant quelques recherches sur le net, j’ai trouvé que Notepad++ nous offre cette possibilité. Dans l’éditeur, cliquez sur l’option UTF-8 without BOM dans le menu Encoding. Il ne vous restera qu’à sauvegarder votre fichier pour que le caractère ne s’affiche plus sur la page.

Voilà donc une bonne raison pour laquelle il vaut mieux utiliser des éditeurs standards pour tous les développeurs afin qu’aucun problème causé par une personne ne surgisse et bloque tous les autres développeurs.

Donc je me suis dit qu’il serait surement intéressant de faire le tour et de lister les grosses entreprises qui utilisent le CMS TYPO3 pour gérer leur site Web.

Et voici ce que ça donne! TYPO3 est utilisé par de nombreuses références prestigieuses telles CISCO, l’UNICEF, Air France-KML, The Economist, Total, EDS, Epson, BAYER, Ford, UNESCO, Audi, Philips, Handicap International ou encore Bonjour Québec… Vous en trouverez ici 51 des meilleures.

Bien entendu, nous n’avons pu valider que les sites Web. Il fut en effet impossible de vérifier si 3M, American Express et MGM Home Entertainment utilisent TYPO3 sur leurs intranets, tel que c’est mentionné sur le site TYPO3.com.

Mise à jour: EDS a été ajouté à la liste (il remplace http://performance-publique.gouv.fr).

CISCO WebEx

CISCO Systems utilise TYPO3 dans plusieurs sites Web corporatifs internationnaux. Il est notamment utilisé pour le site Internet de WebEx (N°1 mondial des services de téléconférence sur le Net). http://www.webex.com

EPSON

EPSON utilise TYPO3 dans de très nombreux sites corporatifs tels http://www.epson.ch et http://www.epson.at/…

UNICEF

Site Internet de l’UNICEF Allemagne: http://www.unicef.de/.

Site Internet de The Economist: http://ads.economist.com/

BAYER TECHNOLOGIES SERVICES – GmbH

Bayer Technology Services GmbH, est une entreprise de Bayer AG: http://www.bayertechnology.com

BRITA

BRITA est le N°1 mondial de la filtration de l’eau. BRITA utilise TYPO3 pour ses sites Web corporatifs internationaux: http://www.brita.com

AIR FRANCE CORPORATE

Le groupe Air France-KLM est la première entreprise mondiale en terme de trafic international de passagers, le deuxième groupe mondial pour l’activité cargo. Le groupe Air France-KML utilise TYPO3 pour son site corporatif: http://corporate.airfrance.com

TOTAL LUBRIFIANTS

Total utilise TYPO3 pour son site Web http://www.total-lubrifiants.ca

BONJOUR QUÉBEC

Bonjour Québec est le portail touristique officiel du Québec. Bonjour Québec est développé en TYPO3: http://www.bonjourquebec.com

FORD

FORD a choisi que son intranet soit développé en TYPO3: http://www.fordintern.info/

KONICA MINOLTA

Le groupe KONICA MINOLTA utilise TYPO3 pour de nombreux sites Web corporatifs tels son site européen (http://www.konicaminolta.eu/), son site Web pour le support technique (http://www.konicaminoltasupport.com/) et son site corporatif allemand (http://www.konicaminolta.de/).

CDC FAST

CDC FAST est une filiale de la Caisse des dépôts et consignations (banque de l’état français créée en 1816). CDC FAST (Fournisseur d’Accès Sécurisé Transactionnel) a choisi TYPO3 pour son site Web corporatif (http://www.cdcfast.fr).

UNESCO

L’UNESCO Bangkok utilise TYPO3 pour son site Web corporatif (http://www.unescobkk.org/).

Ministère de la Culture, des Communications et de la Condition féminine (Québec)

Le Ministère de la Culture, des Communications et de la Condition féminine (MCCCF) du Québec utilise TYPO3 : http://www.mcccf.gouv.qc.ca/ (réalisation TYPO3 par Infoglobe).

Les Inrockuptibles

Les Inrockuptibles, familièrement appelés Les Inrocks, est un magazine culturel et musical français. Les Inrockuptibles utilise TYPO3 pour son site Web officiel (http://www.lesinrocks.com/).

Dassault Systemes

Dassault Systemes (3DS) est une entreprise française éditeur de logiciels (PLM et 3D) et filiale du Groupe Dassault. Dassault Systemes a commencé d’utiliser TYPO3 en 2003 et l’a depuis déployé dans de très nombreux sites Web (notamment son site corporatif http://www.3ds.com/). L’utilisation de TYPO3 par Dassault Systemes est décrite en détail sur TYPO3.com

Université Paris Dauphine (France)

L’Université Paris-Dauphine a choisi TYPO3 comme site pour la gestion de son site Web (http://www.dauphine.fr).

Université de Sherbrooke (Québec)

L’Université de Sherbrooke (Québec) utilise TYPO3 pour son site Web (http://www.usherbrooke.ca/) et de nombreux autres sites internes et externes.

Tournez la page pour voir la suite…

Il s’agit probablement en effet de l’extension la plus mature pour le moment pour créer des formulaires frontend. L’extension possède une solide librairie de fonctions pour créer toutes les sortes de contrôles habituelles et plus encore.

Les formulaires comme telles sont créer à partir d’un fichier XML. Des validations et de l’Ajax peuvent être ajoutés pour chacun des contrôles définis. Il est aussi possible d’appliquer du PHP directemet dans le formulaire pour les valeurs par défaut ou les valeurs courantes.

Quelques contrôles existent en plus des contrôles de bases (text, textarea, button, etc.) :

• Date : pour afficher un élément texte avec un petit calendrier pour sélectionner la date désirée.
• Sélecteur (chooser) : pour afficher plusieurs liens en même temps pour effectuer une sélection.
• Listeur (lister) : pour afficher une liste d’enregistrement avec plusieurs colonnes (permet l’édition à même cette liste).

Ce qui est bien avec ce framework est que c’est nous qui décidons le niveau de contrôle que nous donnons à l’extension. Par exemple, dans mon cas, j’ai fais la validation quand même en PHP parce que je voulais la faire à partir d’un tableau typoscript plutôt que dans le fichier XML. Donc on est jamais pris au dépourvu par une fonctionnalité manquante.

FORMidable sur le wiki de TYPO3 : http://wiki.typo3.org/index.php/Formidable

Site officiel de FORMidable : http://formidable.typo3.ug/

La librairie est très facile d’utilisation, il suffit d’inclure la librairie dans notre code (include) et créer un objet PHPlot (new PHPlot). Par la suite, une image sera généré avec un graphique et une légende au besoin.

PHPlot nécessite au moins PHP 4.3.0 et l’extension GD (qui vient maintenant par défaut avec les dernières versions de PHP).

Plusieurs types de graphiques peuvent être générés à l’aide de cette librairie et chacun de ces types peut être aisément configuré :

• Diagramme avec une ligne simple
• Histogramme
• Diagramme en pointe de tarte
• Nuage de points
• Diagramme en bâton

Voici un exemple d’utilisation à l’intérieur d’une extension TYPO3 :

include(t3lib_extMgm::extPath('nom_extension') . '/include/phplot/phplot.php');

$dataStat = array(
  array('', 1800,   5), array('', 1810,   7), array('', 1820,  10),
  array('', 1830,  13), array('', 1840,  17), array('', 1850,  23),
  array('', 1860,  31), array('', 1870,  39), array('', 1880,  50),
  array('', 1890,  63), array('', 1900,  76), array('', 1910,  92),
  array('', 1920, 106), array('', 1930, 123), array('', 1940, 132),
);

$filenameGraph = "uploads/tx_nomextension/graph_".rand().".png";

$graph = new PHPlot(500, 400);
$graph->SetImageBorderType('plain');
$graph->SetOutputFile($filenameGraph);
$graph->SetPrintImage(0);
$graph->SetPlotType('bars');
$graph->SetDataType('text-data');
$graph->SetDataValues($dataStat);
$graph->SetTitle('Titre du graphique');
$graph->SetPlotAreaWorld(NULL, 0, NULL, NULL);
$graph->DrawGraph();
$graph->PrintImage();

echo '<img src="' . $filenameGraph . '" />';

Nous pouvons trouver la documentation complète ici : http://phplot.sourceforge.net/phplotdocs/

Et le télécharger gratuitement ici : http://sourceforge.net/projects/phplot

Xdebug est un extension php qui vous permet d’afficher des informations de déboguage comme les erreurs d’un script, les traces de fonctions et de la « stack » directement dans votre navigateur. Mais les fonctionnalités de l’extension de s’arrête pas la. En effet, lorsqu’il est jumelé avec un IDE, il vous permet d’utiliser les fonctions de pas-à-pas et de breakpoint. Avec cet outil, vous pouvez profiler votre code et obtenir des statistiques de performance sur l’utilisation de vos fonctions.

L’installation sur Ubuntu est assez simple. Vous devez premièrement installer deux paquets avant de pouvoir débuter l’installation. Tapez dans une console la commande suivante:

sudo apt-get install php-pear php5-dev

Ensuite vous devez utiliser PECL pour rapatrier et compiler les sources avec la commande suivante.

sudo pecl install xdebug

Une fois le traitment terminé, copier la ligne vous montrant l’emplacement de l’installation de l’extention et modifiez votre fichier de configuration php.

sudo vi /etc/php5/apache2/php.ini

Ajoutez les lignes suivantes:

zend_extension=/usr/lib/php5/20060613+lfs/xdebug.so
xdebug.remote_enable=on

Enregistrez les modifications et redémarrez votre serveur apache. Voilà

Eclipse et Netbeans sont deux IDE open source qui vous offre de nombreuses fonctionnalités comme la gestion de projets, le déboguage, l’accès à SVN, ainsi que des outils de collaboration.

Que vous soyez débutant ou expert, l’autocompletion est un outil qui peut vous être très utile. En ajoutant à votre IDE les sources de TYPO3 dans «l’include path» de votre projet, vous pouvez consulter rapidement la liste de fonctions de l’API de développement de TYPO3. L’autocompletion de code vous permettra de développer vos applications plus efficacement.

Exemple avec Netbeans

La propriété « postUserFunc » du stdWrap sert exactement à cet effet.

Il suffit d’appeler un script PHP préalablement défini et d’appeler la fonction de celui-ci tout en y passant quelques paramètres au besoin.

Voici un exemple d’utilisation :

includeLibs.nomLib = fileadmin/templates/scripts/scriptPHP.php
 tt_content.cheminDuStdWrap.stdWrap {
 postUserFunc = nomDeLaClasse->nomDeLaFonction
}