Si comme moi vous avez tenté d’utiliser la directive .suffix dans le routing.yml

prod:
  routing:
    param:
      suffix: .html

et que vous vous attendiez à ce que vorte suffixe .html soit ajouté automatiquement à tous les liens générés via link_to et gen_url … c’est que vous ne savez pas que par défaut symfony génère des urls aussi courtes que possible.

Il vous faudra donc changer ce comportement dans factories.yml

all:
  routing:
    class: sfPatternRouting
    param:
      generate_shortest_url: false

En effet l’approche RAD proposée par ce framework rend d’autant plus crucial le schéma de base de données, sur lequel est basé l’application. Ce schéma matérialisé par le fichier schema.yml (ou .xml si vous utilisez propel) est en quelque sorte la feuille de route du développeur agile.

Il est intéressant de remarquer qu’une modélisation graphique de ce schéma donne un point de vue (partiel certes) sur le système d’information que l’applicaiton sert …

Il ya déjà quelques temps déjà j’avais cherché à automatiser la modification du schéma géré par symfony via des outils graphiques (Utiliser DBDesigner avec l’i18n de symfony 1.0)

Aujourd’hui je vous propose un petit tour d’horizon des solutions à votre disposition selon vos outils et votre orm préférés

DbDesigner

si vous utilisez propel

• Le plugin sfDB4toPropelPlugin automatisera le processus de conversion du schéma sauvé par DbDesigner en un schema.yml (à la manière des scritps cités précédemment)

si vous utilisez Doctrine

le plugin sfDbDesignerPlugin ne s’installe pas correctement via la commande symfony. En revanche en l’installant manuellement, i.e. en téléchargeant l’archive directement sur le site et en la décompressant dans /plugins/sfDbDesignerPlugin puis en activant le plugin dans /config/ProjectConfiguration.class.php

<?php

require_once dirname(__FILE__).'/..\lib\vendor\symfony\lib/autoload/sfCoreAutoload.class.php';
sfCoreAutoload::register();

class ProjectConfiguration extends sfProjectConfiguration
{
  public function setup()
  {
    $this->enablePlugins('sfDoctrinePlugin');
    $this->enablePlugins('sfDbDesignerPlugin');
  }
}

vous aurez accès à la task

php symfony dbdesigner:convert-doctrine doc/database.xml

Où doc/database.xml est le path vers le fichier DBDesigner.
Si vous n’avez pas une application nommée frontend il faudra la passer ne paramètre

php symfony dbdesigner:convert-doctrine --application=myapp doc/database.xml

vous obtiendrez alors un fichier « ready to build » du schéma modélisé avec DBDesigner dans config/doctrine/schema.yml

MySQLWorkBench

Il est à noter que MySQLWorkbench est un fork de DBDesigner4, mais il ne peut pas remplacer ce dernier. En effet si MySQLWorkbench sait parfaitement importer un fichier xml produit par DbDesigner4, il est en revanche incapable d’exporter ce schéma au format xml de DbDesigner4.  MySQLWorkbench ne permet que d’enregistrer au format mwb.

Ce format est en fait un zip, qui une fois décompresser donne un fichier xml, mais qui n’a rien à voir avec le xml généré par DBDesigner4, le fichier xml issu du .wmb est donc inutilisatble avec les deux plugins ci dessus.

MySQLWorkbench bénéficie en revanche d’une bibliothèque de plugins qui permettent de l’utiliser en remplaçant de DBDesigner.

Pour installer un plugin dans MySQLWorkbench il suffit de copier le fichier .lua qui contient le code du plugin (du Python Like) dans le répertoire « modules » du répertoire d’installation de MySQLWorkbench

• Si vous utilisez Doctrine mysql-workbench-doctrine-plugin¹ fonctionne plutôt bien
• Si vous utilisez Propel mysql-workbench-propel-export-plugin² de générer le contenu de schema.xml, alors que SymfonyYamlMysqlWorkbenchPlugin³ vous permettra de générer le contenu de schema.yml

Dia

Si vous utilisez propel, il est possible de modéliser également votre schéma avec Dia grâce au plugin diaToPropelPlugin, en utilisant la boite à outil « Database » ça va sans dire.

Si vous utilisez Doctrine le plugin ConvertPropelSchemaToDoctrineSchema réalisera la conversion d’un schéma propel en schéma doctrine.

ArgoUML

En graltant un pei plus j’ai trouvé également le plugin uml2symfony, qui semble avoir l’ambition de traduire non pas un schéma de base de données, mais un schéma UML généré avec ArgoUML. Je vous laisse aller plus loin car j’ai personnellement trouvé l’idée séduisante mais la documentation très pauvre, voir inexistante!

Conclusion

Mon choix se portera sur le doublette gagnante MySQLWorkbench, mysql-workbench-doctrine-plugin car:

• DBDesigner n’est plus maintenu depuis belle lurette (je me rends compte en écrivant ce post que DBDesigner fork qui a dormi pendant prêt de 3 ans semble revenir à la vie depuis quelques jours)
• j’utilise maintenant Doctrine
• ce plugin permet une gestion fine des Behaviors Doctrine

C’est sans aucun doute le plus sexy de tous les environnements de développement PHP pour windows (wampserver2, successeur du défunt Wamp5, xampp , et easyPHP), en effet son interface de maintenance est riche et ergonomique

Elle permet notamment de passer d’une version à une autre de PHP en 1 clic, ce qui n’est pas négligeable.

Elle propose des interfaces de gestion simplifiées pour la configuration de PHP (extensions et variables du fichier  php.ini)

ainsi que pour celle d’apache (configuration de virtual hosts & modules apache)

Pour les barbus, les fichiers php.ini et httpd.conf sont toujours accessibles via un bouton, et il est même possible de paramétrer son éditeur de texte préféré (paths portables acceptés!) en cliquant sur le bouton « préférences ».

Dans la séries des raccourcis vous pourrez accéder en un clic

• à la page d’accueil de votre répertoire racine – http://localhost/
• au répertoire contenant les virtual hosts – z:\Apps\UwAmp\www\
• à phpMyAdmin – http://localhost/mysql/ (à noter que le mot de passe root de MySQL par défaut est root)
• à un phpinfo() – http://localhost/uwamp/phpinfo.php
• à SQLite Database Browser qui vous permettra de gérer vos bases de données SQLite

et en cadeau bonus

• Les logs access du serveur apache
• Les logs error du serveur apache
• Les logs du serveur MySQL
• à la suppression des fichiers de log sus cités
• à la suppression des fichiers de sessions PHP

…

Le petit bémol que je mettrais par rapport à l’installation de xampp portable, que j’ai déjà documentée, est que PEAR n’est pas préinstallé.

Pour utiliser les commandes PHP et mysql sans se préoccupper de leur path, suivez les explications suivantes en remplaçant ;\Apps\xampp\php\;\Apps\xampp\mysql\bin\ par  ;\Apps\UwAmp\apache\php_5.3.1;\Apps\UwAmpp\mysql\bin\. N’oubliez pas de fermer et de rouvrir votre session pour prendre en compte le nouveau Path (n’oubliez pas non plus de laisser un commentaire si vous avez une meilleure solution).

ouvrez ensuite un prompt de commande et tapez

cd z:\Apps\UwAmp\apache\php_5.31
go-pear.bat

si vous ne vous mettez pas dans le dossier  vous allez obtenir un message d’erreur du genre

Could not open input file: PEAR\go-pear.phar
Appuyez sur une touche pour continuer…

Sinon PEAR vous demandera si vous souhaitez faire une installation système ou locale. La différence réside essentiellement dans la localisation du fichier pear.ini. Si vous voulez comme moi jouer avec plusieurs installations de PEAR choisissez local. En effet l’installation système installe le fichier pear.ini dans c:\windows, ce qui le rendra commun à toutes  vos installations de PEAR. L’installation local permet de ranger le pear.ini dans le répertoire de la commande php auquel CETTE commande PEAR est associée …

Une fois le choix fait vous pouvez choisir les options par défaut lors du process d’installation

ensuite pour installer symfony 1.0

pear upgrade PEAR
pear channel-discover pear.symfony-project.com
pear install symfony/symfony-1.0.21
symfony -V

Vous êtes alors prêt pour askeet.

Pour installer la dernière version courante de symfony1.4.1

pear install symfony/symfony

Vous êtes alors prêt pour jobeet.

L'avantage c'est que vous disposez d'une installation de PEAR par version de PHP, ce qui est idéale pour avoir plusieurs version de symfony sur votre plateforme de développement!

Voilà deux ans que je fais un cours, suivi d’un petit projet traitant du design Pattern MVC.  Le projet est à écrire en PHP5, avec une base de données MySQL comme support de stockage des données, l’architecture MVC est donc à implémenter dans un contexte purement web. Le paradigme objet est tout indiqué quand il s’agit d’écrire et d’agencer des composants logiciels, c’est donc celui qui sera adopté dans toute la suite.

Il y a bien entendu beaucoup de projets existants implémentant le design Pattern MVC en PHP, mais le propos du cours est plutôt de réaliser un cas pratique d’implémentation afin de bien saisir les bien faits du design pattern  MVC.

En effet l’utilisation d’un design pattern architectural en PHP, s’oppose à la pratique empirique de ce langage qui consiste à mélanger les connexions et accès à la base de données, avec le traitement des données et leur affichage. Dans ce cas il est alors commun d’avoir dans un seul script: du PHP, du SQL, du Javascript et du CSS dans les attributs des balises HTML soit pas moins de 5 langages distincts.

Au même titre qu’il est conseillé dans la présentation de séparer l’HTML, qui structure le document, du CSS, qui l’habille, il est conseillé d’utiliser un design pattern architectural pour structurer une application web.

Pour mémoire cette architecture permet d’organiser une application en 3 couches distinctes à savoir :

• le modèle, qui contient la logique métier;
• la vue, qui regroupe tout ce qui a trait à la présentation (des données / comme des interactions utilisateur);
• le contrôleur, qui répond à des interactions utilisateurs en provenance de la vue, en appelant des traitements mis à disposition sous forme de méthode par le modèle, afin de nourrir la vue associée au traitement demandé par l’utilisateur.

Si vous pratiquez PHP et n’avez jamais utilisé le design pattern MVC, je vous recommande la lecture de : « comment convertir une application PHP standard en une application basée sur l’architecture MVC« .

Le propos de ce billet n’est pas de vanter les mérites du design pattern MVC, car ils sont en général bien compris par mes étudiants. C’est plutôt d’en détailler la couche modèle dont la structure est assez dure à disséquer. J’ai moi-même pas mal lu et beaucoup débattu, avec le camarade will durand notamment, avant d’arriver à isoler chaque composant de cette couche.

le Modèle

Sous sa forme la plus brute, la couche modèle peut être vu comme les « données ». Par données on entend tout ce qui est persistant, c’est-à-dire tout ce qu’on pourra lire à partir d’une source, et modifier pour le relire plus tard si besoin est. Dans une logique de découplage, il est de bon ton d’essayer de s’affranchir le plus possible de la forme brute des données. C’est ce que va faire le modèle en transformant des données brutes en objets structurés, utilisables simplement par la couche inférieure : le contrôleur.

Pour réaliser ce découplage le modèle utilise 3 couches d’abstraction :

• La DAL (Data Access Layer) : couche abstraction de données
• Le DAO (Data Access Object) : objet d’accès aux données
• L’ORM (Object / Relation Mapping) : Mapping objet / relationnel

Pour l’exemple je vous propose de partir du diagramme UML suivant

qui donne le MLD (schéma de base de données) suivant

La DAL

La DAL Permet de s’abstraire du support des données. Pour se faire elle met à disposition des méthodes génériques permettant d’accomplir des actions de maintenances sur les données. Les actions les plus communes sont regroupées sous l’acronyme CRUD (Create Read Update Delete). Basiquement la DAL va donc mettre à disposition des méthodes permettant d’ajouter, mettre à jour, lire, supprimer un enregistrement, et ce quelque soit le support de stockage des donnéees.

La généricité par rapport au stockage est en général matérialisée par un paramètre permettant de spécifier la nature du support (on appelle ça des drivers). Ainsi les méthodes CRUD associées au support de stockage sont utilisées de manière transparente par le développeur. Concrètement il n’y a donc en théorie qu’un paramètre à changer pour qu’une application utilisant une DAL puisse changer de support.

D’un point de vue strictement théorique la DAL devrait offrir la possibilité de maintenir des données dans n’importe quelle base de données, dans des fichiers texte, dans des fichiers xml …

D’un point de vue pratique, en PHP, une DAL utilise toujours un SGBD. Son rôle est donc de rendre l’applicatif qui l’utilise (la DAL) portable par rapport au SGBD utilisé.

Les DAL PHP que je connais sont Pear DB (la première que j’ai utilisé), Creole, et PDO qui tend à devenir le standard en PHP, puisque disponible sous forme d’extension PHP.

Le DAO

Le Dao a pour but de transformer les données contenues dans une bases de données en objets et inversement

Pour se faire il va faire correspondre (de manière bijective – ca veut dire qu’on peut rajouter « et inversement » à la fin de chacun des points suivants)

• une table (appelée aussi relation) à une liste d’objets
• une ligne d’une table (appelée aussi tuple) à un objet
• un champs de base de données à un attribut d’objet
• une valeur d’un champs à une valeur d’attribut d’un objet

Dans notre exemple les classes issues du DAO seront au minimum

je dis au minimum, car ces classes pourraient avoir un peu plus de … classe! avec des getters et des setters.

Techniquement la DAO interroge le SGBD via la DAL sur la structure des tables afin de maintenir la correspondance entre les champs des tables de la base de données et les attributs des objets. Il y a au moins deux façons de réaliser celà:

• soit en générant un code PHP minimale fonction de la structure de la base de données (il faudra alors regénérer à chaque modification du schéma de base de données).
• soit en utilisant les méthodes magiques PHP (comme __get, __set ou __call et ___callStatic) et le late static binding de PHP 5.3

Notez qu’à ce niveau là le seul code logique que possède les objets construits à partir d’un DAO sont les méthodes CRUD qui vont permettre d’aller le lire, le modifier, le supprimer en base. En cela les objets issus d’un DAO pourraient être appelés des POPO  (rigolez pas! c’est pas moi qui l’ai dit le premier) par analogie aux POJO Java (Plain Old Java Object)

Notez également que dans le schéma de présentation des couches d’abstraction du modèle,  le DAO utilise la DAL, mais que ce n’est pas une vraie obligation : un DAO hardcodé en mysql resterait un DAO … simplement non portable au niveau du SGBD.

Notez enfin que chaque classe est isolée, c’est à dire qu’il n’existe pas de code logique qui permette une quelconque interaction entre elles.

L’ORM

L’ORM a pour but de transformer les relations entre les tables d’ une base de données en relations entre objets et inversement

Elle va typiquement se préoccuper de matérialiser les clés étrangères par des dépendances entre objetsL’intérêt réside dans le fait que les méthodes de la couche ORM, renvoient ou prennent en paramètres des listes d’objets. Par exemple $post->getComments() renverra une liste d’objets de classe Comment. Ces objets Comment seront sous forme de POPOS, c’est en celà que l’ORM utilise le DAO.

Techniquement l’ORM utilise soit les contraintes d’intégrité référentielle, soit une certaine logique de nommage, pour déterminer les clés étrangères. Dans les deux cas elle passe par la DAL.

Comme pour le DAO, les stratégies de génération de code ou d’utilisation des méthodes magiques peuvent être adoptées.

Comme pour le DAO également, l’utilisation d’une DAL est conseillée mais pas obligatoire.

propel et doctrine sont deux ORM PHP typiques.

La couche métier

Le but des couhes précédentes est de soulager la couche métier. Si la couche métier peut hériter des méthodes de la DAO et de l’ORM, nous aurons des objets présentant toutes les méthodes pour les gérer en base.

La couche métier est sensée ne contenir que la logique métier, c’est à dire propre à l’objet qu’elle représente. Ce sera effectivement le cas dans la class Post par exemple, où l’on pourra n’avoir qu’une seule méthode Post::getArchives(), qui retourne une liste de liste contenant les archives du type

Array(
'2009' => Array('janvier' => 1),
'2008' => Array('septembre' => 7, 'octobre' => 2, 'novembre' => 1, 'décembre' => 1)
)

Cette méthode fait bien parti de la couche métier puisqu’elle est propre au concept de post (ou billet) de blog.

En appelant cette méthode le contrôleur pourra nourrir une vue qui n’aura alors qu’un double foreach à faire pour présenter les archives dans le menu de droite.

conclusion

Les concepts que je viens de détailler sont souvent amalgamés, aussi il est souvent difficile de les cerner précisément. J’ai essayé d’illustrer le rôle de chacun par un exemple simpliste, mais je ne prétends détenir aucune vérité sur le sujet et les commentaires sont ouverts pour accueillir vos questions, suggestions et corrections

le mld a été généré avec DBDesigner4 et tout les diagrammes uml ont été générés avec yUML

• www: http://www.voyage-grand-coeur.org/
• rss: http://www.voyage-grand-coeur.org/feed
• fan page facebook
• twitter : http://twitter.com/vagc63

Il est évident que les voyageurs n’auront ni le temps, ni les moyens techniques de mettre à jour leur statu en temps réel. En revanche il vont faire à intervalle régulier des « comptes rendus d’étape ». Le but est de diffuser automatiquement ces comptes rendus dès qu’un voyage est en cours et de diffuser de manière tout aussi automatique les news du site entre deux voyages.

J’ai donc créée un filet RSS « mixant » les derniers comptes rendus d’étapes et les dernières news. Ce qui m’a préoccupé ensuite c’est comment brancher ce flux à un compte twitter et à compte facebook.

Je suis rapidement tombé sur une solution utilisant twitterfeed. Cette solution utilise l’application selective tweet statu (l’une des applications facebook pour twitter) qui est capable d’alimenter le statu d’une fan page facebook avec un compte twitter. Le problème de cette application, et donc de cette solution, est que chaque tweet doit être suffixé avec le hashtag #fb, ce qui ne fait pas de très beaux tweets …

Heureusement en regardant un peu plus dans le détails twitterfeed, j’ai remarqué qu’il était possible de configuré non seulement un compte twitter pour recevoir un flux RSS, mais aussi un compte facebook. Voici comment faire en quelques étapes

conifgurer le RSS à diffuser

configurer le compte twitter sur lequel le RSS sera publié

configurer le compte facebook de l’administrateur de la fan page sur laquelle le RSS sera publié

aperçu du dashboard

Notez que vous pouvez aussi alimenter ping.fm, hellotxt ou laconica, et qu’il est possible de paramétrer un compte bit.ly pour tracker les clics sur vos liens … Bref twitterfeed est un point d’entrée automatique idéal pour les pipelines sociaux
pour en savoir plus

installation et configuraiton de xampp portable

xampp est l’environnement Apache / MySQL / PHP portable le plus stable que j’ai trouvé à l’heure actuelle. Je garde toutefois un œil sur le tout jeune, mais néanmoins prometteur, uWamp (soumis par le camarade @couac).
il faudra télécharger la version zip de xampp et la dézipper dans z:\Apps\xampp par exemple

Dans un premier temps il faut exécuter le batch z:\Apps\xampp\setup_xampp.bat (il faudra le faire à chaque fois que le path change)

normalement si vous taper http://localhost/xampp/ dans votre navigateur vous devriez arriver sur la page suivante

Ca y est! vous avez installé des services portables et fonctionnels …

Maintenant passons à la ligne de commande. En effet pour être tout à fait à l’aise, l’idéal est de pouvoir appeler l’interpréteur php (ainsi que la commande pear et les commandes mysql) sans avoir à se préoccupper du chemin pour y accéder. Pour cela il va falloir ajouter deux chemins supplémentaires dans la variable d’environnement PATH de windows.

Voici comment procéder sur windows 7 (la démarche pour Vista peut être adaptée à partir de ces explications dans la section « mise à jour des variables d’environnement »).

Notez les que nous n’avons pas spécifié de lettre dans les path que nous venons d’ajouter (;\Apps\xampp\php\;\Apps\xampp\mysql\bin\) …
cela présente un avantage majeur : le path n’aura pas à être changé si la clé change de lettre;
Mais aussi un inconvénient : la commande php ne peut être utilisée qu’à partir du lecteur de la clé USB (pour l’utilisation de la commande php pour symfony cela ne pose aucun problème).

Il faut savoir que les variables d’environnements dans un système d’exploitation sont initialisées à l’ouverture de la session d’un utilisateur. Dans la plupart des systèmes on peut forcer la relecture de ces variables, mais je n’ai jamais trouvé comment faire sous windows (les suggestions sont les bienvenues) … donc pour appliquer les changements qui viennent d’être effectués il faut fermer votre session et la rouvrir (ou de manière plus brutale redémarrer).

Une fois reconnecté, ouvrez un ligne de commande, positionnez vous dans le répertoire z:\Apps\xampp et tapez

php -v

si vous voyez apparaître quelque chose du genre

PHP 5.3.0 (cli) (built: Jul  2 2009 21:08:11)
Copyright (c) 1997-2009 The PHP Group
Zend Engine v2.3.0, Copyright (c) 1998-2009 Zend Technologies

c’est gagné!
Il suffit maintenant de procéder à l’installation de symfony via PEAR. Ca tombe bien , la commande est déjà installé et accessible via la ligne de commande, il n’y a donc qu’à taper

pear upgrade PEAR
pear channel-discover pear.symfony-project.com
pear install symfony/symfony-1.0.21
symfony -V

devrait maintenant afficher

symfony version 1.0.21

N.B. pour installer la version stable courante de symfony il suffit de lancer la commande

pear install symfony/symfony

sans spécifier de numéro de version

Félicitation votre environnement est près …

configuration des virtual hosts

Pour utiliser les virtual hosts il vous faudra décommenter cette ligne

NameVirtualHost *:80

Les vhosts et les alias peuvent s’écrire sans lettre de lecteur dans z:\Apps\xampp\apache\conf\extra\httpd-vhosts

#préserver le vhost localhost pour avoir accès à la page d'admin de xampp
<virtualhost *:80>
  ServerName localhost
  DocumentRoot /apps/xampp/htdocs
</virtualhost>
#création d'un vhost dédié pour un projet symfony
<virtualhost *:80>
  ServerName vdm
  DocumentRoot /apps/xampp/htdocs/vdm/web
  <directory "/Apps/xampp/htdocs/vdm/web/">
    AllowOverride All
  </directory>
  #alias permettant d'accéder aux js / css / images symfony installés dans PEAR
  Alias /sf /apps/xampp/pear/data/symfony/web/sf
  #directive permettant de faire fonctionner l'alias précédent sous windows
  <directory "/Apps/xampp/pear/data/symfony/web/">
    AllowOverride All
    Allow from All
  </directory>
</virtuahHost>

Dernière étape, la moins fun, il vous faudra ajouter le nom du vhost au fichier c:\windows\system32\drivers\etc\hosts comme suit

127.0.0.1   vdm

vous pouvez a présent configurer autant de virtual host que vous voulez et bénéficier sans limite des bienfaits du routing symfony

Portabiliser NetBeans

source: http://www.portablefreeware.com/forums/viewtopic.php?f=4&t=5301&hilit=netbeans

En résumé pour une FramaKey (sur le lecteur z:\ par exemple), sachant que ce qui m’intéresse c’est netbeans pour PHP :

Sur http://www.netbeans.org/downloads/index.html télécharger la version que vous voulez en sélectionnant dans plateforme « OS Independent Zip », et décompressez l’archive dans z:\Apps\portableNetbeans\

Sur https://cds.sun.com/is-bin/INTERSHOP.enfinity/WFS/CDS-CDS_Developer-Site/en_US/-/USD/ViewProductDetail-Start?ProductRef=jdk-6u16-oth-JPR@CDS-CDS_Developer, téléchargez la version « windows », installez la et copiez le contenu de c:\program files\java\jdk1.6.0_16\ dans z:\Apps\portableJava\

Créez le répertoire z:\Data\Netbeans

Editez le fichier z:\Apps\portableNetbeans\etc\netbeans.conf et modifiez le comme suit

# ${HOME} will be replaced by JVM user.home system property
# netbeans_default_userdir="${HOME}/.netbeans/6.7"
netbeans_default_userdir="/Data/Netbeans"

# Options used by NetBeans launcher by default, can be overridden by explicit
# command line switches:
netbeans_default_options="-J-client -J-Xss2m -J-Xms32m -J-XX:PermSize=32m -J-XX:MaxPermSize=200m -J-Xverify:none -J-Dapple.laf.useScreenMenuBar=true -J-Dsun.java2d.noddraw=true"
# Note that a default -Xmx is selected for you automatically.
# You can find this value in var/log/messages.log file in your userdir.
# The automatically selected value can be overridden by specifying -J-Xmx here
# or on the command line.

# If you specify the heap size (-Xmx) explicitely, you may also want to enable
# Concurrent Mark & Sweep garbage collector. In such case add the following
# options to the netbeans_default_options:
# -J-XX:+UseConcMarkSweepGC -J-XX:+CMSClassUnloadingEnabled -J-XX:+CMSPermGenSweepingEnabled
# (see http://wiki.netbeans.org/wiki/view/FaqGCPauses)

# Default location of JDK, can be overridden by using --jdkhome <dir>:
netbeans_jdkhome="/Apps/portableJava"

# Additional module clusters, using ${path.separator} (';' on Windows or ':' on Unix):
#netbeans_extraclusters="/absolute/path/to/cluster1:/absolute/path/to/cluster2"

# If you have some problems with detect of proxy settings, you may want to enable
# detect the proxy settings provided by JDK5 or higher.
# In such case add -J-Djava.net.useSystemProxies=true to the netbeans_default_options.

et le tour est joué.

Notez que cette astuce marche également avec le support symfony fraîchement disponible sur http://blogs.sun.com/netbeansphp/entry/symfony_support_finished

Portabiliser PHPEdit

Si vous êtes l’heureux possesseur d’une licence PHPedit, cet IDE est également portabilisable

source : http://doc.waterproof.fr/faq/phpedit/how_do_i_install_phpedit_on_a_usb_stick_phpedit_2_10_and_up

Il suffit de copier le répertoire c:\Program Files\WaterProof\PHPEdit\3.4.2 sur votre clé USB par exemple dans z:\Apps\PHPedit
créez le répertoire z:\Data\PHPEdit destiné à stocker l’espace de travail
Ensuite Deux solutions s’offrent à vous :
créer un fichier texte PHPEdit.PHPEditSettings dans le répertoire contenant PHPEdit.exe
enregistrer le contenu suivant dans z:\Apps\PHPedit\PHPEdit.PHPEditSettings

      ..\..\Data\PHPedit

      ..\..\Data\PHPedit

Sinon Rendez-vous dans « Outils » -> « Editer les préférences » (ou directement en tapant F1O)

• cliquez juste en dessous de la barre des titres là où il y a les deux flèches (1)
• cliquez ensuite sur « paramètres locaux » en haut à gauche (2)
• remplir le champs « Dossier de stockage des données de l’application » avec un path relatif (ici ..\..\Data\PHPEdit) (3)

Notez que je fais l’impasse sur eclipse que je trouve définitivement trop gourmand en ressource!

En guise de conclusion

J’ajoute également quelques outils portables supplémentaires que j’aime bien avoir à portée de clic:

• console 2 : un projet de console un peu plus fun que la ligne de commande de base. Au programme paramètrage du dossier d’ouverture par défaut, redimensionnement, choix des polices et de leur taille, consoles virtuelles et transparence … voici mon fichier de conf à copier / coller dans z:\Apps\Console2\bin\release
• winmerge : permet de fusionner facilement du code. C’est en gros une version graphique de la commande UNIX diff
• DBDesigner4 ou MySQL Workbench : designers graphique de base de données.

Intégration de FCK

j’ai réécrit le template _commentForm.php pour y mettre un éditeur « riche » : FCKeditor (il doit bien entendu être configuré au préalable dans le /apps/myapp/config/settings.yml) en modifiant

<?php echo textarea_tag('sf_comment', '', array('cols' => 40, 'rows' => 8)) ?>

en

<?php echo textarea_tag('sf_comment', '', 'tool=Basic rich=fck size=40x8 disabled=false')?>

J’ai ensuite stocké le fichier modifié au niveau de l’appli /apps/myapp/modules/sfComment/templates/_commentForm.php afin de ne pas toucher au code du plugin

FCK se sent obligé de mettre une ligne vide en valeur par défaut ce qui fait que la directive required ne suffit pas, puisque ligne vide n’est pas vide.
J’ai donc réécrit la validation en tant qu’anonyme en y ajoutant

sf_comment:
  required:
    msg:           The message is required
  # blank from FCK
  sfCallbackValidator:
    callback:      strip_tags
    invalid_error: The message is required

J’ai stocké le fichier modifié au niveau de l’appli /apps/myapp/modules/sfComment/validate/anonymousComment.yml

Liens en nofollow

Mettre un lien en nofollow fait que ce lien n’est pas suivi par les moteurs de recherche, ce qui évite la transmission du PR … y en a que ça énerve d’ailleurs le nofollow
Pour commencer par supprimer l’intérêt de laisser un lien dans un commenatire, je me suis fait une fonction noFollow() dans /lib/myTools.php, qui prend en entrée du code html et réécrit en sortie tous les liens avec l’attribut rel= »nofollow ».

class myTools
{
  public static function noFollow ($str) {
    $str = stripslashes($str);
    $preg = "/<a href=\"(.*)\">(.*?)<\/a>/U";
    preg_match_all($preg, $str, $match);
    if(count($match[1]))
    {
        foreach ($match[1] as $key=>$val)
        {
            $pattern[] = '/'.preg_quote($match[0][$key],'/').'/';
            $replace[] = "<a href=\"".$val."\" rel=\"nofollow\">".$match[2][$key]."</a>";
        }
        return preg_replace($pattern, $replace, $str);
    }
    else
    {
       return $str;
    }
  }
}

J’ai ensuite réécrit l’affichage des commentaires en changeant ce passage à la fin de _commentView.php

<?php
  echo __('<span>%1%</span>, <a href="#sf_comment_%2%">%3%</a>',
    array(
      '%1%' => myTools::noFollow($author),
      '%2%' => $comment['Id'],
      '%3%' => $date
    )
  )
?>
<div>
  <?php echo myTools::noFollow($comment['Text']); ?>
</div>

En stockant ensuite ce fichier au niveau de mon application /apps/myapp/modules/sfComment/templates/_commentView.yml

Après ça je n’ai toujours pas réglé réellement le problème du spam … les bots des spamers ayant une approche pas très fine, ils ne prendront pas la peine de vérifier si leurs liens sont bien suivables par les moteurs de recherche dans les commentaires qu’ils ont laissés … en revanche ils vont repasser à intervalles réguliers ce qui est très désagréable!!

formulaire javascript

J’ai donc testé une des solutions js proposées sur cette page en remplacant les balise de formulaires dans /apps/myapp/modules/sfComment/templates/_commentForm.php par

...
<script language="JavaScript" type="text/javascript">
    document.write('<?echo form_tag('sfComment/'.$action, $options);?>');
</script>
...
<script language="JavaScript" type="text/javascript">
    document.write('</form>');
</script>
...

Naïf et rapide mais pas suffisant :-/

Captcha

Pour régler définitivement le problème j’ai mis en place sfCryptographpPlugin.
Comme la doc laisse un peu à désirer, voici une version traduite et adaptée de Howto do a Captcha in Symfony

installation

symfony plugin-install http://plugins.symfony-project.com/sfCaptchaPlugin

activer le module dans le settings.yml de l’application

all:
  .settings:
    enabled_modules: [default, sfCaptcha]

Personnellement je n’avais ni jpgraph_antispam-digits.class.php, ni jpgraph.class.php dans le répertoire lib/ du plugin je l’ai donc téléchargé ici https://trac.anl.gov/scavenger/browser/trunk/web/jpgraph/src/jpgraph_antispam-digits.php … en le sauvant dans lib/jpgraph_antispam-digits.class.php du plugin et changé:

require_once 'jpgraph_antispam.class.php';

en

require_once 'jpgraph_antispam-digits.class.php'

L’idée c’est que dans l’action qui doit afficher le captcha on le sauve (le captcha) dans une session pour ensuite l’afficher dans le tempate. J’ai donc ajouté le code suivant dans les actions qui affichent des posts de blog ou des pages. Vu que le captacha est sauvé session il sera forcément le même pour tous les posts lors d’un affichage par liste :-/

$g = new Captcha();
$this->getUser()->setAttribute('captcha', $g->generate());
<span style="font-family: verdana;">...</span>

il suffit maintenant d’afficher le captcha dans le template d’affichage de formulaire de commentaires que nous avons déjà modifié tout à l’heure, en ajoutant

<div class="required">
  <img src="<?php echo url_for('sfCaptcha/index'); ?>" alt="captcha" />
  &nbsp; &nbsp; &nbsp;
  <?php echo form_error('captcha'); ?>
  <?php echo input_tag('captcha',''); ?>
</div>

Il reste à modifier le validateur anonymousComment.yml en ajoutant le contrôle du captcha

captcha:
  required:
    msg: Please enter the numbers in the captcha image
  captchaValidator:
    error: Incorrect code

reste à effacer le cache du projet

symfony cc

et le captcha devrait fonctionner

Au passage un petit tips qui sert bien quand on joue avec les plugins dans symfony : How to fix a manually deleted plugin directory

optimiser la navigation multilingue et le référencement avec symfony en ne touchant pas aux urls des link_to existants, sachant que le site n’est que partiellement traduit, que l’internaute doit être notifié dans sa langue en cas de contenu non traduit, et que tous les objets du site ne sont pas forcément multilingues

référencement et internationalisation

Plusieurs paramètres permettent à Google de présager de la langue par défaut d’un site
1 – L’extension pays (.fr -> français, .it italien, etc …)
2 – Et en cas d’extension générique (.com, .org, .net, etc …) la géolocalisation de l’IP
Ce dernier point est à surveiller avec vigilance: un hébergeur comme http://1and1.fr qui possède une IP allemande est susceptible de vous attribuer une IP allemande pour un site a contenu exclusivement français … ce qui n’est pas conseillé par les tueurs du référencement qui m’ont fait la formation référencement naturelle
Le meilleur moyen de veiller au grain est encore d’installer FlagFox, une extension firefox indispensable qui affiche le drapeau du pays où est hébergé une page dans la barre d’url de votre navigateur (ainsi que beaucoup plus de détails via un simple clic sur le sus dit drapeau).

Bref une fois que la langue par défaut, le nom de domaine et éventuellement la géolocalisation sont en accord, il s’agit de gérer les autres langues disponibles de manière claire.
En gros j’ai retenu qu’il y avait deux écoles:
1 – Un sous domaine par langue comme dans ce post – symfonians en VF
2 – Un répertoire dans l’url par langue comme je vais l’exposer dans ce billet
D’après ce que j’ai compris on pourrait aussi faire figurer la langue dans le stripped_title des url réécrites par exemple

Pour toute la suite on travaille sur un site en .fr (donc google s’attend par défaut à du français), une application nommée back, et les trois langues gérées sont le français l’anglais et le chinois

N.B le stripped_title est généré via la fonction stripText suivante /lib/myTools.php

public static function stripText($text)
{
   $text = preg_replace('/\ +/', '-', $text);
   $text = preg_replace('/\-$/', '', $text);
   $text = preg_replace('/^\-/', '', $text);
   return $text;
}

faire apparaitre la culture dans l’url

il s’agit ici de ne pas utiliser la variable d’url sf_culture qui courcircuiterait la gestion de la culture et compliquerait pas mal les chose …
Je propose plutot une routing rule par culture /apps/back/config/routing.yml

sf_cms_content_fr:
  url:   /:stripped_title.html
  param: { module: sfCmsContent, action: show }
sf_cms_content_en:
  url:   /en/:stripped_title.html
  param: { module: sfCmsContent, action: show }
sf_cms_content_zh:
  url:   /zh/:stripped_title.html
param: { module: sfCmsContent, action: show }

les link_to s’écrivent alors comme suit

<?php link_to('link to content', '@sf_cms_content_'.$sfCmsContent->getCulture().'?stripped_title='.$sfCmsContent->getStrippedTitle());?>

L’idée est donc que l’on a ou non une langue par défaut qui ne fait pas l’objet d’un « préfixe culture » dans l’ur
On peut stocker la cultutre éventuelle par défaut dans /config/app.yml

lang:
  default: fr

navigation multilingue

le changement de culture se fait via une action associé à l’utilisateur /apps/back/modules/sfCmsUser/actions/actions.class.php

class sfCmsUserActions extends autosfCmsUserActions

{
   public function executeLanguage() {
      $this->getUser()->setCulture($this->getRequestParameter('culture'));
      $url = $this->getRequest()->getReferer() != '' ? $this->getRequest()->getReferer() : '@homepage';
      $this->redirect($url);
   }
}

L’affichage des drapeaux se fait comme suit /apps/back/modules/sfCmsLang/tmeplates/_default.php

<?php if( count( sfConfig::get('app_lang_back') ) > 1):?>
   <?php foreach(sfConfig::get('app_lang_back') AS $lg => $lang):?>
      <?php if($lg==$sf_user->getCulture()):?>
         <?php echo image_tag('lang/'.$lg.'_shadow',array('alt'=> $lang, 'title'=>$lang))?>
      <?php else:?>
         <?php echo link_to(image_tag('lang/'.$lg,array('alt'=> $lang, 'title'=>$lang)), 'sfCmsUser/language?culture='.$lg)?>
      <?php endif?>
   <?php endforeach?>
<?php endif?>

Notez la soumission par méthode get qui permet aux moteur de recherche d’indexer le contenu multilingue
Enfin j’ai retouché la classe SfCmsContent comme suit dans /lib/model/SfCmsContent.php

class SfCmsContent extends BaseSfCmsContent
{
  public function hydrate(ResultSet $rs, $startcol = 1)
  {
    parent::hydrate($rs, $startcol);
    $this->setCulture(sfContext::getInstance()->getUser()->getCulture());
    $lang = array_keys(sfConfig::get('app_lang_'.sfConfig::get('sf_app')));
    $lg = array_pop($lang);
    while($this->getTitle()=='' && $lg )
    {
      $this->setCulture($lg);
      $lg = array_pop($lang);
    }
  }

  public function isTranslated($lg)
  {
    $c = new Criteria();
    $c->add(SfCmsContentI18nPeer::CULTURE, $lg);
    $c->addAnd(SfCmsContentI18nPeer::SF_CMS_CONTENT_ID, $this->getId());
    $sfCmsContentI18n = SfCmsContentI18nPeer::doSelectOne($c);
    if($sfCmsContentI18n && $sfCmsContentI18n->getTitle() && $sfCmsContentI18n->getStrippedTitle())
    {
      return $sfCmsContentI18n;
    }
    else
    {
      return false;
    }
  }
}

La réécriture de la méthode hydrate permet d’avoir l’objet sfCmsContent dans la culture la plus adaptée à celle de l’internaute (notez que l’ordre des cultures à un sens)
La méthode isTranslated permet de connaître la disponibilité d’un objet sfCmsContent pour une culture …

gérer la cohérence de la langue dans l’url / éviter le duplicate content

Maintenant le problème est de gérer la cohérence des urls, en utilisant correctement les routing rules énoncées plus haut, il y a une bonne partie du travail de fait … le seul problème qui se pose est celui de la culture par défaut qui n’a pas de préfixe. La conséquence est que les urls des cultures autres que par défaut répondent sur toute leur routing rule … et même sion a bien soigné la génération des liens en amont, mieux vaut se préserver du duplicate content et éviter les blagues. Voici donc un validateur pour l’action show qui va vérifier

• que l’url contient bien un stripped_title et non pas un simple identifiant
• la disponibilité du contenu dans la culture de l’utilisateur (en le notifiant si le contenu n’est pas disponible)
• la cohérence entre la culture du stripped_title du contenu et celle de l’utilisateur
• la cohérence entre la culture du préfixe et celle du stripped_title

public function validateShow()
{

  // l'url contient bien un stripped_title et non pas un simple identifiant
  if($this->getRequestParameter('id'))
  {
    $sfCmsContent = SfCmsContentPeer::retrieveByPk($this->getRequestParameter('id'));
    $this->redirect('@sf_cms_content_'.$this->getUser()->getCulture().'?stripped_title='.$sfCmsContent->getStrippedTitle());
  }
  elseif($this->getRequestParameter('stripped_title'))
  {
    $sfCmsContent = SfCmsContentPeer::retrieveByStrippedTitle($this->getRequestParameter('stripped_title'));
    if($this->getUser()->can($sfCmsContent, 'show'))
    {
      $c = new Criteria();
      $c->add(SfCmsContentI18nPeer::STRIPPED_TITLE, $this->getRequestParameter('stripped_title'));
      $sfCmsContentI18nFromStrippedTitle = SfCmsContentI18nPeer::doSelectOne($c);

      // disponibilité du contenu dans la culture de l'utilisateur (en le notifiant si le contenu n'est pas disponible)
      if($sfCmsContent->isTranslated($this->getUser()->getCulture()))
      {
        $this->getUser()->setAttribute('translation_missing', false);
      }
      else
      {
        $this->getUser()->setAttribute('translation_missing', true);
      }

      // cohérence entre la culture du stripped_title du contenu et celle de l'utilisateur
      if($sfCmsContentI18nFromStrippedTitle->getCulture()!=$this->getUser()->getCulture())
      {
        if($sfCmsContent->isTranslated($this->getUser()->getCulture()))
      	 {
      	   $c = new Criteria();
      	   $c->add(SfCmsContentI18nPeer::SF_CMS_CONTENT_ID, $sfCmsContentI18nFromStrippedTitle->getSfCmsContentId());
      	   $c->addAnd(SfCmsContentI18nPeer::CULTURE, $this->getUser()->getCulture());
      	   $sfCmsContentUserCulture = SfCmsContentI18nPeer::doSelectOne($c);
      	   $this->redirect('@sf_cms_content_'.$this->getUser()->getCulture().'?stripped_title='.$sfCmsContentUserCulture->getStrippedTitle());
      	  }
       }
       // cohérence entre la culture du préfixe et celle du stripped_title
      	$uri = split('/',$this->getRequest()->getPathinfo());
    	if(strlen($uri[1])==2)
    	{
	  $uri_language = $uri[1];
    	}
    	elseif(sfConfig::get('app_lang_default'))
    	{
	  $uri_language = sfConfig::get('app_lang_default');
    	}
    	if(sfConfig::has('app_lang_default') && $uri_language != $sfCmsContentI18nFromStrippedTitle->getCulture())
    	{
	  $this->redirect('@sf_cms_content_'.$sfCmsContentI18nFromStrippedTitle->getCulture().'?stripped_title='.$sfCmsContentI18nFromStrippedTitle->getStrippedTitle());
    	}
     }
     return true;
   }
   else
   {
     $this->forward404();
   }
 }
}

Comme on a pris soin de mettre une notification si le contenu n’est pas disponible dans la culture souhaité, il ne reste plus qu’à l’afficher, avec un petit effet scriptaculous histoire d’attirer l’attention de l’internaute
/apps/back/modules/sfCmsContent/templates/showSuccess.php

<?php if($sf_user->getAttribute('translation_missing')):?>
   <p id="missing_translation">
      <?php echo __('The content you are looking for is missing for your language')?>
   </p>
   <?php echo javascript_tag(
      visual_effect('highlight', 'missing_translation',
         array(
            'duration' => 2
         )
      )
   )?>
<?php endif?>
<?php echo $sfCmsContent->getHtmlBody();?>

N.B pour chaque nouvel objet multilingue il faudra

• ajouter une routing rules par culture
• réécrire les méthode hydrate et isTranslated
• adapter le validateur validateShow
• modififer le template pour faire apparaître la notification

<?php class sfGooglebotNotifierFilter extends sfFilter
{
   public function execute($filterChain)
   {
      if (preg_match('#Googlebot#i', $this->getContext()->getRequest()->getHttpHeader('User-Agent')))
      {
         $mail = new sfMail();
         $mail->initialize();
         $mail->setMailer('sendmail');
         $mail->setCharset('utf-8');
         $mail->setSender('mailer@monsite.com', 'mailer de monsite.com');
         $mail->setFrom('mailer@monsite.com', 'mailer de monsite.com');
         $mail->addAddress('your@mail.com');
         $mail->setSubject('Google bot visit');
         $mail->setBody($this->getContext()->getRequest()->getHttpHeader('User-Agent').' has visited '.$this->getContext()->getRequest()->getUri());
         $mail->send();
      }
      $filterChain->execute();
   }
}
 ?>

N.B. Les passages du googlebots sont aussi disponibles dans les rapports de Googel Analytics ( visiteurs, capacités du navigateur, navigateurs).
à intégrer comme suit dans /apps/myapp/config/filters.yml

rendering: ~
web_debug: ~
sf_googlebot_notifier:
  class: sfGooglebotNotifierFilter
security:  ~
# generally, you will want to insert your own filters here
cache:     ~
common:    ~
flash:     ~
execution: ~

J’allais oublier un gand merci au même William Durand pour son autre post SyntaxHighlighter, TinyMCE et YML, qui m’a permis d’intégrer la coloration syntaxique YAML à syntaxHighlighter2 via la brush qu’il a conçue

autre ressource: http://alexgorbatchev.com/wiki/SyntaxHighlighter:Brushes:Custom

C’est pourquoi il est maintenant possible de connaître la popularité d’un plugin symfony avant de l’intégrer à son projet

La liste de mes préférés:

• sfLucenePlugin
• sfPropelActAsTaggableBehaviorPlugin
• sfPropelActAsRatableBehaviorPlugin
• sfThumbnailPlugin
• sfTagtoolsPlugin
• sfFeed2Plugin
• sfPropelActAsCommentableBehaviorPlugin
• sfPropelVersionableBehaviorPlugin
• sfSimpleForumPlugin

N.B. ce sont mes plugins préférés pour symfony 1.0 … je ne désepère pas de trouver 24h00 pour me fader jobeet et passer à la 1.2:-/