Pour utiliser LESS sur vos sites internet, vous devez « convertir » vos fichiers LESS en CSS afin que les styles soient interprétés par les navigateurs web. Le site officiel propose deux solutions, soit réaliser la conversion côté client avec le navigateur, soit côté serveur avec nodejs. La 1ère solution rend votre site web dépendant l’activation de Javascript par le visiteur, ce qui n’est pas une très bonne idée. J’ai donc choisi la solution « serveur »…

Installation de NodeJS et LESS

Nous allons voir ici comment installer NodeJS et le module less sur Mac OS X 10.6 (et 10.7) avec MacPort. L’installation de MacPort devra préalablement être réalisée.

1. Commencez par installer NodeJS avec MacPort en utilisant la commande suivante :

   port install nodejs

2. Installez maintenant NPM avec la commande ci-dessous. NPM est un gestionnaire de packages/modules pour Node permettant de facilité l’installation de modules.

   sudo port install npm

3. Une fois l’installation de NPM terminée, procédons à l’installation du module LESS pour NodeJS. A noter la présence du « -g » dans la commande afin de précéder à une installation globale (pour tous les utilisateurs)

   sudo npm install less -g

4. Vous avez terminé l’installation de NodeJS, NPM et LESS

Utilisation

Écrivez un fichier less. Vous pouvez prendre un exemple du site officiel par exemple.

lessc styles.less

Conclusion

Voilà, vous êtes maintenant fin prêt pour l’utilisation de LESS dans vos projets web. Je vous recommande de faire un tour sur GitHub où vous trouverez des fichiers LESS pour facilité l’utilisation CSS3 sur les principaux navigateurs.

Personnellement, j’utilise LESS depuis presque 1 an et c’est un réel plaisir d’écrire des styles CSS avec un tel outil. Essayez-le !

J’utilise donc MacPort, un excellent gestionnaire de packages pour Mac OS X, qui permet de compiler et d’installer toutes sortes de logiciels open-source bien utiles.

La sortie récente de Mac OS X Lion, la nouvelle version du système d’exploitation d’Apple pour ordinateur, a été l’occasion de ré-installer complétement mon environnement LAMP…

Je vous propose ici un guide sur l’installation et la configuration d’Apache, MySQL et PHP avec MacPort…

Installation de votre environnement LAMP

Nous allons dans une premier temps procéder à l’installation d’Apache 2, MySQL 5 et PHP 5.3 et ses extensions. Pour cela, nous devons installer MacPorts 2.0…

Installation MacPorts 2.0

MacPorts 2.0 nécessite au préalable que les outils développeur Mac OS X Lion soient installés. Vous les obtiendrez en installant Xcode 4, disponible sur le Mac App Store d’Apple.

1. Téléchargez MacPorts 2.0 sur le site officiel
2. Ouvrez le fichier .dmg que vous venez de télécharger
3. Lancez le fichier .pkg et suivez les instructions

A noter que dans la suite de l’article, les commandes données sont à exécuter dans le terminal et en mode « super-admin », d’où le sudo au début des commandes.

Installation Apache 2

1. Téléchargez et installez Apache2 et ces dépendances :

   sudo port install apache2

2. Une fois l’installation terminée, vous pouvez activer lancement automatique de Apache au démarrage de l’ordinateur :

   sudo port load apache2

Installation MySQL 5

1. Téléchargez et installez MySQL 5 et ces dépendances :

   sudo port install mysql5

2. Installez/Activez le serveur MySQL 5 :

   sudo port install mysql5-server

3. Une fois l’installation terminée, vous pouvez activer le lancement automatique de MySQL au démarrage de l’ordinateur :

   sudo port load mysql5-server

4. Terminez l’installation de MySQL :

   sudo -u _mysql mysql_install_db5

5. Une fois l’installation terminée, vous pouvez lancer MySQL au démarrage de l’ordinateur :

   sudo port load mysql5

Installation PHP 5.3

1. Téléchargez et installez PHP 5.3 et ces dépendances. A noter ici que je choisi également d’activer le PEAR, d’où le +pear.

   sudo port install php5 +pear

2. Ajoutez le module PHP pour Apache 2 :

   sudo /opt/local/apache2/bin/apxs -a -e -n "php5" /opt/local/apache2/modules/libphp5.so

3. Créez le fichier de configuration php.inide PHP :

   sudo cp /opt/local/etc/php5/php.ini-development /opt/local/etc/php5/php.ini

4. Installez et activez MySQL pour PHP :

   sudo port install php5-mysql

5. Étape optionnelle : Installez quelques extensions utiles pour PHP (apc, curl, gd, iconv, mbstring, …).

   sudo port install php5-apc php5-curl php5-gd php5-iconv php5-intl php5-mbstring php5-mcrypt php5-posix php5-sqlite php5-xdebug php5-zip

Configuration de votre environnement LAMP

Les logiciels sont maintenant installés, reste à les configurer correctement…

Configuration Apache 2

Les étapes ci-dessous permettent de configurer le support de PHP dans Apache et d’activer le module UserDir (facultatif).

• Activer PHP dans Apache
  1. Éditez le fichier /opt/local/apache2/conf/httpd.conf
  2. Ajoutez à la fin du fichier

     # Include PHP configuration
     Include conf/extra/mod_php.conf

• Ajouter index.php dans les pages d’index reconnues par Apache
  1. Éditez le fichier /opt/local/apache2/conf/httpd.conf
  2. Recherchez la ligne ci-dessous :

     DirectoryIndex index.html

  3. Ajoutez sur la même ligne, à la fin :

      index.php

• Étape optionnelle : Activer l’extension UserDir pour Apache. Cette extension permet d’avoir des urls dédiées pour chaque utilisateur de l’ordinateur du type http://localhost/~utilisateur/
  1. Éditez le fichier /opt/local/apache2/conf/httpd.conf
  2. Recherchez et décommentez la ligne ci-dessous :

     #Include conf/extra/httpd-userdir.conf

  3. Étape optionnelle : Autoriser l’ajout/suppression d’options via un .htaccess (exemple Options +FollowSymLinks)
     1. Éditez le fichier /opt/local/apache2/conf/extra/httpd-userdir.conf
     2. Recherchez la ligne ci-dessous :

        AllowOverride FileInfo AuthConfig Limit Indexes

     3. Ajoutez sur la même ligne, à la fin :

         Options

• Une fois les modifications effectuées, vous pouvez (re)démarrer Apache :

  sudo /opt/local/apache2/bin/apachectl restart

Configuration MySQL 5

Les étapes ci-dessous ont pour objectif de configurer et sécuriser votre serveur MySQL.

• Démarrez le serveur MySQL

  sudo /opt/local/lib/mysql5/bin/mysqld_safe &

• Sécurisez votre serveur MySQL. Je vous recommande de configurer le mot de passe root et de répondre « Yes » à toutes les questions.

  sudo /opt/local/lib/mysql5/bin/mysql_secure_installation

Configuration PHP 5

• Configurer MySQL pour PHP
  1. Éditez le fichier /opt/local/etc/php5/php.ini
  2. Recherchez les paramètres pdo_mysql.default_socket, mysql.default_socket, mysqli.default_socketet mettez comme valeur ceci :

     /opt/local/var/run/mysql5/mysqld.sock

• Configurer le fuseau horaire par défaut
  1. Éditez le fichier /opt/local/etc/php5/php.ini
  2. Recherchez la ligne suivante :

     ;date.timezone =

  3. Remplacez par :

     date.timezone = "Europe/Paris"

• Étape optionnelle : Activer les archives Phar
  1. Éditez le fichier /opt/local/etc/php5/php.ini
  2. Recherchez et décommentez la ligne ci-dessous

     ;phar.readonly = On

• Une fois les modifications terminées, redémarrez votre serveur Apache 2.

Bonus

Bonus #1 : Installation et configuration de PhpMyAdmin

Si vous souhaitez installer l’outil PhpMyAdmin afin d’administrer vos bases de données MySQL depuis une interface web, voici les étapes à suivre.

1. Installez PhpMyAdmin

   sudo port install phpmyadmin

2. Activez PhpMyAdmin dans Apache
   1. Créez le fichier /opt/local/apache2/conf/extra/mod_phpmyadmin.conf avec comme contenu ceci :

      AliasMatch ^/phpmyadmin(?:/)?(/.*)?$ "/opt/local/www/phpmyadmin$1"
      
      <Directory "/opt/local/www/phpmyadmin">
        Options -Indexes
        AllowOverride None
        Order allow,deny
        Allow from all
      
        LanguagePriority en de es fr ja ko pt-br ru
        ForceLanguagePriority Prefer Fallback
      </Directory>

   2. Éditez le fichier /opt/local/apache2/conf/extra/mod_php.conf
   3. Recherchez la ligne ci-dessous :

      </IfModule>

   4. Ajoutez au-dessus les lignes suivantes :

      # PhpMyAdmin configuration
      Include conf/extra/mod_phpmyadmin.conf

   5. Redémarrez Apache 2
3. Étape optionnelle : Utiliser l’authentification HTTP plutôt que par cookies
   1. Éditez le fichier /opt/local/www/phpmyadmin/config.inc.php
   2. Recherchez la ligne ci-dessous et remplacez cookie par http

      $cfg['Servers'][$i]['auth_type'] = 'cookie';

Bonus #2 : Restauration de base de données MySQL volumineuses

Si vous essayez d’importer une base de données assez volumineuses (plusieurs Mo), vous obtiendrez une message d’erreur de MySQL :

Got a packet bigger than ‘max_allowed_packet’

Pour éviter ce problème vous devez personnaliser le fichier de configuration de MySQL. Voici les étapes à suivre.

1. Créez le fichier de configuration

   sudo cp /opt/local/share/mysql5/mysql/my-medium.cnf /opt/local/etc/mysql5/my.cnf

2. Éditez le fichier /opt/local/etc/mysql5/my.cnf
3. Recherchez la ligne ci-dessous :

   max_allowed_packet = 1M

4. Remplacez par :

   max_allowed_packet = 16M

5. Redémarrez le serveur MySQL
6. Si vous obtenez toujours cette erreur, éditez à nouveau le fichier de configuration et augmentez la valeur de max_allowed_packet

Conclusion

Votre environnement LAMP est maintenant prêt et vous pouvez commencer ou prendre vos développements PHP/MySQL avec Mac OS X Lion en plaçant vos fichiers PHP dans votre dossier Sites…

Aujourd’hui, je remets donc en route mon blog et de nouveaux articles sont déjà en préparation. Cela sera l’occasion de parler de Symfony2, que je suis/utilise depuis plus d’un an maintenant, mais de Mac OS X, de développement web et plein d’autres choses.

Au passage, ce blog a été mis à jour à la dernière version de WordPress et s’offre un tout nouveau design. Le thème est basé sur celui par défaut de WordPress 3.2 nommé « Twenty Eleven » que j’ai un peu modifié pour mes besoins.

Si vous utilisez Doctrine comme Object Relational Mapper (ORM), vous connaissez certainement les behaviours Timestampable, Sluggable ou encore SoftDelete. Les extensions Doctrine vous permettent justement d’en ajouter de nouveaux très facilement, en quelques clics ou lignes de commande.

Aujourd’hui, je vous propose d’installer et d’utiliser l’extension Taggable. Cette dernière permet d’ajouter des tags sur les modèles de votre choix. L’intérêt peut être de faire des recommandations ou retrouver des éléments relatifs à un autre.

Commençons d’abord par installer l’extension Taggable :

1. Placez-vous dans le dossier racine de votre projet symfony.

   cd /chemin/vers/le/projet/symfony/

2. Créez un dossier doctrine_extension dans lib.

   mkdir lib/doctrine_extension

3. Téléchargez l’extension Taggable avec subversion.

   svn co http://svn.doctrine-project.org/extensions/Taggable/branches/1.2-1.0 lib/doctrine_extension/Taggable

4. Videz le cache symfony (peut-être plus nécessaire mais c’est encore un réflexe chez moi).

   php symfony cc

5. Activez l’extension Doctrine :
   • Éditez le fichier config/ProjectConfiguration.class.php
   • Si vous ne l’avez pas encore, créez la méthode configureDoctrine

       public function configureDoctrine(Doctrine_Manager $manager)
       {
       }

   • Ajoutez le code ci-dessous dans la méthode.

         Doctrine::setExtensionsPath(sfConfig::get('sf_lib_dir').'/doctrine_extension');
         $manager->registerExtension('Taggable');

Voilà l’extension avec maintenant installée et activée. Voyons maintenant, comment l’utiliser. Pour cela je vais prendre un exemple très simple avec des articles qui possèdent des tags.

1. Définissez le modèle Article en copiant le contenu ci-dessous dans un fichier config/doctrine/10_articles.yml

   Article:
     actAs:
       Taggable:
     columns:
       title:          { type: string(255), notnull: true, notblank: true }
       body:           { type: clob, notnull: true, notblank: true }
   

2. Ajoutez des fixtures en copiant le contenu ci-dessous dans un fichier data/fixtures/10_articles.yml

   Article:
     Article_1:
       title: Mon premier article
       body: |
         Hello World !
         Ceci est mon premier article.
       tags: hello, world, article 1
   
     Article_2:
       title: Mon second article
       body: |
         Hello World !
         Ceci est mon second article.
       tags: hello, world, article 2
   

3. Créez les fichiers php associés au modèle et chargez les fixtures avec la commande suivante :

   php symfony doctrine:build --all --and-load

4. Créez un module Article dans l’application frontend

   php symfony generate:module frontend article

5. Éditez le fichier apps/frontend/modules/article/actions.class.php et remplacez le code de la méthode executeIndex par le code ci-dessous

       $this->articles = Doctrine::getTable('Article')->findAll();
       $this->popular_tags = Doctrine::getTable('TaggableTag')->getPopularTags();

6. Éditez le fichier apps/frontend/modules/article/indexSuccess.php et collez le code ci-dessous

   <h1>Articles</h1>
   
   <h2>Liste des articles</h2>
   <?php foreach ($articles as $article): ?>
     <h3><?php echo $article->title ?></h3>
     <p><?php echo nl2br($article->body) ?></p>
     <p>Tags : <?php echo $article->getTagsString() ?></p>
   <?php endforeach ?>
   
   <h2>Tags populaires</h2>
   <ul>
   <?php foreach ($popular_tags as $tag): ?>
     <li><?php echo $tag->name ?> (<?php echo $tag->total_num ?>)</li>
   <?php endforeach ?>
   </ul>

Si vous avez utilisez la sandbox symfony 1.4 pour suivre ce tutoriel, vous ne devriez pas avoir de problème. Toutefois, il existe quelques subtilités dans l’utilisation de l’extension Taggable que j’ai rencontré lors de son utilisation dans un projet réel. Je les mets ci-dessous, si vous en avez d’autres n’hésitez pas à le signaler dans les commentaires.

• Pour utiliser la table TaggableTag vous devez obligatoirement avoir chargé une autre table utilisant l’extension. Dans mon exemple, si vous inversez les deux lignes de la méthode executeIndex, vous obtiendrez une belle exception « Couldn’t find class TaggableTag ».
• Si vous essayez de supprimer un élément « Taggable », une exception sera levée. En effet, les tags associés à l’objet doivent être supprimés avant l’objet lui-même. Vous pouvez soit utiliser l’évènement preDelete pour supprimer les tags avant l’objet soit appliquer le patch que j’ai proposé dans l’issue tracker de Doctrine pour ajouter un onDelete CASCADE sur la relation.
• Les relations many-to-many entre votre modèle « Taggable » et les tags sont ajoutées à la volée, il faut donc « charger » le modèle avant l’utilisation d’une de ces relations. Ainsi, si vous voulez afficher un nuage de tags avec la méthode getPopularTags, il faudra charger chaque modèle « Taggable » où alors vous n’aurez que les tags populaires des modèles déjà chargés.

En conclusion, l’extension Taggable est très intéressante mais il subsiste quelques défauts qui peuvent bloquer son utilisation dans un projet concret. Si j’ai réussi à corriger les problèmes 1 et 2, le 3e reste non résolu pour le moment. La solution serait d’ajouter les relations dans les fichiers php générés par Doctrine lors de la création des modèles. Pas sûr que ce soit possible dans l’état actuel…

« Symfony 1.3 Web Application Development » compte un peu plus de 200 pages que je viens tout juste de terminer. Alors, convaincu ou déçu ? Voici mon avis…

Symfony dans tous ses états

Contraire à ce que je pensais avant la lecture du livre, le public visé n’est pas les développeurs utilisant déjà symfony et ayant envie d’en savoir plus sur la version 1.3 du framework. Non, le livre est plutôt destiné aux personnes qui ont envie de commencer à utiliser symfony et d’apprendre à l’utiliser.

Le livre est très complet et couvre les principales fonctionnalités proposées par le framework symfony : MVC, ORM, templates, admin generator, form framework, cache, ou encore internationalisation (i18n). Autant dire qu’à la fin de la lecture, le développeur dispose d’une bonne connaissance du framework et est fin prêt pour commencer un nouveau projet avec. Si il trouve symfony un peu faible en fonctionnalités (rappelons que le but de Symfony c’est de fournir ce qui est commun à 99% dans tous les projets web), il y a même un chapitre sur l’intégration de composants du Zend Framework ou de eZ Components. Un très bon point à mon avis.

Vous avez dit symfony 1.3 ?

Malgré cela, « Symfony 1.3 Web Application Development » souffre malheureusement de quelques défauts…

Tout d’abord, on trouve un certain nombre de fautes par ci par là, tant au niveau du texte qu’au niveau code. Si vous appliquez à la lettre le code présent dans le livre votre application ne fonctionnera pas. Rien de très grave, un développeur avec un minimum de connaissance en PHP n’aura aucun mal à les repérer et à les corriger…

Ensuite, bien que symfony 1.3 soit présent dans le titre, il s’agit plus d’un livre sur la version 1.2. En effet, à part des screenshots et quelques détails, je dois bien avouer que je n’ai pas vu grand chose de la nouvelle mouture du framework et c’est bien dommage. Le livre est sorti un peu trop vite, les grandes nouveautés de la version 1.3 n’étaient alors pas encore disponibles. Ainsi, par exemple, sur la partie « envoi de mails », le livre est déjà obsolète. On pourrait également regretter l’utilisation Propel malgré que Doctrine soit l’ORM par défaut de symfony 1.3.

Conclusion

Que penser du livre « Symfony 1.3 Web Application Development » ? Tout dépend de votre profil et de vos attentes. Si vous connaissez déjà symfony et que vous voulez connaître la version 1.3, passez votre chemin ce n’est pas le but du livre. Au contraire, si vous êtes développeur PHP et que vous avez envie d’apprendre à l’utiliser, allez-y ! Le livre est bien écrit et les choses sont bien expliquées. Une fois la lecture terminée, si vous voulez utiliser à fond Symfony 1.3, jetez un coup d’œil à la page What’s new in symfony 1.3/1.4 pour découvrir les nouveautés, cela terminera votre apprentissage.

En résumé, un bon livre qui permettra à tout ceux qui n’utilisent pas encore symfony d’appréhender l’outil sans difficulté.

Acheter « Symfony 1.3 Web Application Development » chez PacktPublishing
Acheter « Symfony 1.3 Web Application Development » sur Amazon.fr

En faisant une recherche rapide sur Internet, vous trouverez quelques solutions mais elles nécessitent de modifier tous les formulaires du projet. Sur un petit projet, 2-3 formulaires, cela peut être acceptable mais avec une soixantaine de formulaires cela peut vite devenir embêtant.

Je vous propose ici une solution/workaround que j’ai développé pour mes besoins afin de traduire ces fameuses chaînes. Elle fonctionne avec Symfony 1.2 et Doctrine 1.1 pour les formulaires actuels et futurs.

1. Éditer le fichier lib/filter/doctrine/BaseFormFilterDoctrine.class.php
2. Utiliser maintenant cette classe :

   abstract class BaseFormFilterDoctrine extends sfFormFilterDoctrine
   {
   	protected $booleanFieldChoices = array('' => 'yes or no', 1 => 'yes', 0 => 'no');
   
   	/**
   	 * @see sfForm
   	 */
   	public function __construct($defaults = array(), $options = array(), $CSRFSecret = null)
   	{
   		parent::__construct($defaults, $options, $CSRFSecret);
   		$this->fixI18N();
   	}
   
   	/**
   	 * @see sfForm
   	 */
   	public function setup()
   	{
   	}
   
   	protected function fixI18N()
   	{
   		foreach ($this->widgetSchema->getFields() as $field)
   		{
   			if ($field instanceof sfWidgetFormFilterInput)
   			{
   				$this->fixIsEmpty($field);
   			}
   			elseif ($field instanceof sfWidgetFormChoice
   			and $field->getOption('choices') == $this->booleanFieldChoices)
   			{
   				$field->setOption('choices', array_map(
   					array($this->widgetSchema->getFormFormatter(), 'translate'),
   					$field->getOption('choices')
   				));
   			}
   			elseif ($field instanceof sfWidgetFormFilterDate)
   			{
   				$this->fixIsEmpty($field);
   
   				$field->setOption(
   					'template',
   					$this->widgetSchema->getFormFormatter()->translate(
   						$field->getOption('template')
   					)
   				);
   			}
   		}
   	}
   
   	protected function fixIsEmpty(sfWidgetForm $field)
   	{
   		$field->setOption(
   			'empty_label',
   			$this->widgetSchema->getFormFormatter()->translate(
   				$field->getOption('empty_label')
   			)
   		);
   	}
   }
   

3. Si vous aviez déjà personnalisé cette classe, n’oubliez de ré-appliquer vos modifications.
4. Modifier le fichier apps/backend/i18n/fr/messages.xml (où backend est l’applicaton utilisant l’admin generator et messages le catalogue i18n) et ajouter :

         <trans -unit>
           <source>is empty</source>
           <target>est vide</target>
         </trans>
         <trans -unit>
           <source>yes or no</source>
           <target>oui ou non</target>
         </trans>
         <trans -unit>
           <source>yes</source>
           <target>oui</target>
         </trans>
         <trans -unit>
           <source>no</source>
           <target>non</target>
         </trans>
         <trans -unit>
           <source>< ![CDATA[from %from_date%<br />to %to_date%]]></source>
           <target>< ![CDATA[du %from_date%<br />au %to_date%]]></target>
         </trans>
   

   (attention aux espaces ajoutés par wordpress)

A noter cette solution corrige les formulaires de filtrage (filters), il existe également quelques chaînes hardcoded dans les widgets pour les formulaires « classiques ».

Tout d’abord, qu’est-ce qu’un composant dans Symfony ? Il s’agit en quelque sorte d’une action qui est réutilisable entre les différents modules de l’application. A la différence des « partials », qui sont « que » des templates, les composants contiennent de la logique : le plus souvent, récupérer un ou plusieurs modèles.

Pour revenir à la question, le problème n’est pas de gérer la validation à proprement parler, Symfony va s’en occuper grâce au forms framework mais plutôt de savoir où envoyer le visiteur une fois le formulaire soumis et comment, à la fin, le rediriger sur la page initiale, celle où il a rempli le formulaire.

Une solution possible est de créer une action spécifique pour valider le formulaire et d’ajouter un champ caché « referer » contenant l’url de la page initiale. Dans le fonctionnement, c’est relativement simple, le formulaire du composant pointe vers l’action et lorsque les données saisies sont valides, l’utilisateur est redirigé vers le valeur du champ « referer ».

Pour les intéressés, vous trouverez ci-dessous le contenu des différents fichiers pour l’utilisation d’un formulaire en composant. C’est prévu pour fonctionner avec Symfony 1.2.

1. Le formulaire (lib/form/TestForm.class.php)

   < ?php
   class TestForm extends sfForm
   {
   	public function configure()
   	{
   		$this->setWidgets(array(
   			'name'    => new sfWidgetFormInput(),
   			'referer' => new sfWidgetFormInputHidden(),
   		));
   
   		$this->setValidators(array(
   			'name'    => new sfValidatorString(),
   			'referer' => new sfValidatorString(array('required' => false)),
   		));
   
   		$this->widgetSchema->setNameFormat('test-form[%s]');
   	}
   }

2. Le composant (apps/frontend/modules/mymodule/actions/components.class.php)

   < ?php
   class mymoduleComponents extends sfComponents
   {
   	public function executeTestForm(sfWebRequest $request)
   	{
   		$this->form = new TestForm(array(
   			'referer' => $request->getUri()
   		));
   	}
   }

3. Le template du composant (apps/frontend/modules/mymodule/templates/_TestForm.php)

   <h2>My Form</h2>
   <form action="<?php echo url_for('test-form') ?>" method="post">
     <table>
       < ?php echo $form ?>
     </table>
     <input type="submit" value="Send" />
   </form>

4. L’action (apps/frontend/modules/mymodule/actions/actions.class.php)

   < ?php
   class mymoduleActions extends sfActions
   {
   	public function executeTestForm(sfWebRequest $request)
   	{
   		$this->form = new TestForm(array(
   			'referer' => $request->getUri()
   		));
   
   		if ($request->isMethod('post'))
   		{
   			$this->form->bind($request->getParameter($this->form->getName()));
   
   			if ($this->form->isValid())
   			{
   				$this->redirect(
   					$this->form->getValue('referer') ? $this->form->getValue('referer') : 'homepage'
   				);
   			}
   		}
   	}
   }

5. Le template de l’action (apps/frontend/modules/mymodule/templates/TestFormSuccess.php)

   < ?php include_partial('TestForm', array('form' => $form)) ?>

6. La règle de routage (apps/frontend/config/routing.yml)

   test-form:
     url:    /test-form
     param:  { module: mymodule, action: TestForm }

Une fois tous les fichiers créés, il ne reste plus qu’à inclure le composant dans un template, par exemple apps/frontend/layout.php, en ajoutant ceci :

< ?php include_component('mymodule', 'TestForm') ?>

Ici, le formulaire ne sert absolument à rien, la valeur saisie n’est pas utilisée. Il s’agit juste d’un exemple pour montrer le principe.

Note : Attention WordPress à ajouté un espace entre < et ?php

Tout bon développeur qui se respecte, je ne laisserai pas ce genre de paramètre perdu dans la logique métier. Tout d’abord parce que ça n’a absolument rien à faire là et ensuite parce qu’il ne serait pas facile de modifier le paramètre plus tard. Une bonne pratique est donc de créer un fichier à part pour stocker ces paramètres…

Dans symfony, il y a un fichier de paramètres pour les applications (apps/monapp/config/app.yml) et un pour les modules (apps/monapp/modules/monmodule/config/module.yml) mais pour tout le projet il n’y aucun fichier pré-défini par défaut. Heureusement, symfony est un framework très flexible et l’on peut ainsi ajouter un nouveau fichier de config en quelques lignes seulement…

Pour les intéressés, voici la procédure :

1. Créez un fichier nommé config_handlers.yml dans le dossier config
2. Copiez dans le fichier précédemment créé le code ci-dessous :

   config/project.yml:
     class:		sfDefineEnvironmentConfigHandler
     param:
       prefix: project_

3. Créez le fichier config/project.yml et ajoutez quelques paramètres. Par exemple :

   all:
     website:
       name: Mon site internet

4. Il faut maintenant charger les paramètres pour chaque application du projet.
   • Modifiez le fichier config/ProjectConfiguration.class.php
   • Ajoutez une fonction loadProjectConfig :

     	protected function loadProjectConfig()
     	{
     		static $load = false;
     
     		if (!$load && $this instanceof sfApplicationConfiguration)
     		{
     			require $this->getConfigCache()->checkConfig('config/project.yml');
     			$load = true;
     		}
     	}

   • Chargez le fichier de config en ajoutant le code ci-dessous dans la méthode setup de la classe :

     			$this->loadProjectConfig();

5. C’est fini !

Vous pouvez maintenant, dans les applications de votre projet, accéder aux paramètres définis dans project.yml en utilisant sfConfig::get('project_...').

Attention, si comme moi vous écrivez des tests automatisés pour vos projets, pour les tests unitaires, il faudra ajouter un ligne afin de charger le fichier de config personnalisé :

$configuration = ProjectConfiguration::getApplicationConfiguration('frontend', 'test', true);

Je vous conseille d’ailleurs d’écrire un bootstrap avec cette ligne plutôt que de la copier/coller dans chaque fichier de test

Les graphes c’est sympa mais je m’en méfie toujours, peut-être parce qu’en licence 3 j’ai dû perdre quelques cheveux lorsque j’ai coder 2-3 algorithmes, relativement simples par rapport à ceux cités avant, sur les graphes. Cette année pour ne pas me faire avoir, j’ai décidé d’utiliser des tests unitaires afin vérifier mon code. C’était en plus une bonne occasion pour découvrir un framework de tests en C++

Pour développer en C++ j’utilise le logiciel de développement proposé par Apple à savoir Xcode. Il est relativement bien fait, rapide à lancer, propose l’auto-complétion et surtout, on peut débugger facilement son programme. En plus de ça, Xcode intègre un framework de tests nommé CPlusTest. Pour ceux que cela intéressent, voici comment écrire des tests unitaires en C++ avec Xcode…

1. Ouvrez ou créez un projet.
2. Créez une cible pour les tests unitaires
   1. Dans le panneau latéral gauche, faites un clic droit sur « Targets » et cliquez sur « Add… » > « New Target… ».
   2. Dans la fenêtre qui apparaît, choisissez « Carbon » puis « Unit Test Bundle » et cliquez sur « Next… ».
   3. Entrez un nom pour votre cible, « UnitTest » par exemple, et appuyez sur « Finish ».
3. Créez une classe à tester
   1. Il nous faut maintenant une classe à tester. Pour cela, clic droit sur le dossier « Source », puis « Add… » > « New File… ».
   2. Choisissez « C++ File » dans le groupe « Carbon » puis appuyez sur « Next… ».
   3. Entrez le nom de votre classe, exemple MyFirstClass. Dans la partie « Targets », vérifiez que « UnitTest » est bien coché puis cliquez sur « Finish ».
   4. Codez une classe MyFirstClass, avec une méthode HelloWorld qui renvoie une string (std::string)
      Le .h :

      #ifndef FIRST_H
      #define FIRST_H
      
      #include
      
      class MyFirstClass
      {
          public:
          MyFirstClass();
          std::string HelloWorld();
      };
      
      #endif
      

      Le .cpp :

      #include "MyFirstClass.h"
      
      MyFirstClass::MyFirstClass()
      {
      }
      
      std::string MyFirstClass::HelloWorld()
      {
          std::string hello = "Hello World";
          return hello;
      }
      

4. Créez les tests unitaires
   1. Il faut maintenant créer un fichier de tests. Pour cela, clic droit sur le nom du projet dans le panneau gauche, « Add… » > « New File… ».
   2. Cliquez sur « Carbon » puis sur « C++ Test Case » et appuyez sur « Next ».
   3. Entrez un nom pour votre fichier de test, « MyFirstClassTest » par exemple. N’oubliez pas de vérifier que dans la partie « Targets », la cible « UnitTest » est bien coché puis cliquez sur « Finish ».
   4. Créez votre première méthode de tests dans MyFirstClassTest.cpp :

      void MyFirstClassTest::test_HelloWorld()
      {
          MyFirstClass *instance = new MyFirstClass();
          CPTAssert(instance->HelloWorld() == "Hello World");
          CPTAssert(instance->HelloWorld() == "Hello");
      }

      (N’oubliez pas d’ajouter l’entête de la méthode dans le .h)

   5. Enregistrez le test. Pour cela dans le fichier MyFirstClassTest.h, ajoutez à la fin :

      MyFirstClassTest test1(TEST_INVOCATION(MyFirstClassTest, test_HelloWorld));

5. Lancez les tests unitaires
   1. Dans le menu, cliquez sur « Project », allez à « Set Active Target » et choisissez « UnitTest ».
   2. Toujours dans le menu, cliquez sur « Build » puis « Build and Go (Run) ».
   3. Erreur devrez vous être rapportée, c’est le 2e test qui échoue. Si vous supprimez ce test et que vous refaite les étapes 5.1 et 5.2 tout devrait passer sans problème.

Voilà, vous êtes fin prêt pour écrire des tests unitaires en C++ avec Xcode. A noter que c’est la version 3.1 d’Xcode qui a été utilisé pour réaliser ce tutoriel. Il peut y avoir quelques changements selon la version de l’IDE que vous utilisez.

Pour plus d’informations sur les tests unitaires avec Xcode : http://developer.apple.com/documentation/developertools/Conceptual/UnitTesting/UnitTesting.html

J’en ai déjà parlé, la version de PHP fournie avec Mac OS X Leopard est assez… épurée : pas de GD ou de PEAR par exemple et la compilation d’extensions ne marchent pas (cf. mon billet sur Runkit). Pour une utilisation (très?) basique de PHP cela suffira mais si vous voulez, par exemple, manipuler des images il faudra utiliser une autre solution…

Parmi les autres solutions possibles, j’ai choisi d’utiliser MacPorts et de compiler « moi-même » PHP. Certains auraient peut-être choisi MAMP qui est une solution plus simple et plus « rapide » mais peut-on compiler des extensions avec ? A priori oui mais je n’en suis pas sûr. L’objectif est aussi de pouvoir installer d’autres packages que le trio Apache-MySQL-PHP et de mettre à jour ces packages très simplement (une ligne de commande).

Pour ceux que cela intéresse, voici la procédure pour installer et configurer Apache-MySQL-PHP avec MacPorts sur Leopard. A noter que je suppose que vous avez déjà installé les “Developper Tools” d’Apple.

Installation de MacPorts

1. Téléchargez MacPorts sur le site officiel : http://www.macports.org/
2. Ouvrez l’image disque (.dmg)
3. Lancez le .pkg et suivez les instructions.
4. Une fois l’installation terminée, allez dans le terminal et lancez la commande :

   sudo port selfupdate

Installation d’Apache 2.2

1. Installez Apache 2.2 en exécutant la commande qui suit dans le terminal :

   sudo port install apache2

2. Une fois l’installation terminée, lancez Apache :

   sudo /opt/local/apache2/bin/apachectl start

3. Si vous allez à l’adresse http://localhost vous devriez voir « It works! » à l’écran.
4. Si vous souhaitez qu’Apache soit lancé au démarrage de votre ordinateur, lancez la commande ci-dessous :

   sudo launchctl load -w /Library/LaunchDaemons/org.macports.apache2.plist

Configuration d’Apache 2

Maintenant qu’Apache 2 est installé, nous allons le configurer pour qu’il fonctionne comme la version d’Apache fournie avec Mac OS X Leopard.

1. Ouvrez le fichier /opt/local/apache2/conf/httpd.conf avec votre éditeur préféré.
2. Recherchez la ligne

   #Include conf/extra/httpd-userdir.conf

   et enlevez le caractère # au début.

3. Editez le fichier /opt/local/apache2/conf/extra/httpd-userdir.conf et ajoutez à la fin les lignes ci-dessous :

   #
   # Include user configurations
   #
   Include /etc/apache2/users/*.conf

4. Si vous souhaitez accéder au manuel d’Apache à l’adresse http://localhost/manual/ :
   1. Editez le fichier /opt/local/apache2/conf/httpd.conf
   2. Recherchez la ligne ci-dessous et enlevez le # au début.

      #Include conf/extra/httpd-manual.conf

5. Si vous souhaitez afficher la liste des éléments d’un dossier lorsqu’il n’y a pas de fichier index dedans :
   1. Editez le fichier /opt/local/apache2/conf/httpd.conf
   2. Recherchez la ligne la ligne ci-dessous et enlevez le # au début.

      #Include conf/extra/httpd-autoindex.conf

6. Relancez Apache :

   /opt/local/apache2/bin/apachectl restart

Installation et configuration de Mysql 5

1. Dans le terminal, lancez la commande suivante :

   sudo port install mysql5 +server

2. Une fois l’installation terminée, exécutez la commande :

   sudo -u mysql mysql_install_db5

3. Démarrez le serveur MySQL :

   sudo /opt/local/bin/mysqld_safe5 &

4. Sécurisez votre installation de MySQL :

   sudo /opt/local/bin/mysql_secure_installation5

5. Si vous voulez que MySQL soit automatiquement lancé au démarrage, lancez la commande suivante :

   sudo launchctl load -w /Library/LaunchDaemons/org.macports.mysql5.plist

Installation de PHP 5

1. Lancez l’installation de php5 :

   sudo port install php5 +apache2 +mysql5 +sqlite +pear

2. Une fois l’installation terminée, créez un fichier de configuration pour php (le php.ini) :

   sudo cp /opt/local/etc/php.ini-dist /opt/local/etc/php.ini

3. Installez le module php pour Apache :

   cd /opt/local/apache2/modules
   sudo /opt/local/apache2/bin/apxs -a -e -n "php5" libphp5.so

4. Editez le fichier /opt/local/apache2/conf/httpd.conf, recherchez

   DirectoryIndex index.html

   et remplacez par

   DirectoryIndex index.html index.php

5. Editez le fichier /opt/local/apache2/conf/httpd.conf et ajoutez à la fin les lignes suivantes :

   # Load the PHP module
   LoadModule php5_module modules/libphp5.so
   
   #
   # Include PHP configurations
   #
   Include conf/extras-conf/mod_php.conf

6. Relancez Apache :

   /opt/local/apache2/bin/apachectl -k restart

7. Vous pouvez maintenant créer dans votre dossier Sites (/Users/votrePseudo/Sites/) un fichier phpinfo.php

Voilà, votre environnement de développement AMP est installé et prêt à acceuillir vos scripts et applications ! Pour aller un peu plus loin, vous pouvez installer phpmyadmin et xdebug, avec MacPorts bien sûr.

Concernant MacPorts, je l’utilise depuis maintenant plusieurs mois et j’en suis très content. J’ai pu installer tous les packages dont j’avais besoin très simplement et sans problème. Je regrette juste de ne pas l’avoir découvert plus tôt…