Miximum » php

Indexer Wikipédia dans Solr

thibault — Mon, 25 Oct 2010 16:53:17 +0000

Drôle d’époque. Après deux jours magiques à ParisWeb, et un retour chez moi dans une ambiance de guerre civile, le retour à la réalité est… difficile.

La reprise du quotidien après un tel événement est toujours une période cafardogène. Pour éviter de sombrer dans la déprime la plus grise, je vous propose de nous fixer un objectif un tantinet ambitieux : et si nous indexions la plus grande base de connaissance au monde dans le meilleur moteur de recherche ? (Si ça ne vous plait pas, vous pouvez plutôt vous abonner au tag #sudweb.)

Chercher dans Wikipédia grâce à Solr ? Si, c’est possible.

Des données, des données, des données…

Wikipédia fournit régulièrement des fichiers de dumps permettant de récupérer toutes les données du site. Nous nous contenterons de récupérer les articles complets (sans les révisions, ni les commentaires), et en français uniquement. Je vous mâche le travail, il n’y a qu’un seul fichier à récupérer.

Configurer le schéma

La documentation de Solr fournit un exemple de schéma pour indexer Wikipedia. Nous allons l’optimiser pour prendre en compte la langue française (je pars ici d’une install vierge de Solr).

Commençons par ajouter un nouveau fieldtype : text_fr, dans le fichier schema.xml.

 name="text_fr" class="solr.TextField">
   type="index">
     class="solr.StandardTokenizerFactory"/>
     class="solr.SynonymFilterFactory" synonyms="synonyms_fr.txt" ignoreCase="true" expand="true"/>
     class="solr.StandardFilterFactory"/>
     class="solr.StopFilterFactory" ignoreCase="true" words="stopwords_fr.txt"/>
     class="solr.WordDelimiterFilterFactory" generateWordParts="1" generateNumberParts="1" catenateWords="1" catenateNumbers="1" catenateAll="0" splitOnCaseChange=
     class="solr.ISOLatin1AccentFilterFactory"/>
     class="solr.LowerCaseFilterFactory"/>
     class="solr.SnowballPorterFilterFactory" language="French" protected="protwords_fr.txt" />
  >
   type="query">
     class="solr.StandardTokenizerFactory"/>
     class="solr.SynonymFilterFactory" synonyms="synonyms_fr.txt" ignoreCase="true" expand="true"/>
     class="solr.StandardFilterFactory"/>
     class="solr.StopFilterFactory" ignoreCase="true" words="stopwords_fr.txt"/>
     class="solr.WordDelimiterFilterFactory" generateWordParts="1" generateNumberParts="1" catenateWords="0" catenateNumbers="0" catenateAll="0" splitOnCaseChange=
     class="solr.ISOLatin1AccentFilterFactory"/>
     class="solr.LowerCaseFilterFactory"/>
     class="solr.SnowballPorterFilterFactory" language="French" protected="protwords_fr.txt" />
  >
>

Vous remarquerez que ce type de champ nécessite trois fichiers pour fonctionner.

synonyms_fr.txt, pour gérer les synonymes dans l’indexation. Exemple :
```
aiki => aikido
resto => restaurant
```
stopwords_fr.txt, contient la liste des mots basiques qui ne doivent pas être indexés ;
protwords_fr.txt, contient la liste des mots qui ne doivent pas être retraités par le stemmer français ;

Ensuite, toujours dans le même fichier, configurons nos fields :

>
   name="id"        type="string" indexed="true" stored="true" required="true"/>
 
   name="title"     type="string"     indexed="false" stored="true"/>
   name="search_title"     type="text_fr"     indexed="true" stored="false"/>
   name="body"    type="text_fr"    indexed="true" stored="true" termVectors="true"/>
 
   name="revision"   type="sint"    indexed="true" stored="true"/>
   name="user"        type="string"  indexed="true" stored="true"/>
   name="userId"     type="int" indexed="true" stored="true"/>
   name="timestamp" type="date"    indexed="true" stored="true"/>
 >
 
 >id>
 >search_title>
  source="title" dest="search_title"/>

Notez que l’on stocke le corps de l’article. C’est parce que nous allons utiliser les results highlighting. Si vous n’avez pas besoin de cette fonctionnalité, remplacez « stored=true » par « stored=false ».

Et on importe

Nous aurions pu décider de convertir le fichier xml de wikidédia en sql, de l’importer dans une base, et d’utiliser un sql import handler. Mais pourquoi se compliquer la tâche ? Solr peut importer directement du xml. Configurons notre import de données dans le fichier data-config.xml :

>
     type="FileDataSource" encoding="UTF-8" />
    >
     name="page"
        processor="XPathEntityProcessor"
        stream="true"
        forEach="/mediawiki/page/"
        url="/var/www/solrdemo/dumps/frwiki-latest-pages-articles.xml"
        transformer="RegexTransformer,DateFormatTransformer"
        >
         column="id"    xpath="/mediawiki/page/id" />
         column="title"     xpath="/mediawiki/page/title" />
         column="body"      xpath="/mediawiki/page/revision/text" />
         column="revision"  xpath="/mediawiki/page/revision/id" />
         column="user"      xpath="/mediawiki/page/revision/contributor/username" />
         column="userId"    xpath="/mediawiki/page/revision/contributor/id" />
         column="timestamp" xpath="/mediawiki/page/revision/timestamp" dateTimeFormat="yyyy-MM-dd'T'hh:mm:ss'Z'" />
         column="$skipDoc"  regex="^(?i)#redirect.*" replaceWith="true" sourceColName="text"/>
       >
    >
>

Redémarrez Solr, lancez l’indexation, attendez (une heure ou deux), et paf ! 2400000 document indexés, ce qui vous en conviendrez est plus que suffisant pour s’amuser.

Un peu de result highlighting

Étant donné que nous disposons d’un sacré paquet de texte, autant en profiter un peu, non ? (oui, j’ai des loisirs de geeks). Au hasard, je vous propose de mettre en place un peu de result highlighting^[1] .

Bon, alors pour ceux qui aiment bien avoir un retour visuel, ça pourrait ressembler à ça :

Pour ce faire, nous allons utiliser les paramètres qui vont bien, et que je vous propose ci-dessous sous forme de tableau php (et tant pis pour les pythoneux, faudra s’en contenter^[2] ).

$req = array(
  'q' => 'Ma recherche',
  'qt' => 'dismax', // Nous envoyons directement le contenu du formulaire à Solr, par conséquent dismax est plus adapté
  'qf' => 'title^2 body', // On cherche dans title et body, avec une priorité plus importante pour le champ title
  'hl' => 'true', // Activitation de l'highlighting
  'hl.fl' => 'title,body',  // Seuls ces champs seront pris en compte pour la surbrillance
  'f.body.hl.alternateField' => 'body',  // Si aucun snippet n'est trouvé dans le champ body, on renvoie le champ complet
  'hl.fragsize' => 150,  // Les snippets font 150 caractères…
  'hl.snippets' => 3,  // … et on renvoie 3 snippets maxi 
  'hl.maxAlternateFieldLength' => 200,  // Si on renvoie le champ body comple, on limite à 200 caractères
  'hl.simple.pre' => '',  // On veut que notre surbrillance soit encadrée par des balises 'strong'
  'hl.simple.post' => '',
));

Si vous exécutez une requête contenant ces paramètres, vous noterez que la réponse est séparée en deux parties : d’un côté, les résultats, et de l’autre, les snippets générés. Vous remarquerez également que les snippets en question sont a peu près illisibles à l’œil nu, mais ça, c’est une autre histoire.

 version="1.0" encoding="UTF-8"?>
>
>
  >bla>
>
 name="response" numFound="50" start="0">
  >
     name="id">9>
     name="revision">2338009>
     name="timestamp">2002-10-31T09:16:01Z>
     name="title">Algèbre de boole>
  >
…
>
 name="highlighting">
   name="9">
     name="body">
      >
L' <em>alg&#232;bre</em> g&#233;n&#233;rale, ou <em>alg&#232;bre</em> abstraite, est la branche des math&#233;matiques qui porte principalement sur l'&#233;tude des structures <em>alg&#233;briques</em> et de leurs relations. L'appellation <em>alg&#232;bre</em> g&#233;n&#233;rale s'oppose &#224; celle dalg&#232;bre &#233;l&#233;mentaire ; cette derni&#232;re enseigne le calcul <em>alg&#233;brique</em>, c'est-&#224;-dire les r&#232;gles de manipulation des formules et des expressions <em>alg&#233;briques</em>.Historiquement, les structures <em>alg&#233;briques</em> sont apparues dans diff&#233;rents>
    >
  >
…

Parser la réponse sera finalement assez simple. Allez, je vous donne le code que j’utilise (pour les curieux, c’est du twig, mais ce serait pareil avec n’importe quel autre moteur de template).

 id="results">
  {% block results %}
    >{{ results.numFound }} résultats trouvés>
    >
    {% for doc in results.docs %}
      {% block doc %}
        >
           href="http://fr.wikipedia.org/wiki/{{ doc.title }}" />{{ doc.title }}>
          >
          {% for snippet in highlighting[doc.id].body %}
            {{ snippet }}…
          {% endfor %}
          >
        >
      {% endblock %}
    {% endfor %}
    >
  {% endblock %}
>
{% endif %}
>

Mais… Mais… Attendez ! C’est tout crade !

Ok, j’avoue, si vous avez vous même testé tout ça jusqu’ici, vous avez remarqué que le résultat n’est pas vraiment exploitable. Le texte que nous indexons, en effet, n’est pas du texte brut : il contient toutes les balises de formattage spécifiques du langage wiki de Wikipédia.

Dans notre cas, nous n’aurons jamais besoin de ces informations aussi l’idéal serait de pouvoir filtrer ces balises dés l’import des données.

Si vous aussi, vous lisez la documentation de Solr en famille le soir au coin du feu^[3], vous savez déjà que Solr propose des transformers (rien à voir avec les robots), qui permettent de filtrer les données lors de l’import.

D’ailleurs, si vous regardez le code du fichier data-config.xml que nous avons utilisé, il utilise déjà deux transformers. Tout ce que nous allons faire, c’est créer notre transformer custom. Allez hop ! Un peu de java ! Créez un fichier WikiTransformer.java

import java.util.*;
import java.io.*;
import info.bliki.wiki.filter.PlainTextConverter;
import info.bliki.wiki.model.WikiModel;
 
public class WikiTransformerAlt {
  public Object transformRow(Map<String, Object> row) {
    String body = (String)row.get("body");
 
    StringWriter writer = new StringWriter();
 
    WikiModel wikiModel = new WikiModel("http://www.mywiki.com/wiki/${image}", "http://www.mywiki.com/wiki/${title}");
    String plainStr = wikiModel.render(new PlainTextConverter(), body);
 
    row.put("body", plainStr);
 
    return row;
  }
}

Deux choses à noter : ce transformer n’est pas optimal, le nom du champ à parser (body) est codé en dur. Mais bon, ça ira pour cette fois (mais ne recommencez pas). Deuxième chose, j’utilise la librairie java gwtwiki pour faire le boulot de traduction wiki -> texte brut. Cette librairie est pour le moment lacunaire (ou alors je m’en sert mal), et le résultat ne sera pas parfait. Il faudra faire avec.

La compilation du fichier en .jar et son installation sortent du scope de cet article, aussi je vous laisse utiliser votre moteur de recherche favori… Bon, ok, je vous file les commandes :

javac -cp "/path/vers/bliki/info.bliki.wiki/bliki-core/target/*" WikiTransformer.java
jar -cf WikiTransformer.jar WikiTransformer.class
cp WikiTransformer.jar path/vers/solr/work/Jetty_0_0_0_0_8983_solr.war__solr__k1kf17/webapp/WEB-INF/lib/

Notez le chemin de destination pas trés conventionnel : c’est le seul endroit ou l’autoload semble capter le jar. Si un expert java passe par là et peut m’expliquer…

Il ne nous reste plus qu’à mettre à jour notre fichier de configuration d’import, et à relancer l’indexation :

>
     type="FileDataSource" encoding="UTF-8" />
    >
     name="page"
        processor="XPathEntityProcessor"
        stream="true"
        forEach="/mediawiki/page/"
        url="/var/www/solrdemo/dumps/frwiki-latest-pages-articles.xml"
        transformer="RegexTransformer,DateFormatTransformer,WikiTransformer"
        >
         column="id"    xpath="/mediawiki/page/id" />
         column="title"     xpath="/mediawiki/page/title" />
         column="body"      xpath="/mediawiki/page/revision/text" />
         column="revision"  xpath="/mediawiki/page/revision/id" />
         column="user"      xpath="/mediawiki/page/revision/contributor/username" />
         column="userId"    xpath="/mediawiki/page/revision/contributor/id" />
         column="timestamp" xpath="/mediawiki/page/revision/timestamp" dateTimeFormat="yyyy-MM-dd'T'hh:mm:ss'Z'" />
         column="$skipDoc"  regex="^(?i)#redirect.*" replaceWith="true" sourceColName="body"/>
       >
    >
>

Et voilà, vous disposez de votre propre moteur de recherche Wikipedia. Les raffinements possibles sont nombreux, je laisse votre imagination vous guider. En attendant, rendez-vous au prochain SudWeb.

Notes :

Pour les francophones acharnés, surbrillance des résultats, mais c’est moche [retour]
Notez comme s’extériorise ma haine et ma jalousie envers les gens qui ont la chance de travailler avec un vrai langage de programmation [retour]
Allez, avouez, je sais que vous le faites [retour]

Comment PHP me rends fou

thibault — Fri, 12 Mar 2010 18:07:21 +0000

Chers amis développeurs bonsoir. Je vous écris car je souhaite soumettre à votre sagacité un problème étrange. À défaut de pouvoir me venir en aide (seule ma dignité m’empêche encore de verser des larmes de frustration), peut-être au moins cela vous fera-t-il marrer. Je suis victime d’une version particulièrement vicieuse du bug de 17h30 (avec un combo « bug du vendredi de fin d’itération » compte triple).

Projet symfony. Je code, tout se déroule bien, fin de semaine, je balance mon code sur le serveur de recette, et je jette un coup d’œil sur l’environnement de prod. Horreur ! Page blanche ! Je vérifie la même page sous l’environnement de dev. Elle s’affiche correctement.

Je jette un coup d’œil dans la log apache :

child pid 16813 exit signal Segmentation fault (11)

Un sentiment d’immense lassitude m’envahit aussitôt.

Après une longue et pénible session profilage / debugage avec xdebug, je finit par circonvenir plus ou moins l’endroit du problème, et parviens même à le reproduire à l’envie. Vous allez voir, c’est surprenant :

$category = Article->getCategory(); // objet de classe 'Category'
echo $category;  // Affiche le titre de la catégorie
printf('%s', $category); // Page blanche, segfault, sacrifice de chatons, etc.

Amusant, non ? Après quelques recherches, il semblerait que dans le contexte d’une fonction *printf, php n’utilise pas la fonction magique __toString().

Je teste donc :


 
class Toto
{
  private $tata;
 
  public function __construct($tata)
  {
    $this->tata = $tata;
  }
 
  public function __toString()
  {
    return (string) $this->tata . "\n";
  }
}
 
$toto = new Toto('tutu');
echo $toto;
printf('%s', $toto);
 
// tutu
// tutu

WTF ? Mais ça marche trés bien ! C’est donc un problème spécifique à mon code ? Je poursuis mon débuggage, et j’arrive ici :

$category = $article->getCategory();
// $category est de la classe sfOutputEscaperIteratorDecorator
// qui hérite de sfOutputEscaperObjectDecorator
// qui définit une fonction __toString()
 
printf('%s', $category);
// Appelle sfOutputEscaperObjectDecorator::__toString

Bon, allons voir sur place ce qui ne va pas.

class sfOutputEscaperObjectDecorator
{
…
  public function __toString()
  {
    // Jusqu'ici, tout va bien, mais dés l'instruction return, ça plante
    return $this->escape($this->escapingMethod, $this->value->__toString());
  }
 
  // Je modifie donc la fonction pour obtenir ceci :
  public function __toString()
  {
    $value = $this->escape($this->escapingMethod, $this->value->__toString());
    var_dump(gettype($value));
    var_dump($value);
    die();
    return $value;
  }
 
// J'obtiens pour affichage :
// 'String'
// 'Titre de ma catégorie'
 
// En revanche :
 
  public function __toString()
  {
    $value = $this->escape($this->escapingMethod, $this->value->__toString());
    var_dump(gettype($value));
    var_dump($value);
    // die();
    return $value;
  }
 
// Page blanche. Continuons dans l'étrange, avec quelques modifications de la même méthode :
 
  public function __toString()
  {
    $value = $this->escape($this->escapingMethod, $this->value->__toString());
    die('ici'); // Affiche 'ici'
    return 'toto';
  }
 
  public function __toString()
  {
    return 'toto'; // Affiche 'toto'
  }
 
  public function __toString()
  {
    $value = $this->escape($this->escapingMethod, $this->value->__toString());
    return 'toto'; // Page blanche
  }
}

Tout ça, bien sûr, c’est sur l’environnement de prod. En dev, tout se passe toujours normalement.

J’en suis là. Si quelqu’un a une bonne explication. En attendant, je crois que je vais aller me coucher de bonne heure. Bon week-end à tous.

Symfony form : pick or create

thibault — Tue, 02 Feb 2010 14:40:29 +0000

Here’s an other tutorial about the Symfony form framework. Last time, we managed to make embedded i18n forms optionals. In today’s howto, we will talk about embedded forms again.

In the last tutorials, we created a form to edit news. Today we will create another form to write interviews. An interview is just an article about a celebrity. So our Interview class will inherit from our Article one, so we can reuse our last time work.

Here’s the complete schema we will work with :

Article:
  actAs:
    Timestampable: ~
    I18n:
      fields: [ title, body ]
      actAs:
        Sluggable: { fields: [ title ], uniqueBy: [ lang, title ] }
 
  columns:
    title: { type: string(255), notnull: true }
    body: { type: clob, notnull: true }
    author: { type: string(255), notnull: false }
 
News:
  inheritance:
    extends: Article
    type: concrete
 
Celebrity:
  actAs:
    Sluggable:
      fields: [ firstname, lastname ]
  columns:
    firstname: { type: string(255), notnull: true }
    lastname: { type: string(255), notnull: true }
 
Interview:
  inheritance:
    extends: Article
    type: concrete
 
  columns:
    celebrity_id: { type: integer, notnull: true }
 
  relations:
 
    Celebrity:
      local: celebrity_id
      foreign: id
      type: one
      foreignType: one
      foreignAlias: Interviews

And the fixtures :

Interview:
  i1:
    Author: 'Thibault J.'
    Celebrity:
      firstname: Thibault
      lastname: Jouannic
    Translation:
      fr:
        title: Auto-interview
        body: |
          Bla bla bla question et réponses

As usual…

php symfony build --all --and-load
php symfony doctrine:generate-admin backend Interview

Before we start

Before we start, let’s stop and think a few seconds. How do we want to manage our celebrity relation into our form ? Take a look at the default form, without any modification :

Quite bad, isn’t it ? We could make a little better by adding a toString method.

// lib/model/doctrine/Celebrity.class.php
 
class Celebrity extends BaseCelebrity
{
  public function __toString()
  {
    return sprintf('%s %s', $this->getFirstname(), $this->getLastname());
  }
}

That’s a bit better. The problem with this form is that you cannot add a new celebrity. If you want to create a new interview, you’ll have to chose among the existing celebrities. Of course, you could create an other admin module to manage celebrities, but a good programmer is a lazy one. And that would be great if we could create a new celebrity directly in the interview form.

In fact, that’s quite easy, using the embedRelation function.

// lib/form/doctrine/InterviewForm.class.php
class InterviewForm extends BaseInterviewForm
{
  /**
   * @see ArticleForm
   */
  public function configure()
  {
    parent::configure();
 
    unset($this['celebrity_id']);
    $this->embedRelation('Celebrity');
  }
}

Here’s the result, which is quite relevant to what we wanted. But !? Wait ! There is a regression. What if we want to choose among existing celebrities, the way we used to do ? What we really need is a way to combine both methods actually. We need to be able to choose an existing celebrity OR to create a new one.

Pick or create

We will have to use an intermediate form.

// lib/form/doctrine/InterviewForm.class.php
class InterviewForm extends BaseInterviewForm
{
  /**
   * @see ArticleForm
   */
  public function configure()
  {
    parent::configure();
 
    unset($this['celebrity_id']);
 
    $celebrityId = $this->getObject()->isNew() ? NULL : $this->getObject()->getCelebrity()->getId();
    $form = new InterviewCelebrityForm(array(), array('celebrity_id' => $celebrityId));
    $this->embedForm('Celebrity', $form);
  }
}
 
// lib/form/doctrine/InterviewCelebrityForm.class.php
class InterviewCelebrityForm extends sfForm
{
  public function configure()
  {
    $this->widgetSchema['celebrity_id'] = new sfWidgetFormDoctrineChoice(array(
      'model' => 'Celebrity',
      'add_empty' => true
    ));
 
    $this->setDefault('celebrity_id', $this->getOption('celebrity_id'));
 
    $form = new CelebrityForm();
    $this->embedForm('new_celebrity', $form);
 
    $this->widgetSchema->setLabel('celebrity_id', 'Choose one…');
    $this->widgetSchema->setLabel('new_celebrity', 'or create a new.');
  }
}

Try to edit the existing interview, and look at the nice result. However, if you try to save the form, you’ll have a lot of validations errors. There is still some work to do before we can get rid of all those red alerts.

Form validation

The form validation strategy is quite simple. If an existing celebrity is chosen with the drop down list, the firstname and lastname should be ignored. If the list is empty, we must validate the firstname and lastname. At last, we must throw an error if all the fields are empty.

// lib/form/doctrine/InterviewCelebrityForm.class.php
 
    // add this  at the end of the configure() function
    $this->validatorSchema['celebrity_id'] = new sfValidatorPass();
 
    $celebrityValidatorSchema = clone $this->validatorSchema['new_celebrity'];
    $this->validatorSchema['new_celebrity'] = new sfValidatorPass();
 
    $this->validatorSchema->setPostValidator(
      new sfValidatorAnd(array(
        new sfValidatorOr(array(
          new sfValidatorSchemaFilter('celebrity_id', new sfValidatorDoctrineChoice(array(
            'model' => 'Celebrity',
            'required' => true
          ))),
          new sfValidatorSchemaFilter('new_celebrity', $celebrityValidatorSchema)
        )),
        new sfValidatorCallback(array(
          'callback' => array($this, 'checkCelebrity')
        ))
      ))
    );
 
  // add this function into the class
  /**
   * Either who choose an existing celebrity, either we create a new one
   *
   * Unset values according to the choice we made
   **/
  public function checkCelebrity($validator, $values, $argument)
  {
    if(!empty($values['celebrity_id']))
    {
      unset(
        $this['new_celebrity'],
        $values['new_celebrity']
      );
    }
    else
    {
      unset(
        $this['celebrity_id'],
        $values['celebrity_id']
      );
    }
 
    return $values;
  }

Try differents combinations to submit your form. The validation should behave correctly now.

Saving your form

You may have noticed that our interview isn’t updated correctly after we submit the form. We will have to override the doUpdateObject method in order to update the object correctly on form validation.

// lib/form/doctrine/InterviewForm.class.php
  public function doUpdateObject($values)
  {
    if(!empty($values['Celebrity']['celebrity_id']))
    {
      $this->getObject()->setCelebrityId($values['Celebrity']['celebrity_id']);
    }
    else
    {
      $celebrity = new Celebrity();
      $celebrity->fromArray($values['Celebrity']['new_celebrity']);
      $this->getObject()->Celebrity = $celebrity;
    }
 
    unset(
      $values['Celebrity'],
      $this['Celebrity']
    );
 
    parent::doUpdateObject($values);
  }

That’s it ! Everything should be alright now. But just to make sure, here’s a few tests.

Test your forms

We are reusing some code from the last day, so I just will output the new part here.

// test/function/backend/interviewActions.class.php
 

 
include(dirname(__FILE__).'/../../bootstrap/functional.php');
 
$browser = new sfBackendTestFunctional(new sfBrowser());
$browser->loadData();
$browser->setTester('doctrine', 'sfTesterDoctrine');
 
$interview = Doctrine::getTable('Interview')->
  createQuery('i')->
  leftJoin('i.Translation t')->
  andWhere('t.lang = ?', 'fr')->
  orderBy('i.id', 'asc')->
  fetchOne();
 
$celebrity = new Celebrity();
$celebrity->setFirstname('toto');
$celebrity->setLastname('tutu');
$celebrity->save();
 
$editUrl = sprintf('/interview/%s/edit', $interview->getId());
 
$browser->
  get('/interview')->
  with('response')->begin()->
    isStatusCode(200)->
  end()->
 
  info('1 - Interview list')->
  with('response')->begin()->
    checkElement('h1', '/Interview List/')->
    checkElement('body', '/Thibault Jouannic/')->
  end()->
 
// …
 
   info('  2.8 - The current celebrity is already selected')->
  get($editUrl)->
  with('response')->begin()->
    checkElement('#interview_Celebrity_celebrity_id option[selected="selected"]', sprintf('/%s/', $interview->getCelebrity()))->
  end()->
 
  info('  2.9 - The current celebrity can be updated')->
  get($editUrl)->
  click('Save', array('interview' => array(
    'Celebrity' => array(
      'celebrity_id' => $celebrity->getId()
      )
    )), array('_with_csrf' => true)
  )->
  with('form')->begin()->
    hasErrors(0)->
  end()->
 
  with('doctrine')->begin()->
    check('Interview', array(
      'id' => $interview->getId(),
      'celebrity_id' => $celebrity->getId()
    ))->
    info('  2.10 - Updating the celebrity does not create empty records')->
    check('Celebrity', array(), 4)->
  end()->
 
  info('  2.11 - A new celebrity can be created')->
  get($editUrl)->
  click('Save', array('interview' => array(
    'Celebrity' => array(
      'celebrity_id' => '',
      'NewCelebrity' => array(
        'firstname' => 'oncle',
        'lastname' => 'picsou'
      )
    )
  )), array('_with_csrf' => true)
  )->
  with('doctrine')->begin()->
    check('Celebrity', array(), 5)->
    check('Interview', array(
      'id' => $interview->getId(),
      'celebrity_id' => $celebrity->getId() + 1
    ))->
  end()
;

That’s all folks ! See you soon.

Optional translation form for I18n objects with Symfony and Doctrine

thibault — Fri, 29 Jan 2010 14:23:20 +0000

photo credit : kevindooley

There are people around here claiming that the Symfony form framework is a gift from the gods. One might say that this statement is a bit exaggerated, but it’s true that the release of the 1.3/1.4 version of the Symfony brought many improvements, and yes, the form framework can save you a lot of time.

In one of my current project, I had to developp some basic CMS-like features. In a back-office, an admin should be able to writes different kind of articles (news, interviews…). Hey ! That’s a job for inheritance ! But wait, there’s more. Articles can be translated in several languages. Easy, with the Doctrine I18n behavior.

One last requirement : article translations are optional. One might publish an article in english, an other in french, and a third in both languages. This is a little more tricky, so let’s see how to do this.

Some references

Before we start, here are the wonderful ressources I read to get my way out :

http://prendreuncafe.com/blog/post/2009/11/29/Embedding-Relations-in-Forms-with-Symfony-1.3-and-Doctrine
http://symfonyguide.wordpress.com/2009/09/28/symfony-forms-saving-process/
http://vousavezchoisi.com/img/formsdiagram.png
http://www.symfony-project.org/more-with-symfony/1_4/en/06-Advanced-Forms#chapter_06_ignoring_embedded_forms
http://www.ze-technology.com/2009/06/05/tests-fonctionnels-avec-symfony-gerer-lidentification/

Let’s start with the schema

Article:
  actAs:
    Timestampable: ~
    I18n:
      fields: [ title, body ]
      actAs:
        Sluggable: { fields: [ title ], uniqueBy: [ lang, title ] }
 
  columns:
    title: { type: string(255), notnull: true }
    body: { type: clob, notnull: true }
    author: { type: string(255), notnull: false }
 
News:
  inheritance:
    extends: Article
    type: concrete

As it’s friday, I will also give you some fixtures :

News:
  n1:
    author: 'Fantomas'
    Translation:
      fr:
        title: 'OK, l''Ipad est sorti. Vous allez me foutre la paix maintentant ?'
        body: |
          Vous commencez serieusement à me gonfler avec vos articles et vos tweets sur
          une techno inutile et bardée de DRM.
 
  n2:
    author: 'Garcin Fony'
    Translation:
      fr:
        title: 'Sinon, à part ça, ça va ?'
        body: |
          Allez, pour me calmer, je vais me refaire un p'tit café

Let’s build the whole thing, and generate the admin in the same time.

php symfony doctrine:build --all --and-load
php symfony generate:app backend
php symfony doctrine:generate-admin backend News

Check the module admin we’ve just build. Click on the first « edit » button. Wait a minute ? The I18n fields are just missing, how are we gonna edit our articles ? If you’re not familiar with the I18n behavior, you must know that the content is split into two tables. The new table, « article_translation », holds all the I18n fields.

mysql> SELECT * FROM news;
+----+-------------+---------------------+---------------------+
| id | author      | created_at          | updated_at          |
+----+-------------+---------------------+---------------------+
|  1 | Fantomas    | 2010-01-29 12:14:46 | 2010-01-29 12:14:46 | 
|  2 | Garcin Fony | 2010-01-29 12:14:46 | 2010-01-29 12:14:46 | 
+----+-------------+---------------------+---------------------+
 
mysql> SELECT id, lang, title FROM news_translation;
+----+------+------------------------------------------------------------------+
| id | lang | title                                                            |
+----+------+------------------------------------------------------------------+
|  1 | fr   | OK, l'Ipad est sorti. Vous allez me foutre la paix maintentant ? | 
|  2 | fr   | Sinon, à part ça, ça va ?                                     | 
+----+------+------------------------------------------------------------------+

So, to be able to edit our translations, you have to embed the I18n forms, using the embedI18 function. Let’s do that.

// lib/form/doctrine/NewsForm.class.php
class NewsForm extends BaseNewsForm
{
  /**
   * @see ArticleForm
   */
  public function configure()
  {
    parent::configure();
    $this->embedI18n(array('fr', 'en'));
  }
}

Reload the edit page. Now you can edit your news in french and english. Pretty cool, isn’t it ?

Let’s refactor this mess

Since now, it’s been pretty easy. However, the code we’ve written is bad. It’s bad, for the following reasons :

Each time we will add a new article type (e.g. interview, etc.), we will have to update it’s configure method ;
Each time we will change the available languages (to add a new one, or disable an existing one), we will have to edit every forms ;

Fortunately, since Symfony 1.3, the form inheritance follow the model structure. Notice that NewsForm extends BaseNewsForm, which extends ArticleForm.

Let’s refactor our code :

# config/app.yml
all:
  cultures:
    enabled:
      fr: Français
      en: English

// lib/form/doctrine/NewsForm.class.php
 
// Revert the changes we added there
class NewsForm extends BaseNewsForm
{
  /**
   * @see ArticleForm
   */
  public function configure()
  {
    parent::configure();
  }
}
 
// lib/form/doctrine/ArticleForm.class.php
class ArticleForm extends BaseArticleForm
{
  /**
   * Available languages
   *
   * @var array $languages
   **/
  protected $langages;
 
  public function configure()
  {
    $this->languages = sfConfig::get('app_cultures_enabled');
 
    $langs = array_keys($this->languages);
 
    $this->embedI18n($langs);
    foreach($this->languages as $lang => $label)
    {
      $this->widgetSchema[$lang]->setLabel($label);
    }
  }
}

Reload the edit form. Now, no matter how many articles sub-types you add, you still can configure available languages from one place.

Translation edition

Let’s try our brand new admin module by editing a news. If you used the fixtures I provided, you should have a french article, with no english translation. Try to update the french version, and click on the ‘Save’ button.

This is a miserable failure. We can’t save the form, because the english fields are required. We’re stuck, we have to fill every translation for an article before we can save it. Wouldn’t it be nice if we could make a translation form optional ? Let’s add a requirement : if every fields in a translation form are empty, it just should be ignored.

To achieve this goal, we will update the doBind method. Here’s the new ArticleForm class.

// lib/form/doctrine/ArticleForm.class.php
class ArticleForm extends BaseArticleForm
{
  /**
   * Available languages
   *
   * @var array $languages
   **/
  protected $langages;
 
  public function configure()
  {
    $this->languages = sfConfig::get('app_cultures_enabled');
 
    $langs = array_keys($this->languages);
 
    $this->embedI18n($langs);
    foreach($this->languages as $lang => $label)
    {
      $this->widgetSchema[$lang]->setLabel($label);
    }
  }
 
  /**
   * Cleans and binds values to the current form
   *
   * Ignore i18n forms when all their fields are empty
   *
   * @see sfForm::doBind
   **/
  protected function doBind(array $values)
  {
    foreach($this->languages as $lang => $label)
    {
      if($this->embeddedI18nFormIsEmpty($values[$lang]))
      {
        unset(
          $values[$lang],
          $this[$lang]
        );
      }
    }
 
    parent::doBind($values);
  }
 
  /**
   * Check if every fields, except for id and lang, are empty
   **/
  protected function embeddedI18nFormIsEmpty(array $values)
  {
    foreach($values as $key => $value)
    {
      if(in_array($key, array('id', 'lang')))
        continue;
 
      if('' !== trim($value))
      {
        return false;
      }
    }
    return true;
  }
}

In the overidden doBind method, we check, for every I18n form, if some values has been submited. If not, we just unset the corresponding fields.

Reload the edit form, update the french translation, leave the english field empty, and click on ‘Save’. Hurray, the forms is saved correctly.

However, you should keep reading, because you’re gonna have a surprise. Let’s look into the database.

mysql> SELECT id, lang, slug FROM news_translation;
+----+------+--------------------------------------------------------------+
| id | lang | slug                                                         |
+----+------+--------------------------------------------------------------+
|  1 | en   |                                                              | 
|  1 | fr   | ok-l-ipad-est-sorti-vous-allez-me-foutre-la-paix-maintentant | 
|  2 | fr   | sinon-a-part-ca-ca-va                                        | 
+----+------+--------------------------------------------------------------

Something went wrong ! Somewhere in the process, Symfony created an empty translation object for our article. Notice the void « slug » field ? If you try to edit another news, you will receive a duplicate content error. WTF ?

I must admit that I don’t fully understand why this happens (sometimes I think I do, and a few minutes later, I realize I don’t). However, here’s the solution to overcome this problem.

// lib/form/doctrine/ArticleForm.class.php
 
  // Add this at the beginnig of the class:
  /**
   * I18n ignored forms
   **/
  protected $I18nFormsIgnored = array();
 
  // update the doBind method:
  /**
   * Unset i18n forms values when every field is empty
   **/
  protected function doBind(array $values)
  {
    foreach($this->languages as $lang => $label)
    {
      if($this->embeddedI18nFormEmpty($values[$lang]))
      {
        $this->I18nFormsIgnored[] = $lang;
        unset(
          $values[$lang],
          $this[$lang]
        );
      }
    }
 
    parent::doBind($values);
  }
 
  // And override the doUpdateObject method:
  /**
   * Updates the values of the object with the cleaned up values.
   *
   * @param  array $values An array of values
   *
   * @see sfFormDoctrine::doUpdateObject()
   */
  protected function doUpdateObject($values)
  {
    parent::doUpdateObject($values);
 
    foreach($this->I18nFormsIgnored as $lang)
    {
      unset($this->object->Translation[$lang]);
      unset($values[$lang]);
    }
  }

Delete the useless line in the mysql database, so we can start on a clean base. Once more, reload the edit form, leave the english translation empty, save the form, et voilà ! The form is saved, the translation is updated, and no empty line is added in the table.

Adding and deleting a translation

Just to be sure, add some data in the english translation title, and try to save the form. You should get a « body is required » error, which is the expected behavior. Try to fill correctly the english translation, and save again. Check that the english translation is correctly added in the database. Erase all french fields, save one more time, and check that the french translation is definitly removed from the DB (no dummy entry).

Well, it seems that our form is pretty functional. One last thing : there is still a « slug » field in each translation form, that you might want to unset. Easy, just edit the ArticleTranslationForm.class.php file :

// lib/form/doctrine/ArticleTranslationForm.class.php
 
class ArticleTranslationForm extends BaseArticleTranslationForm
{
  public function configure()
  {
    unset($this['slug']);
  }
}

Edit a news. If you’re using Symfony 1.{3,4}.1, you’ll see that the damn slug field is still there. It’s a Symfony bug. Indeed, the translations forms don’t follow the inheritance schema. Notice that BaseNewsTranslationForm extends BaseFormDoctrine instead of ArticleNewsTranslation.

You’ll have to manually change that, however, this will be overidden each time you rebuild your forms.

// lib/form/doctrine/base/BaseNewsTranslationForm.class.php
// Replace
abstract class BaseNewsTranslationForm extends BaseFormDoctrine
 
// with
abstract class BaseNewsTranslationForm extends ArticleTranslationForm
 
// lib/form/doctrine/NewsTranslationForm.class.php
// Edit the configure method
class NewsTranslationForm extends BaseNewsTranslationForm
{
  public function configure()
  {
    parent::configure();
  }
}

Now, the slug field should disapear. At the present moment, the bug is still open.

Let’s test everything

As it’s friday, I feel generous, so as a bonus, I will give you the functional tests to cover our magical form. Enjoy.

// lib/sfBackendTestFunctional.class.php
/**
 * This class is used to run functional tests in a secured backend
 *
 * Takes care of the login action, and the fixtures loading
 */
class sfBackendTestFunctional extends sfTestFunctional
{
  public function __construct($browser, $lime = null, $testers = array())
  {
    parent::__construct($browser, $lime, $testers);
  }
 
  /**
   * Perform user authentication
   *
   * @param   array of String         $user_data
   * @return  sfGuardTestFunctional   $this
   */
  public function signin($user_data)
  {
   return $this->info(sprintf('Login as "%s"', $user_data['username']))->
     get('/login')->
     click('sign in', array('signin' => $user_data), array('_with_csrf' => true))->
 
     with('form')->begin()->
       hasErrors(false)->
     end()->
 
     with('user')->begin()->
       isAuthenticated(true)->
     end()->
 
     with('request')->begin()->
       isParameter('module', 'sfGuardAuth')->
       isParameter('action', 'signin')->
     end()->
 
     with('response')->begin()->
       isRedirected()->
       followRedirect()->
       end()
    ;
  }
  /**
   * Load project fixtures
   **/
  public function loadData()
  {
    Doctrine::loadData(sfConfig::get('sf_data_dir').'/fixtures');
    return $this;
  }
}

// test/functional/backend/newsActionsTest.php
 
include(dirname(__FILE__).'/../../bootstrap/functional.php');
 
$browser = new sfBackendTestFunctional(new sfBrowser());
$browser->loadData();
$browser->setTester('doctrine', 'sfTesterDoctrine');
 
$languages = sfConfig::get('app_cultures_enabled');
 
$news = Doctrine::getTable('News')->
  createQuery('n')->
  leftJoin('n.Translation t')->
  andWhere('t.lang = ?', 'fr')->
  orderBy('n.id', 'asc')->
  fetchOne();
 
$editUrl = sprintf('/news/%s/edit', $news->getId());
 
$browser->
  // Uncomment this if your backend is protected by a login
  //signin(array(
  //  'username' => 'admin',
  //  'password' => 'admin'
  //)))->
  get('/news')->
  with('response')->begin()->
    isStatusCode(200)->
  end()->
 
  info('1 - News list')->
  with('response')->begin()->
    checkElement('h1', '/News List/')->
    checkElement('body', '/Fantomas/')->
  end()->
 
  info('2 - News edit')->
  info('  2.1 - I18n forms for all languages are embedded')->
  get($editUrl)->
  with('response')->begin()->
    isStatusCode(200)->
    checkElement('input[name$="[title]"]', count($languages))->
  end()->
 
  info('  2.2 - I18n forms are validated')->
  get($editUrl)->
  click('Save', array('news' => array(
    'en' => array(
      'title' => 'toto',
      'body' => ''
    ))
    ), array('_with_csrf' => true)
  )->
  with('form')->begin()->
    hasErrors(1)->
    isError('en[body]', 'required')->
  end()->
 
  info('  2.3 - Empty forms are validated')->
  get($editUrl)->
  click('Save', array('news' => array(
    'en' => array(
      'title' => '',
      'body' => ''
    ))
    ), array('_with_csrf' => true)
  )->
  with('form')->begin()->
    hasErrors(0)->
  end()->
 
  info('  2.4 - Translations are updated')->
  get($editUrl)->
  click('Save', array('news' => array(
    'fr' => array(
      'title' => 'toto tutu tata',
      'body' => 'riri fifi loulou'
    ))
    ), array('_with_csrf' => true)
  )->
  with('form')->begin()->
    hasErrors(0)->
  end()->
 
  with('doctrine')->begin()->
    check('NewsTranslation', array(
      'id' => $news->getId(),
      'lang' => 'fr',
      'title' => 'toto tutu tata'
    ))->
    info('  2.5 - No empty translation is created')->
    check('NewsTranslation', array(
      'id' => $news->getId(),
      'lang' => 'en',
    ), false)->
  end()->
 
  info('  2.6 - New translations can be added')->
  get($editUrl)->
  click('Save', array('news' => array(
    'en' => array(
      'title' => 'toto tutu tata',
      'body' => 'riri fifi loulou'
    ))
    ), array('_with_csrf' => true)
  )->
 
  with('form')->begin()->
    hasErrors(0)->
  end()->
 
  with('doctrine')->begin()->
    check('NewsTranslation', array(
      'id' => $news->getId(),
      'lang' => 'en',
      'title' => 'toto tutu tata'
    ))->
  end()->
 
  info('  2.7 - Existing translations can be deleted')->
  get($editUrl)->
  click('Save', array('news' => array(
    'fr' => array(
      'title' => '',
      'body' => ''
    ))
    ), array('_with_csrf' => true)
  )->
  with('form')->begin()->
    hasErrors(0)->
  end()->
 
  with('doctrine')->begin()->
    check('NewsTranslation', array(
      'id' => $news->getId(),
      'lang' => 'fr',
    ), false)->
  end()
;

Here we are. Hope you find this helpful. I thought some kind of requirement would be pretty common, however, I didn’t find any directly related howto’s. If you can think of any other way to achieve this, please, let me know.

Créer une liste triable avec Symfony et jquery ui

thibault — Sat, 23 Jan 2010 12:23:57 +0000

Lors de mes développements de ces derniers jours, je suis tombé sur un besoin qui me semblait relativement simple. Je voulais être capable de trier rapidement une liste d’éléments. Et comme, malgré tout, j’ai un peu galéré à trouver des tutoriaux à jour, je vous livre ici le fruit de mes travaux.

J’utiliserai pour ce faire la librairie jquery UI, elle même basée sur Jquery.

Attention, hein, c’est samedi matin, je suis mal réveillé, − edit : tellement mal réveillé que j’ai publié l’article avant de l’avoir terminé. fail… − alors je raccourcirai au maximum. Si je ne suis pas clair, laissez moi des commentaires.

Comme d’hab, commençons par le modèle

Je voulais trouver un outil capable de gérer un backlog de produit à la scrum, histoire de communiquer avec mes clients à distance. Cependant, malgré l’existence d’excellents outils dédiés à cette sympathique méthodologie agile, je n’ai pas réussi à trouver quelque chose de vraiment simple et répondant à mes besoins. Alors, en bon geek, j’ai choisi de coder le mien.

Project:
  actAs:
    Sluggable:
      fields: [ title ]
      unique: true
 
  columns:
    id: { type: integer, primary: true, autoincrement: true }
    title: { type: string(255), notnull: true }
 
Story:
  actAs:
    Timestampable: ~
 
  columns:
    id: { type: integer, primary: true, autoincrement: true }
    project_id: { type: integer, notnull: true }
    description: { type: clob, notnull: true }
    priority: { type: integer(2), default: 0 }
    effort: { type: integer(2), default: 0 }
 
  relations:
    Project:
      foreignAlias: Stories
      local: project_id
      foreign: id
      type: one
      foreignType: many

Pour les paresseux, je vous colle aussi les fixtures :

 
Project:
  demo:
    title: 'Demo project'
 
Story:
  s1:
    description: 'En tant qu''anonyme, je peux m''inscrire sur le site pour devenir membre'
    priority: 1
    effort: 5
    Project: demo
 
  s2:
    description: 'En tant que membre, je dispose d''une page d''accueil pour éditer mon profil et voir l''activité de mon réseau'
    priority: 3
    effort: 13
    Project: demo
 
  s3:
    description: 'En tant que rédacteur, je peux écrire des articles de type magazine et les publier dans des catégories'
    priority: 2
    effort: 25
    Project: demo

Voilà pour le modèle. Je vous laisse construire tout ça, vous connaissez le topo. Créez ensuite un module « project », avec une action « show » qui affichera une liste de users stories. Je vous passe le code de l’action qui n’a rien de spécial. Dans le template « showSuccess.php » du module project, ajoutez :

// bla bla bla

 include_partial('story/list', array('stories' => $project->getStories())) ?>

Vous aurez bien entendu surchargé la fonction « getStories » pour trier les histoires par priorité.

Créez ensuite un module « story », et ajoutez-y un template « _list.php » …

 foreach($stories as $story): ?>
    echo$story->getId()?>">
       include_partial('story/detail', array('story' => $story)) ?>
     endforeach ?>


   


  
    #id
    Description
    Effort

Ainsi qu’un autre template « _detail.php »


  
    
     echo $story->getId() ?>
  

 echo $story->getDescription() ?>
 echo $story->getEffort() ?>

Vous voilà donc avec une belle liste de users stories, affichées par ordre de priorité, et que vous souhaiteriez pouvoir réordonner par drag’n'drop.

Des p’tits tris, des p’tits tris, encore des p’tits tris…

Dans le répertoire web, ajoutez dans votre fichier js maison (créez le s’il n’existe pas) le code suivant.

$(document).ready(function()
{
  $("#stories table tbody").sortable({
    // limitons les déplacements sur l'axe des ordonnées, ce sera plus propre
    axis: 'y',
 
    // Il faut cliquer sur cet élément pour pouvoir initier le drag'n'drop
    handle: '.sort-button',
 
    // Créons un joli trou stylé lors des déplacements
    placeholder: 'ui-state-highlight',
    forcePlaceholderSize: true,
 
    // Cette fonction permet à notre ligne de conserver son formatage lors du déplacement
    // Pas vraiment utile, mais plus agréable à l'œil
    helper: function(e, tr)
    {
      var $originals = tr.children();
      var $helper = tr.clone();
      $helper.children().each(function(index)
      {
        // Set helper cell sizes to match the original sizes
        $(this).width($originals.eq(index).width())
      });
      return $helper;
    },
 
    // La fonction appelée quand un élément change de position
    // C'est le code vraiment utile, en fait
    update: function(event, ui){
      // Construit un tableau des ids des stories
      serial = $(this).sortable('serialize');
 
      // Appelle une action en ajax
      $.ajax({
        url: updateorderurl, // set in layout.php
        type: "post",
        data: serial,
        error: function(){
          alert("Error ! Order not updated");
        }
      })
    }
  });
});

Remarquez que la variable « updateorderurl » contient l’url de l’action qui va réaliser la réaffectation des priorités. Comme cette url est générée par Symfony, elle est définie dans le contrôleur, puis affectée à une variable javascript dans la layout grâce à un slot. Ça vaut ce que ça vaut.

Normalement, vous devriez maintenant être capable de changer l’ordre des stories côté frontend. Bien entendu, le code métier chargé de gérer le réordonnancement n’existe pas encore.

Au cœur du métier

Créons donc une nouvelle action dans le module « story ».

  public function executeUpdateOrder(sfWebRequest $request)
  {
    // Il nous faut un moyen de récupérer le projet en question
    $project = Doctrine::getTable('project')->find($request->getParameter('project_id'));
    $this->forward404Unless($project);
 
    // Correspond à la variable 'serial' dans le js, vous vous souvenez ?
    // C'est un simple tableau d'ids
    $order = $request->getParameter('story');
    $project->updateStoriesOrder($order);
 
    return sfView::HEADER_ONLY;
  }

Nous revoilà repartis dans le modèle. Éditons notre classe Project.

// lib/model/doctrine/Project.class.php
// …
  /**
   * Update the stories order
   *
   * @param array $order An array with the stories ids, sorted by priority
   **/
  public function updateStoriesOrder(array $order)
  {
    foreach($order as $priority => $storyId)
    {
      $story = Doctrine::getTable('story')
        ->find($storyId);
 
      if(!$story || $story->getProjectId() != $this->getId())
        throw new Exception('moo');
 
      $story->setPriority($priority);
      $story->save();
    }
  }

Tadaaaaaam ! Ça devrait fonctionner. Voilà, c’est tout. Tiens, au moment où je finis d’écrire ces lignes, je m’aperçois qu’un plugin censé faire exactement la même chose vient de sortir. Frustration. Bon, tant pis, bon week-end quand même.

Naissance d’un plugin Solr pour Symfony

thibault — Wed, 30 Dec 2009 16:05:13 +0000

photo credit : B Tal

Salut la compagnie. Ce billet (vraissemblablement le dernier de l’année) est destiné à faire passer une annonce (et aussi à ramener un peu de traffic, j’avoue).

Si vous n’êtes pas abonné à mon twitter, vous ne savez peut-être pas encore que je viens de lâcher dans la nature un nouveau plugin pour Symfony, qui porte le doux nom de tjSolrDoctrineBehaviorPlugin.

Ce plugin, comme son nom l’indique, permet de coupler trés simplement le framework Symfony et le moteur de recherche Solr. Ainsi, vous pouvez bénéficier dans vos projets Symfony d’un moteur de recherche au top, même si vous n’êtes pas familier avec Solr.

Il s’agit d’une version beta, ce qui signifie que je suis preneur de toutes remarques ou commentaires sur le sujet. Je n’en dit pas plus, la documentation du plugin est suffisamment détaillée comme ça.

C’est tout. Je m’en vais maintenant prendre un repos bien mérité, et déguster de délicieux chaussons aux pommes maison (tout le monde s’en fout, mais j’aime bien qu’on sache que j’apprécie mes vacances).

Bonnes fêtes à tous.