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…

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

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…

J’ai pris l’habitude de toujours télécharger la documentation des outils que j’utilise. L’intérêt ? La consulter même lorsque je n’ai pas de connexion Internet ou lorsque le serveur qui l’héberge est momentanément indisponible.

Voilà, maintenant je n’aurai plus besoin de récupérer les sources de la documentation sur le SVN de symfony, j’ai de jolis PDF

• Télécharger la documentation de symfony 1.2 « The Definitive Guide to symfony »
• Documentation officiel symfony

Voilà maintenant quelques jours que j’ai commencé à utiliser le framework symfony… J’avais déjà testé dans le passé deux autres frameworks, à savoir Ruby On Rails et Zend Framework. Ils ne m’avaient pas vraiment convaincu en terme de rapidité de développement. Je précise toutefois que je les avais utilisé à leur début, les choses se sont sûrement améliorées mais j’avais très envie de tester symfony

Découverte de symfony

Pour faire mes premiers pas avec symfony, après avoir procédé à  l’installation de la version 1.1, je me suis dirigé vers le tutoriel My First Project. Il est plutôt bien fait, tout est expliqué en détails. Cela dit, je ne l’ai pas fait en entier, après avoir appris les bases du framework, je suis parti sur le tutoriel Askeet.

Le tutoriel Askeet est très bien fait et pour une fois on ne nous propose pas créer une bibliothèque/dvdthèque ou un blog mais une application dans le genre de Yahoo! Answers. Le petit problème avec ce tutoriel c’est qu’il est écrit pour le version 1.0 de symfony et que moi je voulais utiliser la dernière version, la 1.1. Bon, en réalité, on peut réussir à s’en sortir avec la 1.1, il faudra adapter le code parfois. Le plus gros du travail concerne les formulaires mais c’est alors l’occasion de lire le tutoriel symfony Forms in Action et de le mettre en pratique. Ça a été très instructif ! J’ai arrêté le tutoriel après une dizaine de jours (le tutoriel est organisation sous la forme d’un calendrier de l’Avant) estimant en avoir assez vu pour savoir si j’allais utilisé symfony ou non.

Mon avis

La première chose qui m’a surpris, dans le bon sens, avec symfony c’est les outils de débuggage. En effet, il est possible d’afficher tout un cas d’informations comme les requêtes SQL exécutées, les logs ou encore la configuration très facilement. Ces outils se présentent sous la forme d’une barre en haut à droite qui vous suit partout.

Ensuite, symfony est d’une facilité déconcertante ! En quelques lignes on se génère les classes « models », on créé une application , un module, une page. Des bonnes connaissances en programmation orientée objet sont toutefois nécessaires.

Un autre détail que j’ai trouvé très bien, c’est le « Form Framework ». Il permet de gérer un formulaire très simplement. Il suffit de définir les champs et les validateurs à appliquer, le framework va alors s’occupe de générer le formulaire, de valider les données lors de l’envoi et le cas échéant retourner le formulaire avec les erreurs et les valeurs précédemment saisies pré-remplies.

Il y a un point sur lequel je suis assez partagé : le testeur de symfony. Peut-être suis-je trop habitué à SimpleTest ? Je pense que je reviendrais sur ce point dans un prochain billet (avec un plugin pour l’améliorer ?).

Conclusion

En seulement quelques jours, je n’ai pas pu découvrir toutes les fonctionnalités de symfony. Toutefois, j’en ai vu assez pour savoir qu’il est très puissant, assez facile à prendre en main (pour un développeur maitrisant la POO) et extensible. Je n’en ai pas parlé mais on peut ajouter des plugins et il en existe déjà de nombreux (voir la liste des plugins symfony).

Symfony est un outil que je pourrais utiliser pour réaliser un projet sans problème. C’est très agréable de développer avec !

Et maintenant, il me tarde de créer mes premières tasks, de tester le système d’évènements, d’utiliser l’internationalisation (i18n), créer mon premier plugin, de tester les tasks i18n:extract, pour extraire les chaînes à traduire, et i18n:find pour trouver les chaînes non-traduites, …

Ayant remplacé le binaire php par celui de Marc Liyanage, j’ai essayé de nouveau de compiler de Runkit sur mon MacBook et là, oh surprise, ça fonctionne Pour les intéressés, je vous mets la démarche ci-dessous.

Il existe plusieurs méthodes pour installer une extension PECL. La version courante de Runkit ne semble pas fonctionner avec PHP 5.2 et supérieur, j’utilise donc la version de développement. Je sais, ce n’est pas bien mais bon c’est pour un environnement de développement donc c’est moins grave. A noter que, pour la suite, je suppose que vous avez déjà installé les « Developper Tools » d’Apple. Ces précisions étant maintenant faites, attaquons la compilation et l’installation de Runkit

1. Lancer le Terminal
2. Nous allons dans un premier temps, récupérer les sources de l’extension.
   • Exécuter les commandes ci-dessous :

     touch ~/.cvspass
     
     cd Desktop
     cvs -d:pserver:cvsread@cvs.php.net:/repository login

   • A ce stade, le Terminal devrait vous demander de saisir un mot de passe. Taper « phpfi » (sans les guillemets)
   • Récupérer maintenant les sources de l’extension avec la commande suivante :

     cvs -d:pserver:cvsread@cvs.php.net:/repository export -r HEAD pecl/runkit

3. Ensuite, nous allons compiler et installer Runkit.
   • Exécuter les commandes suivantes :

     cd pecl/runkit
     /usr/local/php5/bin/phpize

   • Si vous utiliser un processeur 64bits (Core2Duo par exemple), lancer cette commande :

     MACOSX_DEPLOYMENT_TARGET=10.5 CFLAGS="-arch ppc -arch ppc64 -arch i386 -arch x86_64 -g -Os  -pipe -no-cpp-precomp" CCFLAGS="-arch ppc -arch ppc64 -arch i386 -arch x86_64 -g -Os  -pipe" CXXFLAGS="-arch ppc -arch ppc64 -arch i386 -arch x86_64 -g -Os  -pipe" LDFLAGS="-arch ppc -arch ppc64 -arch i386 -arch x86_64 -bind_at_load" ./configure --with-php-config=/usr/local/php5/bin/php-config

   • Pour les processeurs 32bits, exécuter cette commande là :

     ./configure --with-php-config=/usr/local/php5/bin/php-config

   • Ensuite, lancer les commandes ci-dessous :

     make
     make install

4. Runkit est installé, il nous faut maintenant activer l’extension.
   • Rechercher un fichier php.ini dans /usr/local/php5/lib/ si il n’existe pas copier le fichier php.ini-recommended et renommer-le en php.ini
   • Editer le fichier php.ini
   • Ajouter à la fin du fichier la ligne suivante :

     extension=runkit.so

   • Enregistrer le fichier
5. Il ne nous reste maintenant plus qu’à redémarrer Apache, pour cela lancer cette commande :

   sudo apachectl restart

6. C’est fini. Vous devriez maintenant voir dans le phpinfo un bloc « runkit »