<commit_before><?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 17592 -->
<!-- Reviewed: no -->
<sect3 id="zend.controller.router.routes.regex">
    <title>Zend_Controller_Router_Route_Regex</title>

    <para>
        En plus des routes par défaut, et statique, les routes exprimées par expression
        régulière sont acceptées. Ces routes sont plus puissantes que les autres, mais aussi plus
        complexes à mettre en oeuvre et un peu plus lentes en matière d'analyse.
    </para>

    <para>
        Comme les routes standards, cette route doit être initialisée avec une définition et
        des valeurs par défaut. Créons par exemple avec une route "archive" en utilisant les routes
        par expressions régulières&#160;:
    </para>

    <programlisting language="php"><![CDATA[
$route = new Zend_Controller_Router_Route_Regex(
    'archive/(\d+)',
    array(
        'controller' => 'archive',
        'action'     => 'show'
    )
);
$router->addRoute('archive', $route);
]]></programlisting>

    <para>
        Chaque motif d'expression régulière sera injecté dans l'objet de requête. Avec
        l'exemple ci-dessus, en utilisant <code>http://domain.com/archive/2006</code>, la tableau
        résultat devrait ressembler à&#160;:
    </para>

    <programlisting language="php"><![CDATA[
$values = array(
    1            => '2006',
    'controller' => 'archive',
    'action'     => 'show'
);
]]></programlisting>

    <note>
        <para>
            Les slashs de début et de fin sont supprimés de l'URL dans le routeur (avant
            l'intervention de la route).Ainsi, pour faire correspondre l'URL
            <code>http://domain.com/foo/bar/</code>, il faudra une expression du style
            <code>foo/bar</code>, et non pas <code>/foo/bar</code>.
        </para>
    </note>

    <note>
        <para>
            Les caractères de spécification de début et fin d'expression sont automatiquement
            rajoutés au motif ('^' et '$', respectivement). De ce fait, vous ne devriez pas les
            utiliser manuellement.
        </para>
    </note>

    <note>
        <para>
            Cette classe de route utilise le séparateur <code>#</code> comme délimiteur de
            motif. Vous devrez donc échapper ce caractère si vous l'utilisez, et non pas le slash
            (par défaut pour un motif d'expression régulière). Le caractère "#" est cependant
            rarement utilisé dans une <acronym>URL</acronym>.
        </para>
    </note>

    <para>Vous pouvez retourner le contenu des sous-masques&#160;:</para>

    <programlisting language="php"><![CDATA[
public function showAction()
{
    $request = $this->getRequest();
    $year    = $request->getParam(1); // $year = '2006';
}
]]></programlisting>

    <note>
        <para>Attention, la clé est un entier (1), et non une chaîne ('1').</para>
    </note>

    <para>
        Cette route ne fonctionnera pas encore tout à fait comme la route standard, car la
        valeur par défaut pour "<code>year</code>" n'est pas indiquée. Attention par contre, vous
        risquez d'avoir un problème avec les slashs finaux même si nous déclarons une valeur par
        défaut pour "<code>year</code>" et que celui-ci est facultatif. La solution consiste à
        traiter ce slash, mais sans le capturer&#160;:
    </para>

    <programlisting language="php"><![CDATA[
$route = new Zend_Controller_Router_Route_Regex(
    'archive(?:/(\d+))?',
    array(
        1    '       => '2006',
        'controller' => 'archive',
        'action'     => 'show'
    )
);
$router->addRoute('archive', $route);
]]></programlisting>

    <para>
        Nous voyons apparaître tout de même un problème : gérer des chiffres, comme clés pour
        les paramètres n'est pas très intuitif. C'est là qu'entre en jeu le troisième paramètre du
        constructeur de <classname>Zend_Controller_Router_Route_Regex</classname>. Il accepte un
        tableau faisant correspondre les numéros des paramètres et leur nom respectif&#160;:<commit_msg>[ZF-10265] French documentation: syntax error in a sample<commit_after><?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 17592 -->
<!-- Reviewed: no -->
<sect3 id="zend.controller.router.routes.regex">
    <title>Zend_Controller_Router_Route_Regex</title>

    <para>
        En plus des routes par défaut, et statique, les routes exprimées par expression
        régulière sont acceptées. Ces routes sont plus puissantes que les autres, mais aussi plus
        complexes à mettre en oeuvre et un peu plus lentes en matière d'analyse.
    </para>

    <para>
        Comme les routes standards, cette route doit être initialisée avec une définition et
        des valeurs par défaut. Créons par exemple avec une route "archive" en utilisant les routes
        par expressions régulières&#160;:
    </para>

    <programlisting language="php"><![CDATA[
$route = new Zend_Controller_Router_Route_Regex(
    'archive/(\d+)',
    array(
        'controller' => 'archive',
        'action'     => 'show'
    )
);
$router->addRoute('archive', $route);
]]></programlisting>

    <para>
        Chaque motif d'expression régulière sera injecté dans l'objet de requête. Avec
        l'exemple ci-dessus, en utilisant <code>http://domain.com/archive/2006</code>, la tableau
        résultat devrait ressembler à&#160;:
    </para>

    <programlisting language="php"><![CDATA[
$values = array(
    1            => '2006',
    'controller' => 'archive',
    'action'     => 'show'
);
]]></programlisting>

    <note>
        <para>
            Les slashs de début et de fin sont supprimés de l'URL dans le routeur (avant
            l'intervention de la route).Ainsi, pour faire correspondre l'URL
            <code>http://domain.com/foo/bar/</code>, il faudra une expression du style
            <code>foo/bar</code>, et non pas <code>/foo/bar</code>.
        </para>
    </note>

    <note>
        <para>
            Les caractères de spécification de début et fin d'expression sont automatiquement
            rajoutés au motif ('^' et '$', respectivement). De ce fait, vous ne devriez pas les
            utiliser manuellement.
        </para>
    </note>

    <note>
        <para>
            Cette classe de route utilise le séparateur <code>#</code> comme délimiteur de
            motif. Vous devrez donc échapper ce caractère si vous l'utilisez, et non pas le slash
            (par défaut pour un motif d'expression régulière). Le caractère "#" est cependant
            rarement utilisé dans une <acronym>URL</acronym>.
        </para>
    </note>

    <para>Vous pouvez retourner le contenu des sous-masques&#160;:</para>

    <programlisting language="php"><![CDATA[
public function showAction()
{
    $request = $this->getRequest();
    $year    = $request->getParam(1); // $year = '2006';
}
]]></programlisting>

    <note>
        <para>Attention, la clé est un entier (1), et non une chaîne ('1').</para>
    </note>

    <para>
        Cette route ne fonctionnera pas encore tout à fait comme la route standard, car la
        valeur par défaut pour "<code>year</code>" n'est pas indiquée. Attention par contre, vous
        risquez d'avoir un problème avec les slashs finaux même si nous déclarons une valeur par
        défaut pour "<code>year</code>" et que celui-ci est facultatif. La solution consiste à
        traiter ce slash, mais sans le capturer&#160;:
    </para>

    <programlisting language="php"><![CDATA[
$route = new Zend_Controller_Router_Route_Regex(
    'archive(?:/(\d+))?',
    array(
        1            => '2006',
        'controller' => 'archive',
        'action'     => 'show'
    )
);
$router->addRoute('archive', $route);
]]></programlisting>

    <para>
        Nous voyons apparaître tout de même un problème : gérer des chiffres, comme clés pour
        les paramètres n'est pas très intuitif. C'est là qu'entre en jeu le troisième paramètre du
        constructeur de <classname>Zend_Controller_Router_Route_Regex</classname>. Il accepte un
        tableau faisant correspondre les numéros des paramètres et leur nom respectif&#160;:
{'fraction_non_alphanumeric': 0.11656819300837026, 'fraction_numerical': 0.011693746922698178, 'mean_word_length': 2.7442396313364057, 'pattern_counts': {'":': 0, '<': 129, '<?xml version=': 2, '>': 153, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 2}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6649770', 'n_tokens_mistral': 2572, 'n_tokens_neox': 2481, 'n_words': 822}