{{ form_label(form) }}
@@ -1193,11 +1188,11 @@ balise :
{{ form_widget(form) }}
{% endspaceless %}
- {% endblock field_row %}
+ {% endblock form_row %}
.. code-block:: html+php
-
+
label($form, $label) ?>
@@ -1205,12 +1200,12 @@ balise :
widget($form, $parameters) ?>
-Le fragment de formulaire ``field_row`` est utilisé pour rendre la plupart
+Le fragment de formulaire ``form_row`` est utilisé pour rendre la plupart
des champs via la fonction ``form_row``. Pour dire au composant formulaire
-d'utiliser votre nouveau fragment ``field_row`` defini ci-dessus, ajoutez
+d'utiliser votre nouveau fragment ``form_row`` defini ci-dessus, ajoutez
ce qui suit en haut du template qui rend le formulaire :
-.. configuration-block:: php
+.. configuration-block::
.. code-block:: html+jinja
@@ -1235,8 +1230,8 @@ ce qui suit en haut du template qui rend le formulaire :
La balise ``form_theme`` (dans Twig) « importe » les fragments définis dans le
template donné et les utilise lorsqu'il rend le formulaire. En d'autres termes,
quand la fonction ``form_row`` est appelée plus tard dans ce template, elle va
-utiliser le bloc ``field_row`` de votre thème personnalisé (à la place du bloc
-par défaut ``field_row`` qui est délivré avec Symfony).
+utiliser le bloc ``form_row`` de votre thème personnalisé (à la place du bloc
+par défaut ``form_row`` qui est délivré avec Symfony).
Votre thème personnalisé n'a pas besoin de surcharger tous les blocks. Lorsqu'il
affiche un block qui n'est pas surchargé par votre thème personnalisé, le moteur de
@@ -1288,10 +1283,10 @@ sont situés dans le répertoire `Resources/views/Form` du bundle du framework
Chaque nom de fragment suit le même pattern de base et est divisé en deux parties,
séparées par un unique underscore (``_``). Quelques exemples sont :
-* ``field_row`` - utilisé par ``form_row`` pour rendre la plupart des champs ;
+* ``form_row`` - utilisé par ``form_row`` pour rendre la plupart des champs ;
* ``textarea_widget`` - utilisé par ``form_widget`` pour rendre un champ de
type ``textarea`` ;
-* ``field_errors`` - utilisé par ``form_errors`` pour rendre les erreurs d'un champ.
+* ``form_errors`` - utilisé par ``form_errors`` pour rendre les erreurs d'un champ.
Chaque fragment suit le même pattern de base : ``type_part``. La partie ``type``
correspond au *type* du champ qui doit être rendu (par exemple : ``textarea``,
@@ -1300,13 +1295,13 @@ va être rendu (par exemple : ``label``, ``widget``, ``errors``, etc). Par défa
il y a 4 *parts* possibles d'un formulaire qui peuvent être rendues :
+-------------+-----------------------------------+------------------------------------------------------------+
-| ``label`` | (par exemple : ``field_label``) | rend le label du champ |
+| ``label`` | (par exemple : ``form_label``) | rend le label du champ |
+-------------+-----------------------------------+------------------------------------------------------------+
-| ``widget`` | (par exemple : ``field_widget``) | rend la représentation HTML du champ |
+| ``widget`` | (par exemple : ``form_widget``) | rend la représentation HTML du champ |
+-------------+-----------------------------------+------------------------------------------------------------+
-| ``errors`` | (par exemple : ``field_errors``) | rend les erreurs du champ |
+| ``errors`` | (par exemple : ``form_errors``) | rend les erreurs du champ |
+-------------+-----------------------------------+------------------------------------------------------------+
-| ``row`` | (par exemple : ``field_row``) | rend la ligne entière du champ (label, widget, et erreurs) |
+| ``row`` | (par exemple : ``form_row``) | rend la ligne entière du champ (label, widget, et erreurs) |
+-------------+-----------------------------------+------------------------------------------------------------+
.. note::
@@ -1328,16 +1323,16 @@ Dans certains cas, le fragment que vous voulez personnaliser sera absent.
Par exemple, il n'y a pas de fragment ``textarea_errors`` dans les thèmes
fournis par défaut par Symfony.
-La réponse est : via le fragment ``field_errors``. Quand Symfony rend les erreurs
+La réponse est : via le fragment ``form_errors``. Quand Symfony rend les erreurs
d'un champ de type textarea, il recherche en premier un fragment ``textarea_errors``
-avant de se replier sur le fragment de secours ``field_errors``. Chaque type de
+avant de se replier sur le fragment de secours ``form_errors``. Chaque type de
champ a un type *parent* (le type parent de ``textarea`` est ``field``), et
Symfony l'utilise si le fragment de base n'existe pas.
Donc, afin de réécrire les erreurs pour les champs ``textarea`` *seulement*, copiez
-le fragment ``field_errors``, renommez-le en ``textarea_errors`` et personnalisez-le.
+le fragment ``form_errors``, renommez-le en ``textarea_errors`` et personnalisez-le.
Pour réécrire le rendu d'erreur par défaut pour *tous* les champs, copiez et personnalisez
-le fragment ``field_errors`` directement.
+le fragment ``form_errors`` directement.
.. tip::
@@ -1413,9 +1408,9 @@ maintenant utilisés globalement pour définir le rendu de formulaire en sortie.
{% form_theme form _self %}
{# effectue la personnalisation du fragment de formulaire #}
- {% block field_row %}
+ {% block form_row %}
{# personnalisez le rendu en sortie de la ligne du champ #}
- {% endblock field_row %}
+ {% endblock form_row %}
{% block content %}
{# ... #}
@@ -1546,7 +1541,7 @@ votre projet. Pour plus d'informations, voir la section de
L'option ``intention`` est optionnelle mais améliore grandement la sécurité
du jeton généré en le rendant différent pour chaque formulaire.
-.. index:
+.. index::
single: Forms; With no class
Utiliser un formulaire sans classe
@@ -1574,7 +1569,7 @@ un tableau des données soumises. C'est en fait très facile :
->add('message', 'textarea')
->getForm();
- if ($request->getMethod() == 'POST') {
+ if ($request->isMethod('POST')) {
$form->bind($request);
// les données sont un tableau avec les clés "name", "email", et "message"
@@ -1588,10 +1583,10 @@ Par défaut, en fait, un formulaire part du principe que vous voulez travailler
un tableau de données plutôt qu'avec un objet.Il y a exactement deux façons de changer
ce comportement et d'associer le formulaire avec un objet à la place:
-1. Passez un objet lors de la création du formulaire (comme premier argument de ``createFormBuilder``
+#. Passez un objet lors de la création du formulaire (comme premier argument de ``createFormBuilder``
ou deuxième argument de ``createForm``);
-2. Définissez l'option ``data_class`` de votre formulaire.
+#. Définissez l'option ``data_class`` de votre formulaire.
Si vous ne faites *pas* l'un ou l'autre, alors le formulaire retournera les données
dans un tableau. Dans cet exemple, puisque ``$defaultData`` n'est pas un objet (et
@@ -1601,9 +1596,7 @@ finalement un tableau.
.. tip::
Vous pouvez également accéder directement aux valeurs POST (dans ce cas "name")
- par le biais de l'objet Request, comme ceci :
-
- .. code-block:: php
+ par le biais de l'objet Request, comme ceci::
$this->get('request')->request->get('name');
@@ -1625,17 +1618,17 @@ mais voici un petit exemple::
// importez les namespaces en haut de votre classe
use Symfony\Component\Validator\Constraints\Email;
- use Symfony\Component\Validator\Constraints\MinLength;
+ use Symfony\Component\Validator\Constraints\Length;
use Symfony\Component\Validator\Constraints\Collection;
$collectionConstraint = new Collection(array(
- 'name' => new MinLength(5),
- 'email' => new Email(array('message' => 'Invalid email address')),
+ 'name' => new Length(array("min" => 5)),
+ 'email' => new Email(array('message' => 'Courriel invalide')),
));
// créez un formulaire, sans valeurs par défaut, et passez les contraintes
$form = $this->createFormBuilder(null, array(
- 'validation_constraint' => $collectionConstraint,
+ 'constraints' => $collectionConstraint,
))->add('email', 'email')
// ...
;
@@ -1652,7 +1645,7 @@ surchargez la méthode ``setDefaultOptions`` pour les spécifier :
use Symfony\Component\Form\FormBuilder;
use Symfony\Component\OptionsResolver\OptionsResolverInterface;
use Symfony\Component\Validator\Constraints\Email;
- use Symfony\Component\Validator\Constraints\MinLength;
+ use Symfony\Component\Validator\Constraints\Length;
use Symfony\Component\Validator\Constraints\Collection;
class ContactType extends AbstractType
@@ -1662,12 +1655,12 @@ surchargez la méthode ``setDefaultOptions`` pour les spécifier :
public function setDefaultOptions(OptionsResolverInterface $resolver)
{
$collectionConstraint = new Collection(array(
- 'name' => new MinLength(5),
- 'email' => new Email(array('message' => 'Invalid email address')),
+ 'name' => Length(array("min" => 5)),
+ 'email' => new Email(array('message' => 'Courriel invalide')),
));
$resolver->setDefaults(array(
- 'validation_constraint' => $collectionConstraint
+ 'constraints' => $collectionConstraint
));
}
}
@@ -1711,6 +1704,6 @@ En savoir plus grâce au Cookbook
.. _`Composant Formulaire Symfony2`: https://github.com/symfony/Form
.. _`DateTime`: http://php.net/manual/en/class.datetime.php
.. _`Twig Bridge`: https://github.com/symfony/symfony/tree/master/src/Symfony/Bridge/Twig
-.. _`form_div_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/form_div_layout.html.twig
+.. _`form_div_layout.html.twig`: https://github.com/symfony/symfony/blob/2.1/src/Symfony/Bridge/Twig/Resources/views/Form/form_div_layout.html.twig
.. _`Cross-site request forgery`: http://en.wikipedia.org/wiki/Cross-site_request_forgery
.. _`voir sur GitHub`: https://github.com/symfony/symfony/tree/master/src/Symfony/Bundle/FrameworkBundle/Resources/views/Form
diff --git a/book/from_flat_php_to_symfony2.rst b/book/from_flat_php_to_symfony2.rst
index 2e122829a..22f04574d 100644
--- a/book/from_flat_php_to_symfony2.rst
+++ b/book/from_flat_php_to_symfony2.rst
@@ -36,6 +36,7 @@ dans la base de données. Écrire en pur PHP est « rapide et sale » :
$result = mysql_query('SELECT id, title FROM post', $link);
?>
+
Page Not Found
'; @@ -546,17 +549,14 @@ L'application exemple en Symfony2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Le blog a beaucoup évolué, mais il contient beaucoup de code pour une si simple application. -Durant cette évolution, nous avons inventé un mécanisme simple de routage et une méthode utilisant +Durant cette évolution, vous avez créé un mécanisme simple de routage et une méthode utilisant ``ob_start()`` et ``ob_get_clean()`` pour faire le rendu de templates. Si, pour une raison, vous deviez continuer à construire ce « framework », vous pourriez utiliser les composants indépendants `Routing`_ et `Templating`_, qui apportent une solution à ces problèmes. Au lieu de résoudre à nouveau ces problèmes, vous pouvez laisser Symfony2 s'en occuper pour vous. -Voici la même application, en utilisant cette fois-ci Symfony2 : +Voici la même application, en utilisant cette fois-ci Symfony2:: -.. code-block:: html+php - - +Contact us!
". Dans le :doc:`chapitre du contrôleur`, vous allez apprendre comment un contrôleur peut fournir des templates, permettant à votre code de «présentation» (i.e. quoi que ce soit qui délivre du HTML) de se trouver dans un fichier de template @@ -558,7 +575,7 @@ Donc finalement, *qu'est-ce* que le *Framework* Symfony2 ? Le *Framework Symfony est une bibliothèque PHP qui accomplit deux tâches distinctes : #. Fournir une sélection de composants (i.e. les Composants Symfony2) et - des bibliothèques tiers (e.g. ``Swiftmailer`` pour envoyer des emails); + des bibliothèques tiers (e.g. `Swiftmailer`_ pour envoyer des emails); #. Fournir une configuration et une bibliothèque «colle» qui lie toutes ces pièces ensembles. @@ -585,3 +602,4 @@ Pour les utilisateurs avancés, le ciel est la seule limite. .. _`Validator`: https://github.com/symfony/Validator .. _`Security`: https://github.com/symfony/Security .. _`Translation`: https://github.com/symfony/Translation +.. _`Swiftmailer`: http://swiftmailer.org/ \ No newline at end of file diff --git a/book/installation.rst b/book/installation.rst index e02cf1a82..07218cf2e 100644 --- a/book/installation.rst +++ b/book/installation.rst @@ -24,7 +24,7 @@ Télécharger une Distribution Symfony2 lisez les documentations suivantes : `Apache`_ | `Nginx`_ . Les « distributions » Symfony2 sont des applications entièrement fonctionnelles -qui incluent les librairies du coeur de Symfony2, une sélection de bundles utiles, +qui incluent les bibliothèques du coeur de Symfony2, une sélection de bundles utiles, une arborescence pratique et une configuration par défaut. Quand vous téléchargez une distribution Symfony2, vous téléchargez un squelette d'application qui peut être immédiatement utilisé pour commencer à développer votre application. @@ -64,6 +64,12 @@ la Distribution Standard : Pour une version exacte, remplacez `2.1.x-dev` par la dernière version de Symfony (ex : 2.1.1). Pour plus de détails, lisez `Installation de Symfony`_ +.. tip:: + + Pour télécharger les « vendor » plus rapidement et sans les répertoires non + indispensables (par exemple : "Tests"), ajoutez l'option "--prefer-dist" à la fin de toute + commande « Composer ». + Cette commande peut prendre plusieurs minutes pour s'exécuter car « Composer » télécharge la Distribution Standard ainsi que toutes les bibliothèques « vendor » dont elle a besoin. Lorsque la commande a terminé son exécution, vous devriez @@ -188,7 +194,7 @@ Symfony elle-même - dans le répertoire ``vendor/``. Configuration et installation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Maintenant, toutes les librairies tierces nécessaires sont dans le répertoire +Maintenant, toutes les bibliothèques tierces nécessaires sont dans le répertoire ``vendor/``. Vous avez également une application par défaut installée dans le répertoire ``app/`` et un exemple de code dans le répertoire ``src/``. @@ -249,9 +255,7 @@ S'il y a des problèmes, corrigez les maintenant avant de poursuivre. en écriture au groupe ou aux autres (cela dépend si l'utilisateur serveur web et l'utilisateur de ligne de commande sont dans le même groupe ou non). Pour faire ceci, ajoutez la ligne suivante au début des fichiers ``app/console``, - ``web/app.php`` et ``web/app_dev.php`` : - - .. code-block:: php + ``web/app.php`` et ``web/app_dev.php``:: umask(0002); // Définit une permission 0775 @@ -272,7 +276,7 @@ première « vraie » page Symfony2 : Symfony2 devrait vous accueillir et vous féliciter pour tout le travail accompli jusqu'ici ! -.. image:: /images/quick_tour/welcome.jpg +.. image:: /images/quick_tour/welcome.png Commencer à développer ---------------------- @@ -314,8 +318,8 @@ cela se fait en créant le fichier ``.gitignore`` et en y ajoutant la ligne suiv Maintenant, le répertoire vendor ne sera pas commité sur votre système de gestion de code. C'est plutôt bien (en fait c'est génial !) car lorsque quelqu'un clone ou -récupère le projet, il lui suffit de lancer la commande ``php bin/vendors install`` -pour récupérer toutes les librairies nécessaires. +récupère le projet, il lui suffit de lancer la commande ``php composer.phar install`` +pour récupérer toutes les bibliothèques nécessaires. .. _`activer le support ACL`: https://help.ubuntu.com/community/FilePermissionsACLs .. _`http://symfony.com/download`: http://symfony.com/download @@ -325,4 +329,4 @@ pour récupérer toutes les librairies nécessaires. .. _`Composer`: http://getcomposer.org/ .. _`Apache`: http://httpd.apache.org/docs/current/mod/core.html#documentroot .. _`Nginx`: http://wiki.nginx.org/Symfony -.. _`Installation de Symfony`: http://symfony.com/download \ No newline at end of file +.. _`Installation de Symfony`: http://symfony.com/download diff --git a/book/internals.rst b/book/internals.rst index ddcf6cff3..be0576844 100644 --- a/book/internals.rst +++ b/book/internals.rst @@ -141,34 +141,35 @@ automatiquement les arguments de la méthode, basé sur les attributs de la Requ Gestion des Requêtes ~~~~~~~~~~~~~~~~~~~~ -La méthode ``handle()`` prend une ``Requête`` et retourne *toujours* une ``Réponse``. +La méthode :method:`Symfony\\Component\\HttpKernel\\HttpKernel::handle` +prend une ``Requête`` et retourne *toujours* une ``Réponse``. Pour convertir la ``Requête``, ``handle()`` repose sur le « Resolver » et sur une chaîne ordonnée de notifications d'évènements (voir la prochaine section pour plus d'informations à propos de chaque évènement) : -1. Avant de faire quoi que ce soit d'autre, l'évènement ``kernel.request`` est +#. Avant de faire quoi que ce soit d'autre, l'évènement ``kernel.request`` est notifié -- si l'un des listeners (« écouteurs » en français) retourne une ``Réponse``, il saute directement à l'étape 8 ; -2. Le « Resolver » est appelé pour déterminer le Contrôleur à exécuter ; +#. Le « Resolver » est appelé pour déterminer le Contrôleur à exécuter ; -3. Les listeners de l'évènement ``kernel.controller`` peuvent maintenant +#. Les listeners de l'évènement ``kernel.controller`` peuvent maintenant manipuler le « callable » Contrôleur de la manière dont ils souhaitent (le changer, créer un « wrapper » au-dessus de lui, ...) ; -4. Le Kernel vérifie que le Contrôleur est un « callable » PHP valide ; +#. Le Kernel vérifie que le Contrôleur est un « callable » PHP valide ; -5. Le « Resolver » est appelé pour déterminer les arguments à passer au Contrôleur ; +#. Le « Resolver » est appelé pour déterminer les arguments à passer au Contrôleur ; -6. Le Kernel appelle le Contrôleur ; +#. Le Kernel appelle le Contrôleur ; -7. Si le Contrôleur ne retourne pas une ``Réponse``, les listeners de l'évènement +#. Si le Contrôleur ne retourne pas une ``Réponse``, les listeners de l'évènement ``kernel.view`` peuvent convertir la valeur retournée par le Contrôleur en une ``Réponse`` ; -8. Les listeners de l'évènement ``kernel.response`` peuvent manipuler la ``Réponse`` +#. Les listeners de l'évènement ``kernel.response`` peuvent manipuler la ``Réponse`` (contenu et en-têtes) ; -9. La Réponse est retournée. +#. La Réponse est retournée. Si une Exception est capturée pendant le traitement de la Requête, l'évènement ``kernel.exception`` est notifié et les listeners ont alors une chance de @@ -206,12 +207,14 @@ Chaque évènement capturé par le Kernel est une sous-classe de :class:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent`. Cela signifie que chaque évènement a accès aux mêmes informations de base : -* ``getRequestType()`` - retourne le *type* de la requête - (``HttpKernelInterface::MASTER_REQUEST`` ou ``HttpKernelInterface::SUB_REQUEST``) ; +* :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getRequestType` + - retourne le *type* de la requête (``HttpKernelInterface::MASTER_REQUEST`` ou ``HttpKernelInterface::SUB_REQUEST``) ; -* ``getKernel()`` - retourne le Kernel gérant la requête ; +* :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getKernel` + - retourne le Kernel gérant la requête ; -* ``getRequest()`` - retourne la ``Requête`` courante qui est en train d'être gérée. +* :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getRequest` + - retourne la ``Requête`` courante qui est en train d'être gérée. ``getRequestType()`` .................... @@ -263,9 +266,7 @@ L'évènement ``kernel.controller`` *La Classe Évènement*: :class:`Symfony\\Component\\HttpKernel\\Event\\FilterControllerEvent` Cet évènement n'est pas utilisé par le ``FrameworkBundle``, mais peut être un point -d'entrée utilisé pour modifier le contrôleur qui devrait être exécuté : - -.. code-block:: php +d'entrée utilisé pour modifier le contrôleur qui devrait être exécuté:: use Symfony\Component\HttpKernel\Event\FilterControllerEvent; @@ -482,7 +483,8 @@ lui associe aussi un jeton ; ce jeton est disponible dans l'en-tête HTTP ou lorsque vous voulez récupérer le jeton pour une requête Ajax, utilisez un outil comme Firebug pour obtenir la valeur de l'en-tête HTTP ``X-Debug-Token``. -Utilisez la méthode ``find()`` pour accéder aux jetons basés sur quelques critères : +Utilisez la méthode :method:`Symfony\\Component\\HttpKernel\\Profiler\\Profiler::find` +pour accéder aux jetons basés sur quelques critères : // récupère les 10 derniers jetons $tokens = $container->get('profiler')->find('', '', 10); @@ -494,8 +496,9 @@ Utilisez la méthode ``find()`` pour accéder aux jetons basés sur quelques cri $tokens = $container->get('profiler')->find('127.0.0.1', '', 10); Si vous souhaitez manipuler les données de profiling sur une machine différente -que celle où les informations ont été générées, utilisez les méthodes ``export()`` -et ``import()`` :: +que celle où les informations ont été générées, utilisez les méthodes +:method:`Symfony\\Component\\HttpKernel\\Profiler\\Profiler::export` et +:method:`Symfony\\Component\\HttpKernel\\Profiler\\Profiler::import`:: // sur la machine de production $profile = $container->get('profiler')->loadProfile($token); diff --git a/book/page_creation.rst b/book/page_creation.rst index ddb01b9ca..8ae2a759d 100644 --- a/book/page_creation.rst +++ b/book/page_creation.rst @@ -310,8 +310,10 @@ A la place d'écrire le code HTML dans le contrôleur, retournez plutôt un temp .. note:: - Afin d'utiliser la méthode ``render()``, votre contrôleur doit étendre la classe - `Symfony\Bundle\FrameworkBundle\Controller\Controller`` (API + Afin d'utiliser la méthode + :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::render`, + votre contrôleur doit étendre la classe + ``Symfony\Bundle\FrameworkBundle\Controller\Controller`` (API docs: :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller`), qui ajoute des raccourcis pour des tâches fréquemment utilisées dans les contrôleurs. Dans l'exemple ci-dessus, c'est ce qui est fait en ajoutant la ligne ``use`` @@ -405,7 +407,7 @@ signifie que le template se situe en dehors du bundle et dans le répertoire ``a output('_content') ?> - output('stylesheets') ?> + output('javascripts') ?> @@ -443,7 +445,7 @@ a par défaut la même structure de répertoires basique et recommandée : * ``src/``: Tout le code PHP du projet est stocké ici; -* ``vendor/``: Par convention, toutes les librairies tierces (additionnelles) sont placées ici; +* ``vendor/``: Par convention, toutes les bibliothèques tierces (additionnelles) sont placées ici; * ``web/``: Le répertoire racine web qui contient tous les fichiers publiquement accessibles; @@ -493,7 +495,7 @@ classe Kernel, ``AppKernel``, pour initialiser l'application (bootstrap). Les contrôleurs frontaux sont essentiels pour traiter chaque requête. Cependant, vous aurez rarement besoin de les modifier ou même d'y penser. -Nous en reparlerons dans la section `Environnements`_ . +Ils seront abordés dans la section `Environnements`_ . Le répertoire de l'application (``app``) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -528,7 +530,7 @@ Nous en apprendrons plus sur ces répertoires dans de prochains chapitres. Lorsque Symfony se charge, un fichier spécial - ``app/autoload.php`` - est inclus. Ce fichier s'occupe de configurer l'autoloader qui chargera automatiquement - tous vos fichiers depuis le répertoire ``src/`` et toutes les librairies tierces + tous vos fichiers depuis le répertoire ``src/`` et toutes les bibliothèques tierces depuis le repertoire ``vendor/``. Grace à l'autoloader, vous n'avez jamais à vous soucier d'utiliser les instructions @@ -549,9 +551,9 @@ Nous en apprendrons plus sur ces répertoires dans de prochains chapitres. src/Acme/HelloBundle/Controller/HelloController.php Typiquement, le seul moment où vous devrez vous soucier du fichier ``app/autoload.php`` - est quand vous inclurez des librairies tierces dans le repertoire ``vendor/``. + est quand vous inclurez des bibliothèques tierces dans le repertoire ``vendor/``. Pour plus d'informations sur le chargement automatique, voir - :doc: `Comment charger automatiquement des classes`. + :doc:`Comment charger automatiquement des classes`. Le répertoire des sources (``src/``) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -573,8 +575,8 @@ mais en mieux. La différence clé est que *tout* est un bundle dans Symfony2, c inclut le coeur du framework et le code de votre application. Les bundles sont aux premières loges dans Symfony2. Ils vous offrent la flexibilité d'utiliser des fonctionnalités pré-construites packagées dans des `bundles tiers`_ -ou de distribuer vos propres bundles. Cela rend facile de sélectionner quelles -fonctionnalités activer dans votre application et de les optimiser comme vous voulez. +ou de distribuer vos propres bundles. Cela facilite la sélection des +fonctionnalités à activer dans votre application et de les optimiser comme vous le voulez. .. note:: @@ -895,13 +897,13 @@ de production, appelez le contrôleur frontal de ``prod`` : Puisque l'environnement de ``prod`` est optimisé pour la vitesse; la configuration, -les routes et les templates Twig sont compilés en classes PHP et cachés. +les routes et les templates Twig sont compilés en classes PHP et mis en cache. Quand vous voudrez voir des changements en environnement de ``prod``, vous aurez -besoin de nettoyer ces fichiers cachés afin de permettre leur regénération : +besoin de nettoyer ces fichiers de cache afin de permettre leur regénération : .. code-block:: bash - php app/console cache:clear --env=prod --no-debug + $ php app/console cache:clear --env=prod --no-debug .. note:: @@ -1007,8 +1009,8 @@ en tête : * chaque projet contient juste quelques répertoires principaux : ``web/`` (ressources web et contrôleurs frontaux), ``app/`` (configuration), ``src/`` (vos bundles), - et ``vendor/`` (librairies tierces) (il y a aussi un répertoire ``bin/`` qui est utilisé - pour la mise à jour des librairies vendors); + et ``vendor/`` (bibliothèques tierces) (il y a aussi un répertoire ``bin/`` qui est utilisé + pour la mise à jour des bibliothèques vendors); * chaque fonctionnalité de Symfony2 (incluant le noyau du framework) est organisée dans un *bundle*, qui est un ensemble structuré de fichiers pour cette fonctionnalité; @@ -1030,4 +1032,4 @@ rapidement des applications. .. _`bundles tiers`: http://knpbundles.com .. _`Symfony Standard Edition`: http://symfony.com/download .. _`documentation Apache's DirectoryIndex`: http://httpd.apache.org/docs/2.0/mod/mod_dir.html -.. _`documentation Nginx HttpCoreModule`: http://wiki.nginx.org/HttpCoreModule#location \ No newline at end of file +.. _`documentation Nginx HttpCoreModule`: http://wiki.nginx.org/HttpCoreModule#location diff --git a/book/performance.rst b/book/performance.rst index c0e81fdde..fea070c49 100644 --- a/book/performance.rst +++ b/book/performance.rst @@ -113,14 +113,14 @@ Veuillez noter qu'il y a deux inconvénients à utiliser un fichier d'amorçage * le fichier nécessite d'être régénéré à chaque fois que les fichiers sources originaux changent (à savoir quand vous mettez à jour le code source de Symfony2 - ou une librairie tierce), + ou une bibliothèque tierce), * lors du débogage, vous devrez placer des points d'arrêt (breakpoints) dans ce fichier d'amorçage. Si vous utilisez l'édition Symfony2 standard, les fichiers d'amorçage sont automatiquement -regénérés après avoir mis à jour les librairies tierces (« vendors ») -grâce à la commande ``php bin/vendors install``. +regénérés après avoir mis à jour les bibliothèques tierces (« vendors ») +grâce à la commande ``composer.phar install``. Fichiers d'amorçage et caches de byte code ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -133,5 +133,5 @@ d'amorçage. .. _`caches de byte code`: http://en.wikipedia.org/wiki/List_of_PHP_accelerators .. _`APC`: http://php.net/manual/en/book.apc.php -.. _`autoloader.php`: https://github.com/symfony/symfony-standard/blob/2.0/app/autoload.php +.. _`autoloader.php`: https://github.com/symfony/symfony-standard/blob/2.1/app/autoload.php .. _`fichier d'amorçage`: https://github.com/sensio/SensioDistributionBundle/blob/master/Composer/ScriptHandler.php diff --git a/book/propel.rst b/book/propel.rst index 9b085a936..81bc1722c 100644 --- a/book/propel.rst +++ b/book/propel.rst @@ -54,10 +54,10 @@ généralement configurées dans un fichier ``app/config/parameters.yml`` : propel: dbal: - driver: %database_driver% - user: %database_user% - password: %database_password% - dsn: %database_driver%:host=%database_host%;dbname=%database_name%;charset=%database_charset% + driver: "%database_driver%" + user: "%database_user%" + password: "%database_password%" + dsn: "%database_driver%:host=%database_host%;dbname=%database_name%;charset=%database_charset%" Maintenant que Propel connaît votre base de données, Symfony2 peut créer cette dernière pour vous : diff --git a/book/routing.rst b/book/routing.rst index 1e857a1b1..06d1d87c0 100644 --- a/book/routing.rst +++ b/book/routing.rst @@ -1,5 +1,5 @@ .. index:: - single: Routage + single: Routing Routage ======= @@ -25,7 +25,7 @@ chapitre, vous serez capable de : * Débugger vos routes .. index:: - single: Routage; Les bases + single: Routing; Basics Le routage en Action -------------------- @@ -80,9 +80,7 @@ Le paramètre ``_controller`` est une clé spéciale qui dit à Symfony quel contrôleur doit être exécuté lorsqu'une URL correspond à cette route. La chaîne de caractères ``_controller`` est appelée le :ref:`nom logiqueUsername: getUser()->getUsername() ?>
+ Utiliser plusieurs fournisseurs d'utilisateurs ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -1257,8 +1254,9 @@ la base de données? C'est possible en créant un fournisseur qui lie les 2 four chain_provider: providers: [in_memory, user_db] in_memory: - users: - foo: { password: test } + memory: + users: + foo: { password: test } user_db: entity: { class: Acme\UserBundle\Entity\User, property: username } @@ -1271,7 +1269,9 @@ la base de données? C'est possible en créant un fournisseur qui lie les 2 four-
- {% for user in users %}
+ {% for user in users if user.active %}
- {{ user.username }} {% else %}
- Aucun utilisateur trouvé. @@ -565,7 +570,7 @@ passée au template ``list.html.twig`` en utilisant la commande ``with``. .. tip:: La syntaxe ``{'article': article}`` est la syntaxe standard de Twig pour les - tables de hachage (hash maps) (c-a-d un tableau clé-valeurs). Si nous souhaitons + tables de hachage (hash maps) (c-a-d un tableau clé-valeurs). Si vous souhaitez passer plusieurs elements, cela ressemblera à ceci : ``{'foo': foo, 'bar': bar}``. .. index:: @@ -624,10 +629,9 @@ Le template ``recentList`` est simplement le suivant : .. note:: - Remarquons que nous avons triché et que nous avons codé en dur les URLs des - articles dans cet exemple (``/article/*slug*`` par exemple). Ce n'est pas - une bonne pratique. Dans la section suivante, vous apprendrez comment le - faire correctement. + Notez que dans l'exemple de cet article, les URLs sont codées en dur + (``/article/*slug*`` par exemple). Ce n'est pas une bonne pratique. Dans + la section suivante, vous apprendrez comment le faire correctement. Pour inclure le contrôleur, vous avez besoin de faire référence à ce dernier en utilisant la chaîne de caractères standard pour les contrôleurs @@ -665,10 +669,10 @@ Contenu asynchrone avec hinclude.js .. versionadded:: 2.1 hinclude.js support was added in Symfony 2.1 -Les contrôleurs peuvent être imbriqués de façon asynchrone avec la librairie +Les contrôleurs peuvent être imbriqués de façon asynchrone avec la bibliothèque javascript hinclude.js_. Comme le contenu imbriqué vient d'une autre page (un d'un autre contrôleur), -Symfony2 utiliser le helper standard ``render`` pour configurer les tags ``hinclude``: +Symfony2 utilise le helper standard ``render`` pour configurer les tags ``hinclude``: .. configuration-block:: @@ -897,7 +901,7 @@ conservant les avantages du mécanisme d'héritage de templates de Symfony. Commencons par ajouter deux blocs à notre template de base qui incluront deux fichiers : l'un s'appelle ``stylesheet`` et est inclus dans la balise ``head``, et -l'autre s'appelle ``javascript`` et est inclus juste avant que la base ``body`` ne se +l'autre s'appelle ``javascript`` et est inclus juste avant que la balise ``body`` ne se referme. Ces blocs contiendront toutes les feuilles de style et tous les fichiers javascript dont vous aurez besoin pour votre site : @@ -1111,7 +1115,7 @@ Trois niveaux d'héritages Une façon commune d'utiliser l'héritage est d'utiliser l'approche à trois niveaux. Cette méthode fonctionne parfaitement avec trois différents types -de templates que nous détaillons : +de templates détaillés : * Créez un fichier ``app/Resources/views/base.html.twig`` qui contient le principal layout pour votre application (comme dans l'exemple précédent). En diff --git a/book/testing.rst b/book/testing.rst index b7094287b..e1a578bd0 100644 --- a/book/testing.rst +++ b/book/testing.rst @@ -302,7 +302,7 @@ document XML/HTML : // Vérifie que le status de la réponse est 404 $this->assertTrue($client->getResponse()->isNotFound()); // Vérifie un status spécifique - $this->assertEquals(200, $client->getResponse()->getStatus()); + $this->assertEquals(200, $client->getResponse()->getStatusCode()); // Vérifie que la réponse est redirigée vers /demo/contact $this->assertTrue($client->getResponse()->isRedirect('/demo/contact')); @@ -462,8 +462,8 @@ application, utilisez la commande ``container:debug``. Accéder aux données du profileur ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Pour chaque requête, vous pouvez activer le profileur Symfony afin de -collecter et stocker diverses informations sur la gestion interne des requêtes. +Pour chaque requête, le profileur Symfony collecte et stocke diverses informations +sur la gestion interne des requêtes. Par exemple, le profileur peut être utilisé pour vérifier qu'une page donnée ne dépasse pas un certain nombre de requêtes en base de données lors de son chargement. @@ -471,12 +471,6 @@ Pour obtenir le profileur de la dernière requête, utilisez le code suivant: .. code-block:: php - // active le profileur pour la requête suivante - $client->enableProfiler(); - - $crawler = $client->request('GET', '/profiler'); - - // récupère le profil $profile = $client->getProfile(); Pour des détails spécifique sur l'utilisation du profileur au sein d'un test, @@ -609,7 +603,7 @@ très pratique ``selectLink()`` : $crawler->selectLink('Click here'); Cela sélectionne tous les liens qui contiennent le texte donné, ou les images -cliquables dont l'attribut ``alt``contient ce texte. Comme les autres méthodes +cliquables dont l'attribut ``alt`` contient ce texte. Comme les autres méthodes de filtre, cela retourne un autre objet ``Crawler``. Une fois que vous avez sélectionné un lien, vous avez accès à l'objet spécial ``Link``, @@ -635,7 +629,7 @@ Comme pour les liens, vous sélectionnez les formulaires à l'aide de la méthod .. note:: - Notez que nous sélectionnons les boutons de formulaire et non pas les formulaires + Notez que vous sélectionnez les boutons de formulaire et non pas les formulaires eux-mêmes car un formulaire peut contenir plusieurs boutons; si vous utilisez l'API de traversement, gardez en mémoire que vous devez chercher un bouton. @@ -857,7 +851,7 @@ En savoir plus * :doc:`/cookbook/testing/http_authentication` * :doc:`/cookbook/testing/insulating_clients` * :doc:`/cookbook/testing/profiling` - +* :doc:`/cookbook/testing/bootstrap` .. _`DemoControllerTest`: https://github.com/symfony/symfony-standard/blob/master/src/Acme/DemoBundle/Tests/Controller/DemoControllerTest.php .. _`$_SERVER`: http://php.net/manual/en/reserved.variables.server.php diff --git a/book/translation.rst b/book/translation.rst index 57d75f73c..3dc6c1238 100644 --- a/book/translation.rst +++ b/book/translation.rst @@ -23,22 +23,22 @@ une fonction capable de traduire le texte (ou « message ») dans la langue de l Le terme *locale* désigne en gros la langue et le pays de l'utilisateur. Cela peut être n'importe quelle chaîne de caractères que votre application va utiliser pour gérer les traductions et autres différences de format (par ex. format de monnaie). - Nous recommandons le code *langue* `ISO639-1`_, un « underscore » (``_``), et ensuite le code - *pays* `ISO3166 Alpha-2`_ (par ex. ``fr_FR`` pour Français/France). + Le code *langue* `ISO639-1`_, un « underscore » (``_``), et ensuite le code + *pays* `ISO3166 Alpha-2`_ (par ex. ``fr_FR`` pour Français/France) est recommandé. -Dans ce chapitre, nous allons apprendre comment préparer une application à gérer de multiples +Dans ce chapitre, vous apprendrez comment préparer une application à gérer de multiples locales et ensuite comment créer des traductions pour plusieurs locales. Dans l'ensemble, le processus a plusieurs étapes communes : -1. Activer et configurer le composant ``Translation`` de Symfony ; +#. Activer et configurer le composant ``Translation`` de Symfony ; -2. Faire abstraction des chaînes de caractères (i.e. « messages ») en les encadrant +#. Faire abstraction des chaînes de caractères (i.e. « messages ») en les encadrant avec des appels au ``Translator`` ; -3. Créer des ressources de traduction pour chaque locale supportée qui traduit +#. Créer des ressources de traduction pour chaque locale supportée qui traduit chaque message dans l'application ; -4. Déterminer, définir et gérer la locale de l'utilisateur dans la requête, et +#. Déterminer, définir et gérer la locale de l'utilisateur dans la requête, et optionnellement dans la session. @@ -97,7 +97,7 @@ La traduction du texte est faite à travers le service ``translator`` (:class:`Symfony\\Component\\Translation\\Translator`). Pour traduire un bloc de texte (appelé un *message*), utilisez la méthode :method:`Symfony\\Component\\Translation\\Translator::trans`. Supposons, -par exemple, que nous traduisons un simple message dans un contrôleur : +par exemple, que vous traduisez un simple message dans un contrôleur : .. code-block:: php @@ -110,7 +110,7 @@ par exemple, que nous traduisons un simple message dans un contrôleur : Quand ce code est exécuté, Symfony2 va essayer de traduire le message « Symfony2 is great » en se basant sur la ``locale`` de l'utilisateur. Pour que -cela marche, nous devons dire à Symfony2 comment traduire le message via une +cela marche, vous devez dire à Symfony2 comment traduire le message via une « ressource de traduction », qui est une collection de traductions de messages pour une locale donnée. Ce « dictionnaire » de traduction peut être créé en plusieurs formats différents, XLIFF étant le format recommandé : @@ -186,7 +186,7 @@ Parfois, un message contenant une variable a besoin d'être traduit : Cependant, créer une traduction pour cette chaîne de caractères est impossible étant donné que le traducteur va essayer de trouver le message exact, incluant les portions de la variable (par ex. « Hello Ryan » ou « Hello Fabien »). Au lieu d'écrire une traduction -pour toutes les itérations possibles de la variable ``$name``, nous pouvons remplacer la +pour toutes les itérations possibles de la variable ``$name``, vous pouvez remplacer la variable avec un paramètre de substitution (« placeholder ») : .. code-block:: php @@ -238,12 +238,12 @@ se fait comme précédemment : de PHP . Cependant, la notation ``%var%`` est requise pour les traductions dans les templates Twig, et c'est une convention générale à suivre. -Comme nous l'avons vu, créer une traduction est un processus en deux étapes : +Comme vous l'avez vu, créer une traduction est un processus en deux étapes : -1. Faire abstraction du message qui a besoin d'être traduit en le passant à travers +#. Faire abstraction du message qui a besoin d'être traduit en le passant à travers le ``Translator``. -2. Créer une traduction pour le message dans chaque locale que vous avez choisi de +#. Créer une traduction pour le message dans chaque locale que vous avez choisi de supporter. La deuxième étape est faite en créant des catalogues de messages qui définissent les traductions @@ -398,7 +398,7 @@ Symfony2 va reconnaître ces fichiers et les utiliser lors de la traduction de locale par défaut (i.e. pour traduire ``symfony2.great`` en ``Symfony2 is great``). La deuxième méthode est très pratique car la clé du message n'aura pas besoin d'être modifiée - dans chaque fichier de traduction si nous décidons que le message devrait en fait + dans chaque fichier de traduction si vous décidez que le message devrait en fait être « Symfony2 is really great » dans la locale par défaut. Le choix de la méthode à utiliser dépend entièrement de vous, mais le format « mot-clé » @@ -465,7 +465,7 @@ Symfony2 va reconnaître ces fichiers et les utiliser lors de la traduction de Utiliser les Domaines de Message -------------------------------- -Comme nous l'avons vu, les fichiers de messages sont organisés par les différentes locales +Comme vous l'avez vu, les fichiers de messages sont organisés par les différentes locales qu'ils traduisent. Pour plus de structure, les fichiers de messages peuvent également être organisés en « domaines ». Lors de la création des fichiers de messages, le domaine est la première partie du nom du fichier. Le domaine par défaut est ``messages``. Par exemple, supposons que, @@ -497,9 +497,11 @@ via l'objet ``request`` : .. code-block:: php - // access the request object in a standard controller + // Accéder à l'objet Request dans un contrôleur standard $request = $this->getRequest(); + $locale = $request->getLocale(); + $request->setLocale('en_US'); .. index:: @@ -682,7 +684,7 @@ utilisée pour déterminer quelle forme de pluriel utiliser. Les tags peuvent ê chaîne descriptive qui se termine par un deux-points (``:``). Les tags n'ont pas besoin d'être les mêmes dans le message original que dans la traduction. -.. tip: +.. tip:: Comme les tags sont optionnels, le traducteur ne les utilise pas (il va seulement obtenir une chaîne de caractères en fonction de sa position dans la chaîne). @@ -854,7 +856,7 @@ manuellement la locale à utiliser pour la traduction : 'Symfony2 is great', array(), 'messages', - 'fr_FR', + 'fr_FR' ); $this->get('translator')->transChoice( @@ -862,7 +864,7 @@ manuellement la locale à utiliser pour la traduction : 10, array('%count%' => 10), 'messages', - 'fr_FR', + 'fr_FR' ); Traduire le Contenu d'une Base de Données diff --git a/book/validation.rst b/book/validation.rst index 4d90904c7..ad9a54381 100644 --- a/book/validation.rst +++ b/book/validation.rst @@ -14,7 +14,7 @@ transparente. Ce composant est basé sur la `spécification JSR303`_. Quoi ? Une spécification Java en PHP? Vous avez bien entendu, mais ce n'est pas aussi terrible que ça en a l'air. Regardons comment elle peut être utilisée en PHP. -.. index: +.. index:: single: Validation; Les bases Les Bases de la Validation @@ -227,7 +227,7 @@ au code suivant:: $author = new Author(); $form = $this->createForm(new AuthorType(), $author); - if ($request->getMethod() == 'POST') { + if ($request->isMethod('POST')) { $form->bind($request); if ($form->isValid()) { @@ -502,7 +502,8 @@ pour avoir au moins 3 caractères. properties: firstName: - NotBlank: ~ - - MinLength: 3 + - Length: + min: 3 .. code-block:: php-annotations @@ -513,7 +514,7 @@ pour avoir au moins 3 caractères. { /** * @Assert\NotBlank() - * @Assert\MinLength(3) + * @Assert\Length(min = "3") */ private $firstName; } @@ -525,7 +526,9 @@ pour avoir au moins 3 caractères.
- {{ error.messageTemplate|trans(error.messageParameters, 'validators') }} +
- {{ + error.messagePluralization is null + ? error.messageTemplate|trans(error.messageParameters, 'validators') + : error.messageTemplate|transchoice(error.messagePluralization, error.messageParameters, 'validators') + }} {% endfor %}
- trans( - $error->getMessageTemplate(), - $error->getMessageParameters(), - 'validators' - ) ?> +
- getMessagePluralization()) { + echo $view['translator']->trans( + $error->getMessageTemplate(), + $error->getMessageParameters(), + 'validators' + ); + } else { + echo $view['translator']->transChoice( + $error->getMessageTemplate(), + $error->getMessagePluralization(), + $error->getMessageParameters(), + 'validators' + ); + }?>
-
{% for error in errors %}
-
-
-
{{ form_label(form) }}
{{ form_errors(form) }}
{{ form_widget(form) }}
- {% endblock field_row %}
+ {% endblock form_row %}
.. code-block:: html+php
-
+
label($form) ?>
errors($form) ?>
@@ -813,17 +827,17 @@ Ajouter une astérisque « obligatoire » sur les libellés de champs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Si vous voulez marquer tous les champs obligatoires par une astérisque (``*``),
-vous pouvez le faire en personnalisant le fragment ``field_label``.
+vous pouvez le faire en personnalisant le fragment ``form_label``.
Avec Twig, si vous faites cette personnalisation dans le même template que votre
formulaire, modifiez le tag ``use`` et ajoutez ce qui suit :
.. code-block:: html+jinja
- {% use 'form_div_layout.html.twig' with field_label as base_field_label %}
+ {% use 'form_div_layout.html.twig' with form_label as base_form_label %}
- {% block field_label %}
- {{ block('base_field_label') }}
+ {% block form_label %}
+ {{ block('base_form_label') }}
{% if required %}
*
@@ -837,7 +851,7 @@ ce qui suit :
{% extends 'form_div_layout.html.twig' %}
- {% block field_label %}
+ {% block form_label %}
{{ parent() }}
{% if required %}
@@ -850,10 +864,14 @@ depuis le template original :
.. code-block:: html+php
-
+
-
+
+
+ humanize($name); } ?>
+
+
@@ -875,10 +893,10 @@ formulaire, modifiez le tag ``use`` et ajoutez ce qui suit :
.. code-block:: html+jinja
- {% use 'form_div_layout.html.twig' with field_widget as base_field_widget %}
+ {% use 'form_div_layout.html.twig' with form_widget_simple as base_form_widget_simple %}
- {% block field_widget %}
- {{ block('base_field_widget') }}
+ {% block form_widget_simple %}
+ {{ block('base_form_widget_simple') }}
{% if help is defined %}
{{ help }}
@@ -891,7 +909,7 @@ Avec Twig, si vous faites les changements dans un template séparé, procédez c
{% extends 'form_div_layout.html.twig' %}
- {% block field_widget %}
+ {% block form_widget_simple %}
{{ parent() }}
{% if help is defined %}
@@ -904,13 +922,13 @@ depuis le template original :
.. code-block:: html+php
-
+
"
- value="escape($value) ?>"
- renderBlock('attributes') ?>
+ type="escape($type) : 'text' ?>"
+ value="escape($value) ?>"
+ block($form, 'widget_attributes') ?>
/>
@@ -935,4 +953,29 @@ une variable ``help`` :
Lisez :ref:`cookbook-form-theming-methods` pour savoir comment appliquer ces personnalisations.
-.. _`form_div_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/form_div_layout.html.twig
\ No newline at end of file
+Utiliser les Variables
+----------------------
+
+La plupart des fonctions disponibles pour afficher les différents parties
+d'un formulaire (ex widget, label, erreurs, etc) vous permettent également
+de réaliser certaines personnalisations directement. Jetez un oeil à l'exemple
+suivant :
+
+.. configuration-block::
+
+ .. code-block:: jinja
+
+ {# affiche un widget, mais y ajoute la classe "foo" #}
+ {{ form_widget(form.name, { 'attr': {'class': 'foo'} }) }}
+
+ .. code-block:: php
+
+
+ widget($form['name'], array('attr' => array(
+ 'class' => 'foo',
+ ))) ?>
+
+Le tableau passé comme second argument contient des « variables » de formulaire.
+Pour plus de détails sur ce concept de Twig, lisez :ref:`twig-reference-form-variables`.
+
+.. _`form_div_layout.html.twig`: https://github.com/symfony/symfony/blob/2.1/src/Symfony/Bridge/Twig/Resources/views/Form/form_div_layout.html.twig
\ No newline at end of file
diff --git a/cookbook/form/index.rst b/cookbook/form/index.rst
index f635a02b4..a237d283c 100644
--- a/cookbook/form/index.rst
+++ b/cookbook/form/index.rst
@@ -9,4 +9,5 @@ Formulaire
dynamic_form_generation
form_collections
create_custom_field_type
+ create_form_type_extension
use_virtuals_forms
diff --git a/cookbook/form/use_virtuals_forms.rst b/cookbook/form/use_virtuals_forms.rst
index e900881c9..2ca2c2943 100644
--- a/cookbook/form/use_virtuals_forms.rst
+++ b/cookbook/form/use_virtuals_forms.rst
@@ -80,7 +80,7 @@ Commencez par créer un ``CompanyType`` et un ``CustomerType``::
}
}
-Maintenant, nous devons gérer les quatre champs dupliqués. Vous pouvez
+Maintenant, les quatre champs dupliqués doivent être gérés. Vous pouvez
voir ci-dessous un (simple) type de formulaire « location » (« lieu » en
français)::
@@ -114,14 +114,14 @@ français)::
}
}
-Nous n'avons *en fait* pas de champ « location » dans nos entités, donc nous
-ne pouvons pas lier directement notre ``LocationType`` à notre ``CompanyType`` ou à notre
-``CustomerType``. Mais nous voulons absolument avoir un type de formulaire dédié pour
+Vous n'avez *en fait* pas de champ « location » dans vos entités, donc vous
+ne pouvez pas lier directement votre ``LocationType`` à votre ``CompanyType`` ou à votre
+``CustomerType``. Mais vous voulez absolument avoir un type de formulaire dédié pour
gérer le lieu (rappelez-vous, DRY - Don't Repeat Yourself!).
L'option de champ de formulaire ``virtual`` est la solution.
-Nous pouvons définir l'option ``'virtual' => true`` dans la méthode
+Vous pouvez définir l'option ``'virtual' => true`` dans la méthode
``setDefaultOptions()`` de ``LocationType`` et commencer à l'utiliser directement
dans les deux types de formulaires initiaux.
@@ -148,8 +148,8 @@ Voyez le résultat::
Avec l'option « virtual » définie à « false » (comportement par défaut),
le composant Form s'attend à ce que chaque objet sous-jacent ait une propriété
``foo`` (ou ``bar``) qui soit un objet ou un tableau contenant les quatre
-champs du lieu. Bien sûr, nous n'avons pas cet objet/tableau dans nos
-entités et nous ne le voulons pas.
+champs du lieu. Bien sûr, vous n'avez pas cet objet/tableau dans vos
+entités et vous ne le voulez pas.
Avec l'option « virtual » définie à « true », le composant Form ne s'occupe pas
de la propriété ``foo`` (ou ``bar``), et à la place « récupère » et « définit » (« gets »
diff --git a/cookbook/index.rst b/cookbook/index.rst
index 80c4d8bd7..79279942b 100755
--- a/cookbook/index.rst
+++ b/cookbook/index.rst
@@ -27,5 +27,6 @@ Le Cookbook
profiler/index
web_services/index
symfony1
+ deployment_tools
.. include:: /cookbook/map.rst.inc
diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
index 77b79823d..f8902b8fa 100644
--- a/cookbook/map.rst.inc
+++ b/cookbook/map.rst.inc
@@ -28,6 +28,7 @@
* :doc:`/cookbook/console/console_command`
* :doc:`/cookbook/console/usage`
+ * :doc:`/cookbook/console/generating_urls`
* :doc:`/cookbook/controller/index`
@@ -71,6 +72,7 @@
* :doc:`/cookbook/form/dynamic_form_generation`
* :doc:`/cookbook/form/form_collections`
* :doc:`/cookbook/form/create_custom_field_type`
+ * :doc:`/cookbook/form/create_form_type_extension`
* :doc:`/cookbook/form/use_virtuals_forms`
* (validation) :doc:`/cookbook/validation/custom_constraint`
* (doctrine) :doc:`/cookbook/doctrine/file_uploads`
@@ -95,6 +97,7 @@
* :doc:`/cookbook/routing/slash_in_parameter`
* :doc:`/cookbook/routing/redirect_in_config`
* :doc:`/cookbook/routing/method_parameters`
+ * :doc:`/cookbook/routing/service_container_parameters`
* **symfony1**
@@ -132,6 +135,7 @@
* :doc:`/cookbook/testing/insulating_clients`
* :doc:`/cookbook/testing/profiling`
* :doc:`/cookbook/testing/doctrine`
+ * :doc:`/cookbook/testing/bootstrap`
* :doc:`/cookbook/validation/index`
@@ -145,3 +149,5 @@
* :doc:`/cookbook/workflow/new_project_git`
* :doc:`/cookbook/workflow/new_project_svn`
+
+* :doc:`/cookbook/deployment_tools`
diff --git a/cookbook/profiler/data_collector.rst b/cookbook/profiler/data_collector.rst
index 163d8f2f7..b99d0d5c9 100644
--- a/cookbook/profiler/data_collector.rst
+++ b/cookbook/profiler/data_collector.rst
@@ -154,12 +154,12 @@ votre template est dans un ``AcmeDebugBundle`` :
data_collector.your_collector_name:
class: Acme\DebugBundle\Collector\Class\Name
tags:
- - { name: data_collector, template: "AcmeDebug:Collector:templatename", id: "your_collector_name" }
+ - { name: data_collector, template: "AcmeDebugBundle:Collector:templatename", id: "your_collector_name" }
.. code-block:: xml
-
.. code-block:: php
diff --git a/cookbook/routing/index.rst b/cookbook/routing/index.rst
index 1344714c0..b13ec6fd2 100644
--- a/cookbook/routing/index.rst
+++ b/cookbook/routing/index.rst
@@ -8,3 +8,4 @@ Routage
slash_in_parameter
redirect_in_config
method_parameters
+ service_container_parameters
\ No newline at end of file
diff --git a/cookbook/routing/redirect_in_config.rst b/cookbook/routing/redirect_in_config.rst
index 365ebda88..a2d69cda3 100644
--- a/cookbook/routing/redirect_in_config.rst
+++ b/cookbook/routing/redirect_in_config.rst
@@ -7,7 +7,7 @@ Comment configurer une redirection vers une autre route sans contrôleur personn
Ce guide explique comment configurer une redirection d'une route vers une autre
sans utiliser de contrôleur spécifique.
-Supposons qu'il n'existe pas de contrôleur par défaut pour l'URL ``/`` de votre
+Supposez qu'il n'existe pas de contrôleur par défaut pour l'URL ``/`` de votre
application et que vous voulez rediriger ces requêtes vers ``/app``.
Votre configuration ressemblerait à ceci :
@@ -26,18 +26,17 @@ Votre configuration ressemblerait à ceci :
path: /app
permanent: true
-Votre ``AppBundle`` est enregistré pour prendre en charge tout les requêtes qui commencent
-par ``/app``.
-Nous configurons une route pour le chemin ``/`` et laissons le
-:class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\RedirectController`
-le gérer. Ce contrôleur est prêt à fonctionner et propose deux méthodes pour
-gérer les requêtes :
-
-* ``redirect`` redirige vers une autre *route*. Vous devez spécifier le paramètre ``route``
- avec le *nom* de la route vers laquelle vous voulez rediriger.
+Dans cet exemple, vous configurez une route pour le chemin ``/`` et laissez
+la classe :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\RedirectController`
+la gérer. Ce contrôleur est fourni avec Symfony et propose deux actions pour
+rediriger les requêtes :
* ``urlRedirect`` redirige vers un autre *chemin*. Vous devez spécifier le paramètre ``path``
pour qu'il contienne le chemin vers la ressource vers laquelle vous voulez rediriger.
-Le paramètre ``permanent`` indique que les deux méthodes utiliseront un code statut HTTP 301.
+* ``redirect`` (pas montré ici) redirige vers une autre *route*. Vous devez définir le
+ paramètre ``route`` avec le *nom* de la route vers laquelle vous voulez rediriger.
+
+Le paramètre ``permanent`` indique aux deux méthodes de retourner un code de statut
+HTTP 301 au lieu du code ``302`` par défaut.
diff --git a/cookbook/routing/service_container_parameters.rst b/cookbook/routing/service_container_parameters.rst
new file mode 100644
index 000000000..0b16ccac6
--- /dev/null
+++ b/cookbook/routing/service_container_parameters.rst
@@ -0,0 +1,123 @@
+.. index::
+ single: Routing; Service Container Parameters
+
+Comment utiliser des paramètres du conteneur de services dans vos routes
+========================================================================
+
+.. versionadded:: 2.1
+ La possibilité d'utiliser ces paramètres dans vos routes est une
+ nouveauté de Symfony 2.1.
+
+Parfois, vous pouvez trouver utile de rendre certaines parties de vos
+routes configurables de façon globale. Par exemple, si vous construisez
+un site internationalisé, vous commencerez probablement pas une ou deux
+locales. Vous ajouterez certainement un prérequis dans vos routes pour
+empêcher l'utilisateur d'accéder à une autre locale que celles que vous
+supportez.
+
+Vous *pourriez* coder en dure votre prérequis ``_locale`` dans toutes vos
+routes. Mais une meilleure solution sera d'utiliser un paramètre configurable
+du conteneur de services dans la configuration de votre routage :
+
+.. configuration-block::
+
+ .. code-block:: yaml
+
+ contact:
+ pattern: /{_locale}/contact
+ defaults: { _controller: AcmeDemoBundle:Main:contact }
+ requirements:
+ _locale: %acme_demo.locales%
+
+ .. code-block:: xml
+
+
+
+
+
+
+ AcmeDemoBundle:Main:contact
+ %acme_demo.locales%
+
+
+
+ .. code-block:: php
+
+ use Symfony\Component\Routing\RouteCollection;
+ use Symfony\Component\Routing\Route;
+
+ $collection = new RouteCollection();
+ $collection->add('contact', new Route('/{_locale}/contact', array(
+ '_controller' => 'AcmeDemoBundle:Main:contact',
+ ), array(
+ '_locale' => '%acme_demo.locales%',
+ )));
+
+ return $collection;
+
+Vous pouvez maintenant contrôler et définir le paramètre ``acme_demo.locales``
+quelque part dans votre conteneur :
+
+.. configuration-block::
+
+ .. code-block:: yaml
+
+ # app/config/config.yml
+ parameters:
+ acme_demo.locales: en|es
+
+ .. code-block:: xml
+
+
+
+ en|es
+
+
+ .. code-block:: php
+
+ # app/config/config.php
+ $container->setParameter('acme_demo.locales', 'en|es');
+
+Vous pouvez aussi utiliser un paramètre pour définir votre schéma de route
+(ou une partie de votre schéma) :
+
+.. configuration-block::
+
+ .. code-block:: yaml
+
+ some_route:
+ pattern: /%acme_demo.route_prefix%/contact
+ defaults: { _controller: AcmeDemoBundle:Main:contact }
+
+ .. code-block:: xml
+
+
+
+
+
+
+ AcmeDemoBundle:Main:contact
+
+
+
+ .. code-block:: php
+
+ use Symfony\Component\Routing\RouteCollection;
+ use Symfony\Component\Routing\Route;
+
+ $collection = new RouteCollection();
+ $collection->add('some_route', new Route('/%acme_demo.route_prefix%/contact', array(
+ '_controller' => 'AcmeDemoBundle:Main:contact',
+ )));
+
+ return $collection;
+
+.. note::
+
+ Tout comme dans les fichiers de configuration classiques du conteneur, si vous
+ avez besoin d'un ``%`` dans votre route, vous pouvez échapper le signe popurcentage
+ en le doublant. Par exemple, ``/score-50%%`` deviendra ``/score-50%``.
\ No newline at end of file
diff --git a/cookbook/routing/slash_in_parameter.rst b/cookbook/routing/slash_in_parameter.rst
index 00095cca8..ec952ef03 100644
--- a/cookbook/routing/slash_in_parameter.rst
+++ b/cookbook/routing/slash_in_parameter.rst
@@ -1,11 +1,11 @@
.. index::
- single: Routage; Autoriser un / dans un paramètre route
+ single: Routage; Autoriser un / dans un paramètre de route
-Comment autoriser un caractère « / » dans un paramètre route
-============================================================
+Comment autoriser un caractère « / » dans un paramètre de route
+===============================================================
-Quelquefois, vous avez besoin de composer des URLs avec des paramètres qui
-peuvent contenir un slash ``/``. Par exemple, prenez la route classique
+Parfois, on a besoin de construire des URLs avec des paramètres qui
+peuvent contenir un slash ``/``. Prenons par exemple la route classique
``/hello/{name}``. Par défaut, ``/hello/Fabien`` va correspondre à cette
route mais pas ``/hello/Fabien/Kris``. Cela est dû au fait que Symfony
utilise ce caractère comme séparateur entre les parties de la route.
@@ -19,7 +19,7 @@ Configurer la Route
Par défaut, les composants de routage de Symfony requièrent que les paramètres
correspondent au pattern de regex suivant : ``[^/]+``. Cela veut dire que tous
-les caractères sont autorisés excepté ``/``.
+les caractères sont autorisés sauf ``/``.
Vous devez explicitement autoriser le caractère ``/`` à faire partie de votre
paramètre en spécifiant un pattern de regex plus permissif.
diff --git a/cookbook/security/acl.rst b/cookbook/security/acl.rst
index fb1a960cf..6199469db 100644
--- a/cookbook/security/acl.rst
+++ b/cookbook/security/acl.rst
@@ -13,12 +13,12 @@ Imaginez que vous êtes en train de créer un système de blog dans lequel vos
utilisateurs peuvent commenter vos posts. Maintenant, vous voulez qu'un
utilisateur puisse éditer ses propres commentaires, mais pas ceux d'autres
utilisateurs ; en outre, vous voulez vous-même être capable d'éditer tous
-les commentaires. Dans ce scénario, ``Comment`` (commentaire) serait notre objet domaine
+les commentaires. Dans ce scénario, ``Comment`` (commentaire) serait l'objet
auquel vous souhaitez restreindre l'accès. Vous pouvez envisager plusieurs
approches pour accomplir cela en utilisant Symfony2 ; les deux approches basiques
sont (liste non-exhaustive) :
-- *Forcer la sécurité dans vos méthodes business* : cela signifie garder une
+- *Forcer la sécurité dans vos méthodes métier* : cela signifie garder une
référence dans chaque ``Comment`` de tous les utilisateurs qui ont accès, et
alors de comparer ces utilisateurs avec le ``Token`` fourni.
- *Forcer la sécurité avec des rôles* : avec cette approche, vous ajouteriez
@@ -26,19 +26,19 @@ sont (liste non-exhaustive) :
``ROLE_COMMENT_2``, etc.
Les deux approches sont parfaitement valides. Cependant, elles associent votre
-logique d'autorisation à votre code business, ce qui rend le tout moins
+logique d'autorisation à votre code métier, ce qui rend le tout moins
réutilisable ailleurs, et qui augmente aussi la difficulté d'effectuer des tests
unitaires. En outre, vous pourriez rencontrer des problèmes de performance
si beaucoup d'utilisateurs accédaient à un même et unique objet domaine.
-Heureusement, il y a une meilleure façon de faire, dont nous allons parler
+Heureusement, il y a une meilleure façon de faire, que vous allez découvrir
maintenant.
Initialisation (« Bootstrapping » en anglais)
---------------------------------------------
-Maintenant, avant que nous puissions finalement passer à l'action, nous avons
-besoin d'effectuer certaines initialisations. Premièrement, nous devons
+Maintenant, avant que vous puissiez finalement passer à l'action, vous avez
+besoin d'effectuer certaines initialisations. Premièrement, vous devez
configurer la connexion que le système d'ACL est supposé utiliser :
.. configuration-block::
@@ -67,25 +67,26 @@ configurer la connexion que le système d'ACL est supposé utiliser :
.. note::
- Le système ACL requiert au moins qu'une connexion DBAL Doctrine soit
+ Le système ACL requiert qu'une connexion DBAL Doctrine (utilisable par défaut)
+ ou qu'une connexion ODM Doctrine (utilisable avec `MongoDBAclBundle`_) soit
configurée. Cependant, cela ne veut pas dire que vous devez utiliser
- Doctrine pour faire correspondre vos objets domaine. Vous pouvez utiliser
- n'importe quel outil de correspondance de votre choix pour vos objets, que ce
- soit l'ORM Doctrine, l'ODM Mongo, Propel, ou du SQL brut, le choix reste
- le vôtre.
+ l'ORM ou l'ODM Doctrine pour faire correspondre vos objets. Vous
+ pouvez utiliser l'outil de correspondance de votre choix pour
+ vos objets, que ce soit l'ORM Doctrine, l'ODM Mongo, Propel, ou du SQL brut,
+ le choix reste le vôtre.
-Après que la connexion est configurée, nous devons importer la structure de
-la base de données. Heureusement, nous avons une tâche pour cela. Exécutez
+Une fois la connexion configurée, vous devez importer la structure de
+la base de données. Heureusement, il existe une tâche pour cela. Exécutez
simplement la commande suivante :
-.. code-block:: text
+.. code-block:: bash
- php app/console init:acl
+ $ php app/console init:acl
Démarrage
---------
-Revenons à notre petit exemple depuis le début et implémentons ses ACLs.
+Revenez au petit exemple du début et implémentez ses ACLs.
Créer un ACL, et ajouter un ACE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -143,13 +144,13 @@ permet de travailler avec les ACLs même si vous n'avez pas d'instance d'objet
domaine sous la main. Cela va être extrêmement utile si vous voulez vérifier
les permissions pour un grand nombre d'objets sans avoir à les désérialiser.
-L'autre partie intéressante est l'appel à ``->insertObjectAce()``. Dans notre
-exemple, nous accordons à l'utilisateur qui est connecté un accès propriétaire
+L'autre partie intéressante est l'appel à ``->insertObjectAce()``. Dans
+l'exemple, vous accordez à l'utilisateur connecté un accès propriétaire
au Comment. Le ``MaskBuilder::MASK_OWNER`` est un masque binaire prédéfini ;
ne vous inquiétez pas, le constructeur de masque va abstraire la plupart des
-détails techniques, mais en utilisant cette technique nous pouvons stocker
-beaucoup de différentes permissions dans une même ligne de base de données ;
-ce qui nous offre un boost considérable au niveau performance.
+détails techniques, mais en utilisant cette technique vous pouvez stocker
+plein de permissions différentes dans une même ligne de base de données ;
+ce qui vous offre un avantage considérable au niveau performance.
.. tip::
@@ -183,7 +184,7 @@ Vérification des Accès
}
}
-Dans cet exemple, nous vérifions que l'utilisateur possède la permission
+Dans cet exemple, vous vérifiez que l'utilisateur possède la permission
``EDIT``. En interne, Symfony2 fait correspondre la permission avec
plusieurs masques binaires, et vérifie si l'utilisateur possède l'un
d'entre eux.
@@ -197,10 +198,10 @@ d'entre eux.
Permissions Cumulées
--------------------
-Dans notre premier exemple ci-dessus, nous avons accordé uniquement la
+Dans le premier exemple ci-dessus, vous avez accordé uniquement la
permission basique ``OWNER`` à l'utilisateur. Bien que cela permette aussi
à l'utilisateur d'effectuer n'importe quelle opération telle que la lecture,
-l'édition, etc. sur l'objet domaine, il y a des cas où nous voulons accorder
+l'édition, etc. sur l'objet domaine, il y a des cas où vous voudrez accorder
ces permissions explicitement.
Le ``MaskBuilder`` peut être utilisé pour créer des masques binaires facilement
@@ -227,3 +228,5 @@ Ce masque binaire représenté par un entier peut ainsi être utilisé pour acco
L'utilisateur a désormais le droit de lire, éditer, supprimer, et annuler
une suppression sur des objets.
+
+.. _`MongoDBAclBundle`: https://github.com/IamPersistent/MongoDBAclBundle
diff --git a/cookbook/security/acl_advanced.rst b/cookbook/security/acl_advanced.rst
index 1a679ee9b..2a802b21d 100644
--- a/cookbook/security/acl_advanced.rst
+++ b/cookbook/security/acl_advanced.rst
@@ -27,9 +27,8 @@ Comme spécifié dans le premier point, l'une des principales facultés du syst
ACL de Symfony2 est de fournir une manière très performante de récupérer des
ACLs/ACEs. Ceci est extrêmement important sachant que chaque ACL pourrait avoir
plusieurs ACEs, et hériter d'une autre ACL à la manière d'une structure en arbre.
-Donc, nous ne nous servons pas d'un ORM spécifique, mais
-l'implémentation par défaut intéragit avec votre connexion en utilisant directement
-le DBAL de Doctrine.
+Par conséquent, aucun ORM n'est utilisé mais l'implémentation par défaut intéragit
+avec votre connexion en utilisant directement le DBAL de Doctrine.
Identités d'Objet
~~~~~~~~~~~~~~~~~
@@ -75,19 +74,19 @@ Portée des « Access Control Entries »
-------------------------------------
Les entrées de contrôle d'accès peuvent avoir différentes portées dans lesquelles
-elles s'appliquent. Dans Symfony2, nous avons principalement deux portées
+elles s'appliquent. Dans Symfony2, il existe principalement deux portées
différentes :
- Portée de la Classe : Ces entrées s'appliquent à tous les objets ayant la
même classe.
-- Portée de l'Objet : Ceci est la portée que nous avons utilisé dans le chapitre
+- Portée de l'Objet : Ceci est la portée utilisée dans le chapitre
précédent, et elle s'applique uniquement à un objet spécifique.
Parfois, vous aurez besoin d'appliquer une ACE uniquement sur le champ
spécifique d'un objet. Supposons que vous voulez que l'ID soit uniquement
visible par un administrateur mais pas par votre service client. Pour
-solutionner ce problème commun, nous avons ajouté deux sous-portées
-supplémentaires :
+solutionner ce problème commun, deux sous-portées supplémentaires ont
+été ajoutées :
- Portée d'un Champ de Classe : Ces entrées s'appliquent à tous les objets
ayant la même classe, mais uniquement à un champ spécifique de ces objets.
@@ -98,9 +97,9 @@ Décisions de pré-autorisation
-----------------------------
Pour les décisions de pré-autorisation, que ce soit des décisions prises avant
-quelconque méthode ou bien une action sécurisée qui est invoquée, nous
-reposons sur le service éprouvé « AccessDecisionManager » qui est aussi
-utilisé pour connaître les décisions d'autorisation basées sur des rôles.
+quelconque méthode ou bien une action sécurisée qui est invoquée, le service
+éprouvé « AccessDecisionManager » est utilisé. L'« AccessDecisionManager »
+est aussi utilisé pour connaître les décisions d'autorisation basées sur des rôles.
Comme les rôles, le système d'ACL ajoute plusieurs nouveaux attributs qui
pourraient être utilisés pour vérifier différentes permissions.
@@ -166,8 +165,8 @@ Extensibilité
La table de permissions ci-dessus n'est en rien statique, et pourrait
théoriquement être complètement remplacée. Cependant, elle devrait couvrir
la plupart des problèmes que vous pourriez rencontrer, et pour des raisons
-d'intéropérabilité avec d'autres bundles, nous vous encourageons à garder
-la signification que nous avons envisagé pour ces permissions.
+d'intéropérabilité avec d'autres bundles, vous êtes encouragé à conserver
+les significations initialement prévues pour ces permissions.
Décisions de post-autorisation
------------------------------
diff --git a/cookbook/security/custom_authentication_provider.rst b/cookbook/security/custom_authentication_provider.rst
index dced02d86..021c1447d 100644
--- a/cookbook/security/custom_authentication_provider.rst
+++ b/cookbook/security/custom_authentication_provider.rst
@@ -48,9 +48,9 @@ Le rôle du token dans le contexte de sécurité de Symfony2 est important.
Un token représente les données d'authentification de l'utilisateur
présentes dans la requête. Une fois qu'une requête est authentifiée, le
token conserve les données de l'utilisateur, et délivre ces données au
-travers du contexte de sécurité. Premièrement, nous allons créer notre
-classe token. Cela va permettre de passer toutes les informations
-pertinentes à notre fournisseur d'authentification.
+travers du contexte de sécurité. Premièrement, vous allez créer votre
+classe token. Cela permettra de passer toutes les informations
+pertinentes à votre fournisseur d'authentification.
.. code-block:: php
@@ -345,9 +345,9 @@ utilisée comme un pare-feu dans votre configuration de sécurité.
.. note::
- Vous vous demandez peut-être « pourquoi avons-nous besoin d'une classe
+ Vous vous demandez peut-être « pourquoi ai-je besoin d'une classe
factory spéciale pour ajouter des listeners et fournisseurs à un
- conteneur d'injection de dépendances ? ». Ceci est une très bonne
+ conteneur d'injection de dépendances ? ». C'est une très bonne
question. La raison est que vous pouvez utiliser votre pare-feu
plusieurs fois afin de sécuriser plusieurs parties de votre application.
Grâce à cela, chaque fois que votre pare-feu sera utilisé, un nouveau
diff --git a/cookbook/security/custom_provider.rst b/cookbook/security/custom_provider.rst
index 001bd22cc..bb0595dd7 100644
--- a/cookbook/security/custom_provider.rst
+++ b/cookbook/security/custom_provider.rst
@@ -12,10 +12,10 @@ pour un nom d'utilisateur donné. Symfony vérifie alors si le mot de passe
de cet utilisateur est correct ou non et génère un token de sécurité afin
que l'utilisateur reste authentifié pendant la session courante. Symfony
possède par défaut un fournisseur d'utilisateur « in_memory » et « entity ».
-Dans cet article, nous allons vous montrer comment vous pouvez créer votre
+Dans cet article, vous verrez comment vous pouvez créer votre
propre fournisseur d'utilisateur, ce qui pourrait être utile si vous accédez à
vos utilisateurs via une base de données personnalisée, un fichier, ou - comme
-nous le montrons dans cet exemple - à travers un service web.
+le montre cet exemple - à travers un service web.
Créer une Classe Utilisateur
----------------------------
@@ -107,7 +107,7 @@ Pour plus de détails sur chacune de ces méthodes, voir l'interface
Créer un Fournisseur d'Utilisateur
----------------------------------
-Maintenant que vous avez une classe ``User``, nous allons créer un fournisseur
+Maintenant que vous avez une classe ``User``, vous allez créer un fournisseur
d'utilisateur qui va récupérer les informations utilisateur depuis un service
web, et nous allons aussi créer un objet ``WebserviceUser`` et le remplir avec
des données.
@@ -167,7 +167,7 @@ Voici un exemple de ce à quoi cela pourrait ressembler::
Créer un Service pour le Fournisseur d'Utilisateur
--------------------------------------------------
-Maintenant, nous allons rendre le fournisseur d'utilisateur disponible en tant que
+Maintenant, vous allez rendre le fournisseur d'utilisateur disponible en tant que
service.
.. configuration-block::
@@ -177,29 +177,29 @@ service.
# src/Acme/WebserviceUserBundle/Resources/config/services.yml
parameters:
webservice_user_provider.class: Acme\WebserviceUserBundle\Security\User\WebserviceUserProvider
-
+
services:
webservice_user_provider:
- class: %webservice_user_provider.class%
-
+ class: "%webservice_user_provider.class%"
+
.. code-block:: xml
Acme\WebserviceUserBundle\Security\User\WebserviceUserProvider
-
+
-
+
.. code-block:: php
-
+
// src/Acme/WebserviceUserBundle/Resources/config/services.php
use Symfony\Component\DependencyInjection\Definition;
-
+
$container->setParameter('webservice_user_provider.class', 'Acme\WebserviceUserBundle\Security\User\WebserviceUserProvider');
-
+
$container->setDefinition('webservice_user_provider', new Definition('%webservice_user_provider.class%');
.. tip::
diff --git a/cookbook/security/entity_provider.rst b/cookbook/security/entity_provider.rst
index 0d8bbe9f1..a1650b6d5 100644
--- a/cookbook/security/entity_provider.rst
+++ b/cookbook/security/entity_provider.rst
@@ -205,7 +205,7 @@ stockée dans le fichier ``app/config/security.yml``.
Vous trouverez ci-dessous un exemple de configuration où l'utilisateur
va entrer son nom d'utilisateur et son mot de passe via une authentification
-basique HTTP. Cette information sera alors comparée et vérifiée avec nos
+basique HTTP. Cette information sera alors comparée et vérifiée avec vos
entrées d'entité « User » de la base de données :
.. configuration-block::
@@ -254,7 +254,7 @@ la validité du mot de passe.
Ce code et cette configuration fonctionnent mais ce n'est pas suffisant pour
sécuriser l'application pour des utilisateurs **activés**. En effet, maintenant,
-nous pouvons toujours nous authentifier avec ``maxime``. La section suivante
+vous pouvez toujours vous authentifier avec ``maxime``. La section suivante
explique comment interdire l'accès aux utilisateurs non-activés.
Interdire les Utilisateurs non-activés
@@ -286,7 +286,7 @@ que la méthode ``isEnabled()`` va retourner la valeur booléenne du champ
.. code-block:: php
// src/Acme/UserBundle/Entity/User.php
- namespace Acme\Bundle\UserBundle\Entity;
+ namespace Acme\UserBundle\Entity;
// ...
use Symfony\Component\Security\Core\User\AdvancedUserInterface;
@@ -317,8 +317,8 @@ que la méthode ``isEnabled()`` va retourner la valeur booléenne du champ
}
}
-Si nous essayons de nous authentifier avec ``maxime``, l'accès est maintenant
-interdit comme cet utilisateur n'a pas un compte activé. La prochaine section
+Si vous essayez de vous authentifier avec ``maxime``, l'accès est maintenant
+interdit puisque cet utilisateur n'a pas un compte activé. La prochaine section
va se concentrer sur l'implémentation d'un fournisseur d'entité personnalisé
pour authentifier un utilisateur avec son nom d'utilisateur ou avec son adresse
email.
@@ -398,7 +398,7 @@ la classe ``UserRepository``::
Pour finir l'implémentation, la configuration de la couche de sécurité doit
être modifiée pour dire à Symfony d'utiliser le nouveau fournisseur d'entité
personnalisé à la place du fournisseur d'entité Doctrine générique. Ceci est
-trivial à réaliser en supprimant le champ ``property`` dans la section
+facile à réaliser en supprimant le champ ``property`` dans la section
``security.providers.administrators.entity`` du fichier ``security.yml``.
.. configuration-block::
@@ -427,7 +427,7 @@ utilisateur est « chargé », sa méthode ``getRoles()`` retourne le tableau co
ses rôles de sécurité qui doivent lui être assignés. Vous pouvez charger ces
données depuis n'importe où - une liste codée en dur et utilisée pour tous les
utilisateurs (par exemple : ``array('ROLE_USER')``), un tableau Doctrine en tant
-que propriété nommée ``roles``, ou via une relation Doctrine, comme nous allons
+que propriété nommée ``roles``, ou via une relation Doctrine, comme vous allez
le voir dans cette section.
.. caution::
@@ -444,7 +444,7 @@ utilisateurs. Comme un groupe est aussi un rôle, la méthode précédente ``get
retourne maintenant la liste des groupes reliés::
// src/Acme/UserBundle/Entity/User.php
- namespace Acme\Bundle\UserBundle\Entity;
+ namespace Acme\UserBundle\Entity;
use Doctrine\Common\Collections\ArrayCollection;
@@ -479,7 +479,7 @@ implémente l'interface :class:`Symfony\\Component\\Security\\Core\\Role\\RoleIn
qui la force à avoir une méthode ``getRole()``::
// src/Acme/Bundle/UserBundle/Entity/Group.php
- namespace Acme\Bundle\UserBundle\Entity;
+ namespace Acme\UserBundle\Entity;
use Symfony\Component\Security\Core\Role\RoleInterface;
use Doctrine\Common\Collections\ArrayCollection;
@@ -536,7 +536,7 @@ la méthode ``UserRepository::loadUserByUsername()``. Cela va récupérer l'util
ainsi que ses rôles/groupes associés avec une requête unique::
// src/Acme/UserBundle/Entity/UserRepository.php
- namespace Acme\Bundle\UserBundle\Entity;
+ namespace Acme\UserBundle\Entity;
// ...
diff --git a/cookbook/security/securing_services.rst b/cookbook/security/securing_services.rst
index ac06ec519..7eca5d6ec 100644
--- a/cookbook/security/securing_services.rst
+++ b/cookbook/security/securing_services.rst
@@ -81,7 +81,7 @@ Puis, dans votre configuration de service, vous pouvez injecter le service :
services:
newsletter_manager:
- class: %newsletter_manager.class%
+ class: "%newsletter_manager.class%"
arguments: [@security.context]
.. code-block:: xml
diff --git a/cookbook/security/voters.rst b/cookbook/security/voters.rst
index 217e5b7d1..45cd43e19 100644
--- a/cookbook/security/voters.rst
+++ b/cookbook/security/voters.rst
@@ -49,17 +49,17 @@ doit retourner l'une des valeurs suivantes :
* ``VoterInterface::ACCESS_DENIED``: L'utilisateur n'est pas autorisé à accéder à
l'application
-Dans cet exemple, nous allons vérifier si l'adresse IP de l'utilisateur correspond
-à l'une des adresses de la liste noire. Si c'est le cas, nous retournerons
-``VoterInterface::ACCESS_DENIED``, sinon nous retournerons
+Dans cet exemple, vous allez vérifier si l'adresse IP de l'utilisateur correspond
+à l'une des adresses de la liste noire. Si c'est le cas, vous retournerez
+``VoterInterface::ACCESS_DENIED``, sinon vous retournerez
``VoterInterface::ACCESS_ABSTAIN`` comme le but de ce voteur est uniquement de
refuser l'accès, et non pas de l'autoriser.
Créer un Voteur personnalisé
----------------------------
-Pour ajouter un utilisateur sur la liste noire en se basant sur son IP, nous
-pouvons utiliser le service ``request`` et comparer l'adresse IP avec un
+Pour ajouter un utilisateur sur la liste noire en se basant sur son IP, vous
+pouvez utiliser le service ``request`` et comparer l'adresse IP avec un
ensemble d'adresses IP de la liste noire :
.. code-block:: php
@@ -81,13 +81,13 @@ ensemble d'adresses IP de la liste noire :
public function supportsAttribute($attribute)
{
- // nous n'allons pas vérifier l'attribut de l'utilisateur, alors nous retournons true
+ // vous n'allez pas vérifier l'attribut de l'utilisateur, alors vous retournez true
return true;
}
public function supportsClass($class)
{
- // notre voteur supporte tous les types de classes de token, donc nous retournons true
+ // votre voteur supporte tous les types de classes de token, donc vous retournez true
return true;
}
@@ -109,7 +109,7 @@ le voteur dans la couche de sécurité. Cela peut être effectué facilement
Déclarer le Voteur comme service
--------------------------------
-Pour injecter le voteur dans la couche de sécurité, nous devons le déclarer
+Pour injecter le voteur dans la couche de sécurité, vous devez le déclarer
en tant que service, et le tagger comme un « security.voter » :
.. configuration-block::
@@ -167,11 +167,11 @@ en tant que service, et le tagger comme un « security.voter » :
Changer la stratégie de décision d'accès
----------------------------------------
-Afin que votre nouveau voteur soit utilisé, nous devons changer la stratégie de
+Afin que votre nouveau voteur soit utilisé, vous devez changer la stratégie de
décision d'accès par défaut, qui d'habitude autorise l'accès si *n'importe quel*
voteur autorise l'accès.
-Dans notre cas, nous allons choisir la stratégie ``unanimous``. Contrairement
+Dans ce cas, vous allez choisir la stratégie ``unanimous``. Contrairement
à la stratégie par défaut ``affirmative``, avec la stratégie ``unanimous``, si
seulement un voteur refuse l'accès (par exemple : le ``ClientIpVoter``), alors
l'accès n'est pas autorisé pour l'utilisateur final.
diff --git a/cookbook/service_container/event_listener.rst b/cookbook/service_container/event_listener.rst
index 6b66c2ff6..d29dfc26d 100644
--- a/cookbook/service_container/event_listener.rst
+++ b/cookbook/service_container/event_listener.rst
@@ -11,8 +11,8 @@ dans la classe :class:`Symfony\\Component\\HttpKernel\\KernelEvents`.
Afin de personnaliser un évènement avec votre propre logique, vous devez créer
un service qui va agir en tant que « listener » d'évènement pour cet évènement.
-Dans cet article, nous allons créer un service qui agit en tant que « Listener »
-d'Exception, nous permettant de modifier comment les exceptions sont affichées par
+Dans cet article, vous allez créer un service qui agit en tant que « Listener »
+d'Exception, vous permettant de modifier comment les exceptions sont affichées par
notre application. L'évènement ``KernelEvents::EXCEPTION`` est l'un des évènements
du coeur du noyau::
@@ -21,6 +21,7 @@ du coeur du noyau::
use Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent;
use Symfony\Component\HttpFoundation\Response;
+ use Symfony\Component\HttpKernel\Exception\HttpExceptionInterface;
class AcmeExceptionListener
{
@@ -28,12 +29,20 @@ du coeur du noyau::
{
// nous récupérons l'objet exception depuis l'évènement reçu
$exception = $event->getException();
- $message = 'My Error says: ' . $exception->getMessage();
+ $message = 'My Error says: ' . $exception->getMessage() . ' with code: ' . $exception->getCode();
// personnalise notre objet réponse pour afficher les détails de notre exception
$response = new Response();
$response->setContent($message);
- $response->setStatusCode($exception->getStatusCode());
+
+ // HttpExceptionInterface est un type d'exception spécial qui
+ // contient le code statut et les détails de l'entête
+ if ($exception instanceof HttpExceptionInterface) {
+ $response->setStatusCode($exception->getStatusCode());
+ $response->headers->replace($exception->getHeaders());
+ } else {
+ $response->setStatusCode(500);
+ }
// envoie notre objet réponse modifié à l'évènement
$event->setResponse($response);
@@ -107,10 +116,9 @@ très facilement comme ceci::
if (HttpKernel::MASTER_REQUEST != $event->getRequestType()) {
// ne rien faire si c'est la requête principale
return;
- }
+ }
// ...
- }
}
}
@@ -118,4 +126,4 @@ très facilement comme ceci::
Deux types de requête sont disponibles dans l'interface
:class:`Symfony\\Component\\HttpKernel\\HttpKernelInterface` :
- ``HttpKernelInterface::MASTER_REQUEST`` et ``HttpKernelInterface::SUB_REQUEST``.
\ No newline at end of file
+ ``HttpKernelInterface::MASTER_REQUEST`` et ``HttpKernelInterface::SUB_REQUEST``.
diff --git a/cookbook/service_container/scopes.rst b/cookbook/service_container/scopes.rst
index e65a478e0..280024980 100755
--- a/cookbook/service_container/scopes.rst
+++ b/cookbook/service_container/scopes.rst
@@ -168,7 +168,7 @@ La configuration du service pour cette classe :
my_mailer.class: Acme\HelloBundle\Mail\Mailer
services:
my_mailer:
- class: %my_mailer.class%
+ class: "%my_mailer.class%"
arguments:
- "@service_container"
# scope: container can be omitted as it is the default
diff --git a/cookbook/symfony1.rst b/cookbook/symfony1.rst
index b43938849..279144b49 100755
--- a/cookbook/symfony1.rst
+++ b/cookbook/symfony1.rst
@@ -17,8 +17,7 @@ manière légèrement différente. Vous apprécierez ces différences mineures c
elles permettent des comportements stables, sans surprises, testables et une
séparation claire des logiques utilisées au sein de vos applications Symfony2.
-Ainsi, asseyez vous et relaxez vous afin que nous puissions vous transporter du « passé »
-au « présent ».
+Ainsi, asseyez vous et relaxez vous pendant votre voyage du « passé » au « présent ».
Arborescence des répertoires
----------------------------
diff --git a/cookbook/templating/PHP.rst b/cookbook/templating/PHP.rst
index ae0a3bcfd..80fc7b3f9 100644
--- a/cookbook/templating/PHP.rst
+++ b/cookbook/templating/PHP.rst
@@ -61,6 +61,21 @@ Le contrôleur suivant délivre ainsi le template ``index.html.php`` ::
return $this->render('AcmeHelloBundle:Hello:index.html.php', array('name' => $name));
}
+Ou vous pouvez utiliser le raccourci :doc:`/bundles/SensioFrameworkExtraBundle/annotations/view`
+pour afficher le template par défaut ``AcmeHelloBundle:Hello:index.html.php``::
+
+ // src/Acme/HelloBundle/Controller/HelloController.php
+
+ // ...
+
+ /**
+ * @Template(engine="php")
+ */
+ public function indexAction($name)
+ {
+ return array('name' => $name);
+ }
+
.. index::
single: Templating; Layout
single: Layout
diff --git a/cookbook/templating/global_variables.rst b/cookbook/templating/global_variables.rst
index d011a2587..3f415e074 100644
--- a/cookbook/templating/global_variables.rst
+++ b/cookbook/templating/global_variables.rst
@@ -37,7 +37,7 @@ une valeur :
# app/config/config.yml
twig:
globals:
- ga_tracking: %ga_tracking%
+ ga_tracking: "%ga_tracking%"
La même variable est disponible exactement comme précédemment.
diff --git a/cookbook/templating/twig_extension.rst b/cookbook/templating/twig_extension.rst
index 5b03fb2cd..28c3ba8cb 100644
--- a/cookbook/templating/twig_extension.rst
+++ b/cookbook/templating/twig_extension.rst
@@ -28,15 +28,12 @@ afin de formatter un nombre donné en un prix::
// src/Acme/DemoBundle/Twig/AcmeExtension.php
namespace Acme\DemoBundle\Twig;
- use Twig_Extension;
- use Twig_Filter_Method;
-
- class AcmeExtension extends Twig_Extension
+ class AcmeExtension extends \Twig_Extension
{
public function getFilters()
{
return array(
- 'price' => new Twig_Filter_Method($this, 'priceFilter'),
+ 'price' => new \Twig_Filter_Method($this, 'priceFilter'),
);
}
@@ -128,7 +125,7 @@ En savoir plus
Pour étudier le sujet des Extensions Twig plus en détail, veuillez jeter un coup d'oeil à
la `documentation des extensions Twig`_.
-.. _`dépôt officiel des extensions Twig`: http://github.com/fabpot/Twig-extensions
+.. _`dépôt officiel des extensions Twig`: https://github.com/fabpot/Twig-extensions
.. _`documentation des extensions Twig`: http://twig.sensiolabs.org/doc/advanced.html#creating-an-extension
.. _`variables globales`: http://twig.sensiolabs.org/doc/advanced.html#id1
.. _`fonctions`: http://twig.sensiolabs.org/doc/advanced.html#id2
diff --git a/cookbook/testing/bootstrap.rst b/cookbook/testing/bootstrap.rst
new file mode 100644
index 000000000..42490ca31
--- /dev/null
+++ b/cookbook/testing/bootstrap.rst
@@ -0,0 +1,44 @@
+Comment personnaliser le processus de bootstrap avant les tests
+===============================================================
+
+Parfois, lorsque vous lancez des tests, vous avez besoin d'ajouter
+des choses au processus d'initialisation (bootstrap) juste avant
+de les lancer. Par exemple, si vous lancez un test fonctionnel et que
+vous avez introduit une nouvelle ressource de traduction, alors vous devrez
+vider votre cache avant de lancer ces tests. Cet article vous explique comment
+faire
+
+D'abord, ajouter le fichier suivant::
+
+ // app/tests.bootstrap.php
+ if (isset($_ENV['BOOTSTRAP_CLEAR_CACHE_ENV'])) {
+ passthru(sprintf(
+ 'php "%s/console" cache:clear --env=%s --no-warmup',
+ __DIR__,
+ $_ENV['BOOTSTRAP_CLEAR_CACHE_ENV']
+ ));
+ }
+
+ require __DIR__.'/bootstrap.php.cache';
+
+Remplacer le fichier de test bootstrap ``bootstrap.php.cache`` dans
+``app/phpunit.xml.dist`` par ``tests.bootstrap.php`` :
+
+.. code-block:: xml
+
+
+ bootstrap = "tests.bootstrap.php"
+
+Maintenant, vous pouvez définir pour quel environnement vous voulez vider
+le cache dans votre fichier ``phpunit.xml.dist`` :
+
+.. code-block:: xml
+
+
+
+
+
+Cela devient maintenant une variable d'environnement (c-a-d ``$_ENV``)
+qui est disponible dans votre fichier bootstrap personnalisé
+(``tests.bootstrap.php``).
\ No newline at end of file
diff --git a/cookbook/testing/http_authentication.rst b/cookbook/testing/http_authentication.rst
index ebf928e31..8792805c8 100755
--- a/cookbook/testing/http_authentication.rst
+++ b/cookbook/testing/http_authentication.rst
@@ -13,9 +13,9 @@ le nom d'utilisateur et le mot de passe comme variable serveurs à la méthode
'PHP_AUTH_PW' => 'pa$$word',
));
-Vous pouvez aussi les outrepasser directement dans l'objet requête::
+Vous pouvez aussi les surcharger directement dans l'objet requête::
- $client->request('DELETE', '/post/12', array(), array(
+ $client->request('DELETE', '/post/12', array(), array(), array(
'PHP_AUTH_USER' => 'username',
'PHP_AUTH_PW' => 'pa$$word',
));
diff --git a/cookbook/testing/index.rst b/cookbook/testing/index.rst
index d317dca70..ec0ed2061 100644
--- a/cookbook/testing/index.rst
+++ b/cookbook/testing/index.rst
@@ -8,3 +8,4 @@ Tests
insulating_clients
profiling
doctrine
+ bootstrap
diff --git a/cookbook/testing/insulating_clients.rst b/cookbook/testing/insulating_clients.rst
index 62c22e71b..3e3be12ae 100755
--- a/cookbook/testing/insulating_clients.rst
+++ b/cookbook/testing/insulating_clients.rst
@@ -4,7 +4,7 @@
Comment tester les interactions de multiples clients
====================================================
-Si vous avez besoin de simuler des interaction entre différents clients (pour
+Si vous avez besoin de simuler des interactions entre différents clients (pour
un « chat » par exemple), créez plusieurs clients::
$harry = static::createClient();
@@ -32,9 +32,6 @@ des états globaux. Dans ces cas vous devrez isoler les clients::
$this->assertEquals(201, $harry->getResponse()->getStatus());
$this->assertRegExp('/Hello/', $sally->getResponse()->getContent());
-Insulated clients transparently execute their requests in a dedicated and
-clean PHP process, thus avoiding any side-effects.
-
Les clients isolés exécute de manière transparente leur requête dans un processus
PHP dédié et « sain », et évitent donc quelconque effet de bord.
diff --git a/cookbook/testing/profiling.rst b/cookbook/testing/profiling.rst
index c0d5c8bff..4db9d5731 100755
--- a/cookbook/testing/profiling.rst
+++ b/cookbook/testing/profiling.rst
@@ -10,22 +10,18 @@ désirerez peut-être écrire des tests sur les données provenant du profiler.
ce dernier fournit des méthodes efficaces, permettant de contrôler de nombreux
comportements et d'appliquer certaines métriques.
-Le Profiler de Symfony2 :ref:`Profiler ` collecte de nombreuses
+Le :ref:`Profiler ` de Symfony2 collecte de nombreuses
informations à chaque requête. Utilisez celle-ci pour vérifier le nombre d'appels
à la base de données, le temps passé dans l'exécution du framework, ...
-Avant de pouvoir écrire des assertions, vous devez activer le profiler et vous assurez
-qu'il est disponible (il est activé par défaut dans l'environnement de ``test`` )::
+Avant de pouvoir écrire des assertions, vous devez toujours vous assurez que le profiler
+est disponible (il est activé par défaut dans l'environnement de ``test`` )::
class HelloControllerTest extends WebTestCase
{
public function testIndex()
{
$client = static::createClient();
-
- // Active le profiler pour la prochaine requête
- // (cela ne fait rien si le profiler n'est pas disponible)
- $client->enableProfiler();
$crawler = $client->request('GET', '/hello/Fabien');
@@ -33,7 +29,7 @@ qu'il est disponible (il est activé par défaut dans l'environnement de ``test`
// Vérifier que le profiler est activé
if ($profile = $client->getProfile()) {
- // vérifier le nombre de requêtes
+ // Vérifier le nombre de requêtes
$this->assertLessThan(10, $profile->getCollector('db')->getQueryCount());
// Vérifier le temps utilisé par le framework
@@ -56,7 +52,7 @@ dans les messages d'erreurs::
.. caution::
Le profiler conserve des données différentes suivant l'environnement utilisé
- (particulièrement si vous utiliser SQLite, ce qui est la configuration par
+ (particulièrement si vous utilisez SQLite, ce qui est la configuration par
défaut).
.. note::
diff --git a/cookbook/validation/custom_constraint.rst b/cookbook/validation/custom_constraint.rst
index 8f8a67f0a..b3f90dc62 100755
--- a/cookbook/validation/custom_constraint.rst
+++ b/cookbook/validation/custom_constraint.rst
@@ -15,7 +15,7 @@ Créer une classe de contrainte
Tout d'abord, vous devez créer une classe de contrainte
qui étend la classe :class:`Symfony\\Component\\Validator\\Constraint`::
- // src/Acme/DemoBundle/Validator/constraints/ContainsAlphanumeric.php
+ // src/Acme/DemoBundle/Validator/Constraints/ContainsAlphanumeric.php
namespace Acme\DemoBundle\Validator\Constraints;
use Symfony\Component\Validator\Constraint;
diff --git a/cookbook/web_services/php_soap_extension.rst b/cookbook/web_services/php_soap_extension.rst
index 643e760b4..35ee8bd00 100755
--- a/cookbook/web_services/php_soap_extension.rst
+++ b/cookbook/web_services/php_soap_extension.rst
@@ -7,7 +7,7 @@ Comment créer des web services SOAP à l'intérieur d'un contrôleur Symfony2
Configurer un contrôleur afin qu'il agisse comme un serveur est réalisé simplement
avec quelques outils. Vous devez, bien sûr, avoir installé l'extension `PHP SOAP`_.
Comme l'extension PHP SOAP ne peut actuellement pas générer un WSDL, vous devez soit
-en créer un, soit utiliser un générateur provenant d'une librairie tierce.
+en créer un, soit utiliser un générateur provenant d'une bibliothèque tierce.
.. note::
@@ -22,8 +22,8 @@ qui représente les fonctionnalités que vous mettrez à disposition dans votre
Dans ce cas, le service SOAP permettra à un client d'appeler la méthode nommée ``hello``,
qui engendrera l'envoi d'un courriel::
- // src/Acme/SoapBundle/HelloService.php
- namespace Acme\SoapBundle;
+ // src/Acme/SoapBundle/Services/HelloService.php
+ namespace Acme\SoapBundle\Services;
class HelloService
{
@@ -61,14 +61,14 @@ Symfony et lui permettre de construire l'objet ``HelloService`` adéquat :
# app/config/config.yml
services:
hello_service:
- class: Acme\DemoBundle\Services\HelloService
+ class: Acme\SoapBundle\Services\HelloService
arguments: [@mailer]
.. code-block:: xml
-
+
diff --git a/cookbook/workflow/_vendor_deps.rst.inc b/cookbook/workflow/_vendor_deps.rst.inc
index c5491fd78..bbdb59682 100644
--- a/cookbook/workflow/_vendor_deps.rst.inc
+++ b/cookbook/workflow/_vendor_deps.rst.inc
@@ -1,5 +1,5 @@
-Gérer les bibliothèques vendors avec bin/vendors et deps
---------------------------------------------------------
+Gérer les bibliothèques vendors avec composer.json
+--------------------------------------------------
Comment ça marche ?
~~~~~~~~~~~~~~~~~~~
@@ -9,80 +9,45 @@ Chaque projet Symfony utilise des bibliothèques tierces regroupées sous l'appe
ces bibliothèques dans le répertoire ``vendor/`` et de pouvoir obtenir pour chacune la
version désirée.
-Par défaut, ces bibliothèques sont téléchargées en exécutant le script de téléchargement
-``php bin/vendors install``. Ce script utilise le fichier `deps`` situé à la racine
-de votre projet. Ce fichier au format INI contient la liste des bibliothèques nécessaires
-à votre projet, ainsi que le répertoire cible où chacune doit être téléchargée,
-et (de manière optionnelle) la version à télécharger. Le script `bin/vendors``
-utilise ``git`` pour ce téléchargement, car la plupart des bibliothèques
-sont gérées et disponibles via git. Le script ``bin/vendors`` se base également sur
-le fichier ``deps.lock``, lequel vous permet d'arrêter la version à une révision précise.
+Par défaut, ces bibliothèques sont téléchargées en exécutant ``php composer.phar install``.
+Le fichier binaire ``composer.phar`` est une bibliothèque appellé
+`Composer`_. Vous pouvez en savoir plus sur son installation dans le chapitre
+:ref:`Installation`.
+
+Le fichier ``composer.phar`` utilise un fichier ``composer.json`` situé à la racine
+de votre projet. Ce fichier au format JSON contient la liste des bibliothèques nécessaires
+à votre projet, ainsi que leurs versions et bien d'autres informations. Le fichier
+``composer.phar`` se base également sur un fichier ``composer.lock``, lequel vous permet
+d'arrêter la version à une révision précise. En faite, si un ``composer.lock`` existe,
+Les versions de ce fichier remplacerons celle dans ``composer.json``. Pour mettre à jour
+vos bibliothèques, vous devez exécuter ``php composer.phar update``.
+
+Pour en savoir plus sur Composer, visitez `GetComposer.org`_ (en anglais).
Nota bene : ces bibliothèques « vendor » *ne sont pas* gérées dans votre *dépôt*;
ce sont de simples fichiers installés (et ignorés du dépôt git) dans le répertoire
-``vendor/`` par le script ``bin/vendors``. Or, puisque toute l'information nécessaire
-pour télécharger ces fichiers est disponible dans ``deps`` et ``deps.lock``
-(qui, eux, *sont* gérés par votre dépôt), tout autre développeur peut utiliser votre
-projet, lancer ``php bin/vendors install``, et obtenir les mêmes bibliothèques (et version).
+``vendor/``. Or, puisque toute l'information nécessaire pour télécharger ces fichiers
+est disponible dans ``composer.json`` et ``composer.lock`` (qui, eux, *sont* gérés par
+votre dépôt), tout autre développeur peut utiliser votre projet, lancer
+``php composer.phar install``, et obtenir les mêmes bibliothèques (et version).
Vous contrôlez donc exactement le contenu de chaque bibliothèque, sans avoir besoin
de le versionner dans votre dépôt.
Ainsi, lorsqu'un développeur veut travailler sur votre projet, il lui suffit de
-lancer le script ``php bin/vendors install`` pour s'assurer que toutes les bibliothèques
+lancer le script ``php composer.phar install`` pour s'assurer que toutes les bibliothèques
nécessaires soient téléchargées.
.. sidebar:: Mettre à jour Symfony
Puisque Symfony est une bibliothèque tierce de votre projet et qu'elle est
- donc gérée entièrement via ``deps`` et``deps.lock``,
+ donc gérée entièrement via ``composer.json`` et``composer.lock``,
mettre à jour Symfony signifie simplement mettre à jour
ces deux fichiers afin qu'ils correspondent à la dernière version
de l'édition standard de Symfony.
- Bien sûr, si vous avez ajouté des entrées aux fichiers ``deps`` ou ``deps.lock``,
- veillez à ne remplacer que les parties originales afin de ne pas supprimer les entrées
- supplémentaires.
-
-.. ::
-
- La commande ``php bin/vendors update`` existe mais n'est pas utilisée pour la mise
- à jour de votre projet. Vous ne l'utiliserez en fait pratiquement jamais.
- Cette commande permet de bloquer la version de toutes vos bibliothèques vendors
- en les mettant à jour selon la version spécifiée dans ``deps`` et en inscrivant la révision
- correspondante dans le fichier `deps.lock``.
-
-Hacker les bibliothèques vendor
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Parfois, il est nécessaire de télécharger une version précise (branche, tag) d'une bibliothèque.
-Vous pouvez le faire directement dans le fichier ``deps`` :
-
-.. code-block:: text
-
- [AcmeAwesomeBundle]
- git=http://github.com/johndoe/Acme/AwesomeBundle.git
- target=/bundles/Acme/AwesomeBundle
- version=ma-version-trop-bien
-
-* L'option ``git`` définit l'URL de la bibliothèque. Elle peut utiliser divers protocoles,
- comme ``http://`` ou ``git://``.
-
-* L'option ``target`` définit le répertoire cible, le répertoire dans lequel la bibliothèque va être téléchargée.
- Par convention, les bundles devraient aller dans le répertoire ``vendor/bundles/Acme``, les autres
- bibliothèques iront dans ``vendor/ma-biblio-trop-bien``, le répertoire ``vendor`` est
- également le répertoire cible par défaut.
-
-* L'option ``version`` vous permet de définir une révision spécifique. Vous pouvez lui attribuer
- un nom de tag (``version=origin/0.42``) ou de branche (``refs/remotes/origin/ma-branche-trop-bien``).
- Version par défaut: ``origin/HEAD``.
-
-Flux de mise à jour
-~~~~~~~~~~~~~~~~~~~
-
-lors de l'éxécution de ``php bin/vendors install``, le script vérifie d'abord si le répertoire cible
-existe pour chaque bibliothèque. Si ce n'est pas le cas, il effectue un ``git clone``.
-
-Puis, il effectue un ``git fetch origin``, puis ``git reset --hard ma-version-trop-bien``.
+ Bien sûr, si vous avez ajouté des entrées aux fichiers ``composer.json`` ou
+ ``composer.lock``, veillez à ne remplacer que les parties originales afin de ne pas
+ supprimer les entrées supplémentaires.
-Le répertoire sera donc cloné une seule et unique fois. Pour faire des changements liés au dépôt distant
-il est nécessaire d'effacer le répertoire cible lui-même, et non seulement son contenu.
+.. _Composer: http://getcomposer.org/
+.. _GetComposer.org: http://getcomposer.org/
diff --git a/cookbook/workflow/new_project_git.rst b/cookbook/workflow/new_project_git.rst
index 6c8e2567c..4476ad44b 100644
--- a/cookbook/workflow/new_project_git.rst
+++ b/cookbook/workflow/new_project_git.rst
@@ -28,7 +28,7 @@ votre dépôt local git :
Renommez-le en ce que vous voulez.
3. Créez un nouveau fichier nommé ``.gitignore`` à la racine de votre nouveau
- projet (par exemple : à côté du fichier ``deps``) et coller ce qui suit dedans.
+ projet (par exemple : à côté du fichier ``composer.json``) et coller ce qui suit dedans.
Les fichiers correspondants à ces patterns seront ignorés par git :
.. code-block:: text
@@ -40,6 +40,13 @@ votre dépôt local git :
/vendor/
/app/config/parameters.yml
+.. tip::
+ Vous pouvez aussi avoir un fichier .gitignore qui peut être utilisé
+ sur tout votre système, dans ce cas, vous pourrez trouver plus d'informations
+ ici : `Github .gitignore`_.
+ De cette manière, vous pouvez exclure les fichiers/dossiers souvent utilisés par
+ votre IDE pour l'ensemble de vos projets.
+
4. Copiez ``app/config/parameters.yml`` vers ``app/config/parameters.yml.dist``.
Le fichier ``parameters.yml`` est ignoré par git (voir ci-dessus) afin que les
paramètres spécifiques à la machine comme les mots de passe de base de données
@@ -65,50 +72,13 @@ votre dépôt local git :
$ git commit -m "Initial commit"
-8. Finalement, téléchargez toutes les bibliothèques tierces :
-
- .. code-block:: bash
-
- $ php bin/vendors install
+8. Finalement, téléchargez toutes les bibliothèques tierces en exécutant
+ composer. Pour plus de détails, consultez la page :ref:`installation-updating-vendors`
A ce point, vous disposez d'un projet Symfony2 totalement fonctionnel qui est
correctement committé sous git. Vous pouvez immédiatement commencer à
développer, en committant les nouveaux changements dans votre dépôt git.
-.. tip::
-
- Après exécution de la commande :
-
- .. code-block:: bash
-
- $ php bin/vendors install
-
- votre projet va contenir l'historique git complet de tous les bundles
- et de toutes les bibliothèques définies dans le fichier ``deps``. Cela
- peut aller jusqu'à 100 Mo ! Vous pouvez sauvegarder la version actuelle
- de chaque dépendance avec la commande :
-
- .. code-block:: bash
-
- $ php bin/vendors lock
-
- puis vous pouvez supprimer les répertoires d'historique git avec la commande
- suivante :
-
- .. code-block:: bash
-
- $ find vendor -name .git -type d | xargs rm -rf
-
- La commande supprime tous les répertoires ``.git`` contenus dans le
- dossier ``vendor``.
-
- Si vous voulez mettre à jour les bundles définis dans le fichier ``deps``
- après cela, vous allez devoir les réinstaller :
-
- .. code-block:: bash
-
- $ php bin/vendors install --reinstall
-
Vous pouvez continuer en lisant le chapitre :doc:`/book/page_creation` pour en
apprendre plus sur comment configurer et développer votre application en interne.
@@ -125,10 +95,10 @@ apprendre plus sur comment configurer et développer votre application en intern
Vendors et Submodules
~~~~~~~~~~~~~~~~~~~~~~
-Au lieu d'utiliser le système ``deps`` et ``bin/vendors`` pour gérer les
+Au lieu d'utiliser le fichier ``composer.json`` pour gérer les
bibliothèques vendor, vous pourriez choisir à la place le système natif
`git submodules`_. Il n'y a rien d'incorrect dans cette approche, bien que le
-système ``deps`` soit la manière officielle de résoudre ce problème et qu'il peut
+système ``composer.json`` soit la manière officielle de résoudre ce problème et qu'il peut
être parfois difficile de travailler avec les git submodules.
Stocker votre projet sur un serveur distant
@@ -154,3 +124,4 @@ qui aide à gérer ceci est `Gitolite`_.
.. _`GitHub`: https://github.com/
.. _`dépôt barebones`: http://git-scm.com/book/en/Git-Basics-Getting-a-Git-Repository
.. _`Gitolite`: https://github.com/sitaramc/gitolite
+.. _`Github .gitignore`: https://help.github.com/articles/ignoring-files
diff --git a/cookbook/workflow/new_project_svn.rst b/cookbook/workflow/new_project_svn.rst
index 798c2ec51..234df8614 100644
--- a/cookbook/workflow/new_project_svn.rst
+++ b/cookbook/workflow/new_project_svn.rst
@@ -58,7 +58,7 @@ configuration basique de Subversion :
qu'il est hébergé sur `Google code`_ et nommé ``myproject`` :
.. code-block:: bash
-
+
$ svn checkout http://myproject.googlecode.com/svn/trunk myproject
4. Copiez les fichiers du projet Symfony2 dans le dossier subversion :
@@ -102,18 +102,13 @@ configuration basique de Subversion :
nouveaux développeurs peuvent rapidement cloner le projet, copier ce fichier
vers ``parameters.yml``, l'adapter, et commencer à développer.
-8. Finalement, téléchargez toutes les bibliothèques tierces :
-
- .. code-block:: bash
-
- $ php bin/vendors install
+8. Finalement, téléchargez toutes les bibliothèques tierces en exécutant
+ composer. Pour plus de détails, consultez la page :ref:`installation-updating-vendors`
.. tip::
- `git`_ doit être installé pour pouvoir exécuter la commande ``bin/vendors`` ;
- c'est le protocole utilisé pour aller récupérer les bibliothèques vendor.
- Cela signifie seulement que ``git`` est utilisé comme outil pour aider au
- téléchargement des bibliothèques dans le répertoire ``vendor/``.
+ Si vous utilisez des versions « dev », alors git peut être utilisé pour installer
+ ces bibliothèques puisqu'il n'y a pas d'archive disponible à télécharger.
A ce point, vous avez un projet Symfony2 entièrement fonctionnel stocké dans votre
dépôt Subversion. Le développement peut démarrer avec des commits dans ce dernier.
@@ -151,7 +146,7 @@ d'un dépôt central pour fonctionner. Vous avez donc plusieurs solutions :
.. _`Symfony2 Standard Edition`: http://symfony.com/download
.. _`Readme de la Standard Edition`: https://github.com/symfony/symfony-standard/blob/master/README.md
.. _`Contrôle de version avec Subversion`: http://svnbook.red-bean.com/
-.. _`GitHub`: http://github.com/
+.. _`GitHub`: https://github.com/
.. _`Google code`: http://code.google.com/hosting/
.. _`SourceForge`: http://sourceforge.net/
.. _`Gna`: http://gna.org/
diff --git a/glossary.rst b/glossary.rst
index 1380b4285..956da17f9 100644
--- a/glossary.rst
+++ b/glossary.rst
@@ -13,7 +13,7 @@ Glossaire
Projet
Un *Projet* est un répertoire composé d'une Application, un ensemble de
- bundles, des librairies tierces, un chargeur automatique (autoloader), et
+ bundles, des bibliothèques tierces, un chargeur automatique (autoloader), et
des contrôleurs frontaux.
Application
@@ -52,7 +52,7 @@ Glossaire
*Conteneur d'Injection de Dépendances*, est un objet spécial qui gère
l'instanciation des services au sein d'une application. Plutôt que de créer
les services directement, le développeur *prépare* le conteneur de services
- (via la configuration) sur la manière de créer les serrvices. Le conteneur
+ (via la configuration) sur la manière de créer les services. Le conteneur
de services prend en charge l'instanciation et l'injection des services
dépendants. Lisez le chapitre :doc:`/book/service_container`.
@@ -73,15 +73,15 @@ Glossaire
un environnement de ``prod`` qui est optimisé pour de meilleures performances.
Vendor
- Un *vendor* est un fournisseur de librairies PHP et de bundles, incluant
- Symfony2 lui-même. Malgré la connotation commercial du terme, les vendors
+ Un *vendor* est un fournisseur de bibliothèques PHP et de bundles, incluant
+ Symfony2 lui-même. Malgré la connotation commerciale du terme, les vendors
de Symfony sont souvent (et même très souvent) des logiciels libres. Toute
- librairie que vous ajoutez dans votre projet Symfony2 devrait se trouver
+ bibliothèque que vous ajoutez dans votre projet Symfony2 devrait se trouver
dans le répertoire ``vendor``. Lisez
- :ref:`L'Architecture: Utilisation de librairies externes `.
+ :ref:`L'Architecture: Utilisation de bibliothèques externes `.
Acme
- *Acme* est un exemple d'entreprise utilisé dans Symofny pour les exemples et
+ *Acme* est un exemple d'entreprise utilisé dans Symfony2 pour les exemples et
la documentation. Il est utilisé dans les namespaces où vous devriez normalement
utiliser votre propre nom d'entreprise (ex ``Acme\BlogBundle``).
@@ -99,7 +99,7 @@ Glossaire
Kernel
Le *Kernel* (noyau) est le coeur de Symfony2. L'objet Kernel prend en charge
- les requêtes HTTP en utilisant tous les bundles et librairies qui sont enregistrés.
+ les requêtes HTTP en utilisant tous les bundles et bibliothèques qui sont enregistrés.
Lisez :ref:`L'Architecture : Le répertoire Application` et le chapitre
:doc:`/book/internals`.
diff --git a/images/book/doctrine_image_1.png b/images/book/doctrine_image_1.png
index aa4e51209..9c7d37877 100644
Binary files a/images/book/doctrine_image_1.png and b/images/book/doctrine_image_1.png differ
diff --git a/images/book/doctrine_image_2.png b/images/book/doctrine_image_2.png
index a679f9cb3..062e64ce0 100644
Binary files a/images/book/doctrine_image_2.png and b/images/book/doctrine_image_2.png differ
diff --git a/images/book/doctrine_image_3.png b/images/book/doctrine_image_3.png
index ed472b2a6..b8998604c 100644
Binary files a/images/book/doctrine_image_3.png and b/images/book/doctrine_image_3.png differ
diff --git a/images/book/form-simple.png b/images/book/form-simple.png
index e740dca0e..d26e423c6 100644
Binary files a/images/book/form-simple.png and b/images/book/form-simple.png differ
diff --git a/images/book/form-simple2.png b/images/book/form-simple2.png
index d50028fc1..7516b8bfb 100644
Binary files a/images/book/form-simple2.png and b/images/book/form-simple2.png differ
diff --git a/images/book/release-process.jpg b/images/book/release-process.jpg
new file mode 100644
index 000000000..f3244c121
Binary files /dev/null and b/images/book/release-process.jpg differ
diff --git a/images/book/security_admin_role_access.png b/images/book/security_admin_role_access.png
index 8cbc86d26..26af3adc4 100644
Binary files a/images/book/security_admin_role_access.png and b/images/book/security_admin_role_access.png differ
diff --git a/images/book/security_anonymous_user_access.png b/images/book/security_anonymous_user_access.png
index 89694aa1a..017c6a1fd 100644
Binary files a/images/book/security_anonymous_user_access.png and b/images/book/security_anonymous_user_access.png differ
diff --git a/images/book/security_anonymous_user_denied_authorization.png b/images/book/security_anonymous_user_denied_authorization.png
index e793f10e9..6fff54f82 100644
Binary files a/images/book/security_anonymous_user_denied_authorization.png and b/images/book/security_anonymous_user_denied_authorization.png differ
diff --git a/images/book/security_authentication_authorization.png b/images/book/security_authentication_authorization.png
index 6b085cf81..06ca5cb89 100644
Binary files a/images/book/security_authentication_authorization.png and b/images/book/security_authentication_authorization.png differ
diff --git a/images/book/security_full_step_authorization.png b/images/book/security_full_step_authorization.png
index ceff81899..7b248c825 100644
Binary files a/images/book/security_full_step_authorization.png and b/images/book/security_full_step_authorization.png differ
diff --git a/images/book/security_ryan_no_role_admin_access.png b/images/book/security_ryan_no_role_admin_access.png
index 3cb5078fe..993eadc75 100644
Binary files a/images/book/security_ryan_no_role_admin_access.png and b/images/book/security_ryan_no_role_admin_access.png differ
diff --git a/images/docs-pull-request-change-base.png b/images/docs-pull-request-change-base.png
index 13f38841c..b0c36f4b5 100644
Binary files a/images/docs-pull-request-change-base.png and b/images/docs-pull-request-change-base.png differ
diff --git a/images/http-xkcd-request.png b/images/http-xkcd-request.png
index 86e767db9..0e44b3aa0 100644
Binary files a/images/http-xkcd-request.png and b/images/http-xkcd-request.png differ
diff --git a/images/http-xkcd.png b/images/http-xkcd.png
index 58edf13f3..4b9658f7d 100644
Binary files a/images/http-xkcd.png and b/images/http-xkcd.png differ
diff --git a/images/quick_tour/hello_fabien.png b/images/quick_tour/hello_fabien.png
index 021e8631a..e9b6ff58c 100644
Binary files a/images/quick_tour/hello_fabien.png and b/images/quick_tour/hello_fabien.png differ
diff --git a/images/quick_tour/profiler.png b/images/quick_tour/profiler.png
index 41c3b0ccc..1258b3a0b 100644
Binary files a/images/quick_tour/profiler.png and b/images/quick_tour/profiler.png differ
diff --git a/images/quick_tour/web_debug_toolbar.png b/images/quick_tour/web_debug_toolbar.png
index 7ed0df868..037f161a1 100644
Binary files a/images/quick_tour/web_debug_toolbar.png and b/images/quick_tour/web_debug_toolbar.png differ
diff --git a/images/quick_tour/welcome.jpg b/images/quick_tour/welcome.jpg
deleted file mode 100644
index 249a86599..000000000
Binary files a/images/quick_tour/welcome.jpg and /dev/null differ
diff --git a/images/quick_tour/welcome.png b/images/quick_tour/welcome.png
new file mode 100644
index 000000000..b5e9e57ea
Binary files /dev/null and b/images/quick_tour/welcome.png differ
diff --git a/images/release-process.jpg b/images/release-process.jpg
new file mode 100644
index 000000000..f3244c121
Binary files /dev/null and b/images/release-process.jpg differ
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 7b4c1805a..6e7a3be39 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -17,7 +17,7 @@ recommandée d'une application Symfony2 :
* ``app/``: La configuration de l'application,
* ``src/``: Le code PHP du projet,
-* ``vendor/``: Les librairies tierces,
+* ``vendor/``: Les bibliothèques tierces,
* ``web/``: Le répertoire Web racine.
Le répertoire ``web/``
@@ -156,7 +156,7 @@ qui contient une unique classe ``Bundle`` qui le décrit :
return $bundles;
}
-En plus du bundle ``AcmeDemoBundle`` dont nous avons déjà parlé, notez que le
+En plus du bundle ``AcmeDemoBundle`` qui a déjà été mentionné, notez que le
noyau active aussi d'autres bundles comme les bundles ``FrameworkBundle``,
``DoctrineBundle``, ``SwiftmailerBundle`` et ``AsseticBundle``. Ils sont tous
intégrés au framework.
@@ -323,13 +323,13 @@ qui décidez.
.. _using-vendors:
-Utilisation de librairies externes (Vendors)
---------------------------------------------
+Utilisation de bibliothèques externes (Vendors)
+-----------------------------------------------
-Il y a de fortes probabilités que votre application dépende de librairies tierces.
+Il y a de fortes probabilités que votre application dépende de bibliothèques tierces.
Celles-ci doivent être stockées dans le répertoire ``vendor/``. Ce
-répertoire contient déjà les librairies de Symfony2, la librairie SwiftMailer,
-l'ORM Doctrine, le système de template Twig et d'autres librairies et bundles.
+répertoire contient déjà les bibliothèques de Symfony2, la bibliothèque SwiftMailer,
+l'ORM Doctrine, le système de template Twig et d'autres bibliothèques et bundles.
Comprendre le Cache et les Logs
-------------------------------
diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index 3a7955637..9592a9809 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -120,7 +120,7 @@ pour afficher votre première « vraie » page Symfony2 :
Symfony2 devrait vous féliciter pour le travail accompli jusqu'à présent !
-.. image:: /images/quick_tour/welcome.jpg
+.. image:: /images/quick_tour/welcome.png
:align: center
Comprendre les fondamentaux
@@ -378,11 +378,11 @@ Bundles
~~~~~~~
Vous vous êtes sûrement demandé pourquoi le mot :term:`bundle` est utilisé dans
-la plupart des noms que nous avons vus précédemment. Tout le code que vous écrivez
+la plupart des noms que vous avez vu précédemment. Tout le code que vous écrivez
dans votre application est organisé en bundles. En jargon Symfony2, un bundle est
un ensemble structuré de fichiers (PHP, feuilles de styles, javascript, images, ...)
qui implémentent une fonctionnalité unique (un blog, un forum, ...) et qui peut être
-facilement partagé avec d'autres développeurs. Jusqu'à maintenant, nous avons
+facilement partagé avec d'autres développeurs. Jusqu'à maintenant, vous avez
manipulé un seul bundle, ``AcmeDemoBundle``. Vous en saurez plus sur les bundles
dans le dernier chapitre de ce tutoriel.
@@ -406,6 +406,11 @@ utile : le profiler.
.. image:: /images/quick_tour/profiler.png
:align: center
+.. note::
+
+ Vous pouvez avoir plus d'informations rapidement en survolant les items
+ de la Web Debug Toolbar.
+
Bien évidemment, vous ne voudrez pas voir ces outils lorsque vous déploierez votre
application sur le serveur de production. C'est pourquoi vous trouverez un autre
contrôleur dans le répertoire ``web/`` (``app.php``), qui est optimisé pour
@@ -478,4 +483,4 @@ suivante : «:doc:`La vue`».
.. _YAML: http://www.yaml.org/
.. _les annotations dans les contrôleurs: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html#annotations-for-controllers
.. _Twig: http://twig.sensiolabs.org/
-.. _`Installation de Symfony`: http://symfony.com/download
\ No newline at end of file
+.. _`Installation de Symfony`: http://symfony.com/download
diff --git a/quick_tour/the_controller.rst b/quick_tour/the_controller.rst
index 055ea2b4e..406e8ede6 100644
--- a/quick_tour/the_controller.rst
+++ b/quick_tour/the_controller.rst
@@ -81,8 +81,8 @@ Si vous voulez rediriger un utilisateur vers une autre page, utilisez la méthod
return $this->redirect($this->generateUrl('_demo_hello', array('name' => 'Lucas')));
-La méthode ``generateUrl()`` est la même que la méthode ``path()`` que nous
-avions utilisée dans les templates. Elle prend le nom de la route et un tableau
+La méthode ``generateUrl()`` est la même que la méthode ``path()`` que vous
+avez utilisée dans les templates. Elle prend le nom de la route et un tableau
de paramètres comme arguments et retourne la jolie adresse qui
convient.
@@ -297,9 +297,9 @@ facilement à votre application.
Le mot de la fin
----------------
-C'est tout ce qu'il y a à faire et je ne suis même pas sûr que nous avons passé
-les 10 minutes que l'on s'était allouées. Nous avons brièvement présenté les
-Bundles dans la première partie et toutes les caractéristiques que nous avons
+C'est tout ce qu'il y a à faire et je ne suis même pas sûr que vous ayez passé
+les 10 minutes que l'on s'était allouées. Vous avez été brièvement introduit aux
+Bundles dans la première partie et toutes les caractéristiques que vous avez
apprises jusqu'à maintenant font partie du «core framework Bundle».
Mais grâce aux Bundles, tout peut être étendu ou remplacé dans Symfony2.
C'est le thème de la :doc:`prochaine partie de ce tutoriel`.
diff --git a/quick_tour/the_view.rst b/quick_tour/the_view.rst
index ca5200cda..0d3ef91ac 100644
--- a/quick_tour/the_view.rst
+++ b/quick_tour/the_view.rst
@@ -17,7 +17,7 @@ Découvrir Twig
.. tip::
- Si vous voulez maîtriser Twig, nous vous recommandons fortement de lire sa
+ Si vous voulez maîtriser Twig, il vous est fortement recommandé de lire sa
`documentation`_ officielle. Cette section est juste un rapide aperçu des
concepts de base.
@@ -101,8 +101,8 @@ Templates de décoration
-----------------------
Bien souvent, les templates d'un projet partagent des éléments communs, comme les
-célèbres entête et pied de page. Dans Symfony2, nous abordons ce problème
-différemment : un template peut être décoré par un autre. Cela fonctionne exactement
+célèbres entête et pied de page. Dans Symfony2, le problème est abordé différemment :
+un template peut être décoré par un autre. Cela fonctionne exactement
comme les classes PHP : l'héritage de template vous permet de bâtir un template
« layout » de base qui contient tous les éléments communs de votre site et de définir
des « blocks » que les templates enfants pourront surcharger.
diff --git a/reference/configuration/assetic.rst b/reference/configuration/assetic.rst
index 99cdf1868..3c6df04af 100644
--- a/reference/configuration/assetic.rst
+++ b/reference/configuration/assetic.rst
@@ -12,12 +12,12 @@ Configuration complète par défaut
.. code-block:: yaml
assetic:
- debug: %kernel.debug%
+ debug: "%kernel.debug%"
use_controller:
- enabled: %kernel.debug%
+ enabled: "%kernel.debug%"
profiler: false
- read_from: %kernel.root_dir%/../web
- write_to: %assetic.read_from%
+ read_from: "%kernel.root_dir%/../web"
+ write_to: "%assetic.read_from%"
java: /usr/bin/java
node: /usr/bin/node
ruby: /usr/bin/ruby
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 25e7818be..65e6a75ef 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -1,4 +1,4 @@
-.. index::
+.. index::
single: Doctrine; Configuration de référence de l'ORM
single: Configuration de référence; ORM Doctrine
@@ -104,7 +104,7 @@ Configuration de Référence
orm:
default_entity_manager: ~
auto_generate_proxy_classes: false
- proxy_dir: %kernel.cache_dir%/doctrine/orm/Proxies
+ proxy_dir: "%kernel.cache_dir%/doctrine/orm/Proxies"
proxy_namespace: Proxies
# cherchez la classe "ResolveTargetEntityListener" pour avoir un mode d'emploi
resolve_target_entities: []
@@ -322,16 +322,12 @@ suivantes existent pour les correspondances d'entités :
Configuration du DBAL Doctrine
------------------------------
-.. note::
-
- Le DoctrineBundle supporte tous les paramètres que les drivers Doctrine
- acceptent par défaut, convertis en XML ou YML selon les standards de
- nommage que Symfony force à utiliser. Voir la `Documentation DBAL`_ de
- Doctrine pour plus d'informations.
+Le DoctrineBundle supporte tous les paramètres que les drivers Doctrine
+acceptent par défaut, convertis en XML ou YML selon les standards de
+nommage que Symfony force à utiliser. Voir la `documentation DBAL`_ de
+Doctrine pour plus d'informations.
-A côté des options de Doctrine par défaut, il y en a quelques unes liées à
-Symfony que vous pouvez configurer. Le bloc suivant montre toutes les clés
-de configuration possibles :
+Vous trouverez ci-dessous toutes les possibilités pour les clés:
.. configuration-block::
@@ -345,20 +341,25 @@ de configuration possibles :
user: user
password: secret
driver: pdo_mysql
+ # l'option driverClass de DBAL
driver_class: MyNamespace\MyDriverImpl
+ # l'option driverOptions de DBAL
options:
foo: bar
- path: %kernel.data_dir%/data.sqlite
+ path: "%kernel.data_dir%/data.sqlite"
memory: true
unix_socket: /tmp/mysql.sock
+ # l'option wrapperClass de DBAL
wrapper_class: MyDoctrineDbalConnectionWrapper
charset: UTF8
- logging: %kernel.debug%
+ logging: "%kernel.debug%"
platform_service: MyOwnDatabasePlatformService
mapping_types:
enum: string
types:
custom: Acme\HelloBundle\MyCustomType
+ # l'option keepSlave de DBAL
+ keep_slave: false
.. code-block:: xml
@@ -415,4 +416,4 @@ qui est la première définie ou celle configurée via le paramètre ``default_c
Chaque connexion est aussi accessible via le service ``doctrine.dbal.[name]_connection``
où ``[name]`` est le nom de la connexion.
-.. _Documentation DBAL: http://docs.doctrine-project.org/projects/doctrine-dbal/en/latest/index.html
\ No newline at end of file
+.. _documentation DBAL: http://docs.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 4add989e6..027bf9b18 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -242,8 +242,8 @@ du fichier serait ``/images/logo.png?version=5``.
Le pattern reçoit respectivement le chemin original du fichier et la version
en tant que premier et second paramètre. Comme le chemin du fichier est un
- paramètre, nous ne pouvons pas le modifier sur place (par exemple :
- ``/images/logo-v5.png``); cependant, nous pouvons préfixer le chemin du
+ paramètre, vous ne pouvez pas le modifier sur place (par exemple :
+ ``/images/logo-v5.png``) ; cependant, vous pouvez préfixer le chemin du
fichier en utilisant un pattern comme ``version-%%2$s/%%1$s``, qui donnerait
un chemin tel ``version-5/images/logo.png``.
diff --git a/reference/constraints.rst b/reference/constraints.rst
index 2b2418e15..1adf26717 100755
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -40,8 +40,6 @@ Contraintes de validation de référence
constraints/File
constraints/Image
- constraints/Luhn
-
constraints/Callback
constraints/All
constraints/UserPassword
diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index 35043baa1..627010268 100755
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -30,7 +30,8 @@ vouliez valider chaque entrée du tableau :
favoriteColors:
- All:
- NotBlank: ~
- - MinLength: 5
+ - Length:
+ min: 5
.. code-block:: php-annotations
@@ -44,7 +45,7 @@ vouliez valider chaque entrée du tableau :
/**
* @Assert\All({
* @Assert\NotBlank
- * @Assert\MinLength(5),
+ * @Assert\Length(min = "5"),
* })
*/
protected $favoriteColors = array();
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index 822f0c148..4a0f25505 100755
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -5,7 +5,7 @@ Cette contrainte est utilisée lorsque l'objet sous-jacent est une collection
(c'est-à-dire un tableau ou un objet qui implémente ``Traversable`` et ``ArrayAccess``),
mais vous aimeriez valider les différentes clés de cette collection de différentes
manières. Par exemple, vous pourriez valider la clé ``email`` en utilisant la contrainte
-``Email`` et la clé ``inventory`` avec la contrainte ``Min``.
+``Email`` et la clé ``inventory`` avec la contrainte ``Range``.
Cette contrainte permet également de s'assurer que certaines clés de la collection
sont bien présentes et que des clés supplémentaires ne le sont pas.
@@ -60,10 +60,10 @@ et d'une longueur de moins de 100 caractères, vous pouvez procéder comme ceci
personal_email: Email
short_bio:
- NotBlank
- - MaxLength:
- limit: 100
+ - Length:
+ max: 100
message: Votre bio est trop longue!
- allowMissingfields: true
+ allowMissingFields: true
.. code-block:: php-annotations
@@ -78,13 +78,13 @@ et d'une longueur de moins de 100 caractères, vous pouvez procéder comme ceci
* "personal_email" = @Assert\Email,
* "short_bio" = {
* @Assert\NotBlank(),
- * @Assert\MaxLength(
- * limit = 100,
+ * @Assert\Length(
+ * max = 100,
* message = "Votre bio est trop longue!"
* )
* }
* },
- * allowMissingfields = true
+ * allowMissingFields = true
* )
*/
protected $profileData = array(
@@ -105,8 +105,8 @@ et d'une longueur de moins de 100 caractères, vous pouvez procéder comme ceci
-
+
+
@@ -122,7 +122,7 @@ et d'une longueur de moins de 100 caractères, vous pouvez procéder comme ceci
use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints\Collection;
use Symfony\Component\Validator\Constraints\Email;
- use Symfony\Component\Validator\Constraints\MaxLength;
+ use Symfony\Component\Validator\Constraints\Length;
class Author
{
@@ -133,7 +133,9 @@ et d'une longueur de moins de 100 caractères, vous pouvez procéder comme ceci
$metadata->addPropertyConstraint('profileData', new Collection(array(
'fields' => array(
'personal_email' => new Email(),
- 'lastName' => array(new NotBlank(), new MaxLength(100)),
+ 'lastName' => array(
+ new NotBlank(),
+ new Length(array("max" => 100)),
),
'allowMissingFields' => true,
)));
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 8e9996038..fedd307ca 100755
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -92,7 +92,7 @@ ses dimensions soient comprises dans un certain intervalle, ajoutez ce qui suit
* minWidth = 200,
* maxWidth = 400,
* minHeight = 200,
- * maxHeight = 400,
+ * maxHeight = 400
* )
*/
protected $headshot;
diff --git a/reference/constraints/Luhn.rst b/reference/constraints/Luhn.rst
deleted file mode 100644
index 152765c17..000000000
--- a/reference/constraints/Luhn.rst
+++ /dev/null
@@ -1,88 +0,0 @@
-Luhn
-====
-
-Cette contrainte est utilisée poue vous assurer qu'un numéro de carte de crédit
-vérifie l'`algorithme Luhn`_. Elle est utile pour la première étape de la validation
-d'une carte de crédit : avant de communiquer avec la plateforme de paiement.
-
-+----------------+-----------------------------------------------------------------------+
-| S'applique à | :ref:`propriété ou méthode` |
-+----------------+-----------------------------------------------------------------------+
-| Options | - `message`_ |
-+----------------+-----------------------------------------------------------------------+
-| Classe | :class:`Symfony\\Component\\Validator\\Constraints\\Luhn` |
-+----------------+-----------------------------------------------------------------------+
-| Validateur | :class:`Symfony\\Component\\Validator\\Constraints\\LuhnValidator` |
-+----------------+-----------------------------------------------------------------------+
-
-Utilisation de base
--------------------
-
-Pour utiliser le validateur Luhn, appliquez le simplement à une propriété
-d'un objet qui contient un numéro de carte de crédit.
-
-.. configuration-block::
-
- .. code-block:: yaml
-
- # src/Acme/SubscriptionBundle/Resources/config/validation.yml
- Acme\SubscriptionBundle\Entity\Transaction:
- properties:
- cardNumber:
- - Luhn:
- message: Veuillez vérifier votre numéro de carte de crédit.
-
- .. code-block:: xml
-
-
-
-
-
-
-
-
-
-
- .. code-block:: php-annotations
-
- // src/Acme/SubscriptionBundle/Entity/Transaction.php
- use Symfony\Component\Validator\Constraints as Assert;
-
- class Transaction
- {
- /**
- * @Assert\Luhn(message = "Veuillez vérifier votre numéro de carte de crédit.")
- */
- protected $cardNumber;
- }
-
- .. code-block:: php
-
- // src/Acme/SubscriptionBundle/Entity/Transaction.php
- use Symfony\Component\Validator\Mapping\ClassMetadata;
- use Symfony\Component\Validator\Constraints\Luhn;
-
- class Transaction
- {
- protected $cardNumber;
-
- public static function loadValidatorMetadata(ClassMetadata $metadata)
- {
- $metadata->addPropertyConstraint('luhn', new Luhn(array(
- 'message' => 'Veuillez vérifier votre numéro de carte de crédit',
- )));
- }
- }
-
-Options disponibles
--------------------
-
-message
-~~~~~~~
-
-**type**: ``string`` **default**: ``Invalid card number``
-
-Le message par défaut qui est affiché si la valeur ne vérifie pas la
-validation Luhn.
-
-.. _`algorithme Luhn`: http://en.wikipedia.org/wiki/Luhn_algorithm
\ No newline at end of file
diff --git a/reference/constraints/Max.rst b/reference/constraints/Max.rst
index 2f7703f59..867f249ff 100755
--- a/reference/constraints/Max.rst
+++ b/reference/constraints/Max.rst
@@ -1,6 +1,11 @@
Max
===
+.. caution::
+ La contrainte Max est dépréciée depuis la version 2.1 et sera supprimée
+ dans Symfony 2.3. Utilisez :doc:`/reference/constraints/Range` avec
+ l'option ``max``.
+
Valide qu'un nombre donné est *inférieur* à un nombre maximum.
+----------------+--------------------------------------------------------------------+
diff --git a/reference/constraints/MaxLength.rst b/reference/constraints/MaxLength.rst
index 7ae93e8b4..393e5b9c9 100755
--- a/reference/constraints/MaxLength.rst
+++ b/reference/constraints/MaxLength.rst
@@ -1,6 +1,11 @@
MaxLength
=========
+.. caution::
+ La contrainte MaxLength est dépréciée depuis la version 2.1 et sera supprimée
+ dans Symfony 2.3. Utilisez :doc:`/reference/constraints/Length` avec
+ l'option ``max``.
+
Valide que la longueur d'une chaîne de caractères est inférieure à la limite donnée.
+----------------+-------------------------------------------------------------------------+
diff --git a/reference/constraints/Min.rst b/reference/constraints/Min.rst
index a0d0165bd..d079c80ab 100755
--- a/reference/constraints/Min.rst
+++ b/reference/constraints/Min.rst
@@ -1,6 +1,11 @@
Min
===
+.. caution::
+ La contrainte Min est dépréciée depuis la version 2.1 et sera supprimée
+ dans Symfony 2.3. Utilisez :doc:`/reference/constraints/Range` avec
+ l'option ``min``.
+
Valide qu'un nombre donné est *supérieur* à un nombre minimum.
+----------------+--------------------------------------------------------------------+
diff --git a/reference/constraints/MinLength.rst b/reference/constraints/MinLength.rst
index f69585a60..a80a79793 100755
--- a/reference/constraints/MinLength.rst
+++ b/reference/constraints/MinLength.rst
@@ -1,6 +1,11 @@
MinLength
=========
+.. caution::
+ La contrainte MinLength est dépréciée depuis la version 2.1 et sera supprimée
+ dans Symfony 2.3. Utilisez :doc:`/reference/constraints/Length` avec
+ l'option ``min``.
+
Valide que la longueur d'une chaîne de caractères est au moins supérieure à la
limite donnée.
diff --git a/reference/constraints/Null.rst b/reference/constraints/Null.rst
index 70738091b..b9917ad81 100755
--- a/reference/constraints/Null.rst
+++ b/reference/constraints/Null.rst
@@ -31,7 +31,7 @@ soit exactement égale à ``null``, ajoutez le code suivant :
Acme\BlogBundle\Entity\Author:
properties:
firstName:
- - Null: ~
+ - 'Null': ~
.. code-block:: php-annotations
diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index 21fec4f9a..29a010beb 100755
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -51,7 +51,7 @@ que l'ancien mot de passe est correct :
// src/Acme/UserBundle/Form/Model/ChangePassword.php
namespace Acme\UserBundle\Form\Model;
- use Symfony\Component\Security\Core\Validator\Constraints as SecurityAssert;
+ use Symfony\Component\Security\Core\Validator\Constraint as SecurityAssert;
class ChangePassword
{
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index 21c6c785e..580bc8349 100755
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -16,7 +16,7 @@ un objet et les sous-objets qui lui sont associés.
Utilisation de base
-------------------
-Dans l'exemple suivant, nous créons deux classes ``Author`` et ``Address``
+Dans l'exemple suivant, vous créez deux classes ``Author`` et ``Address``
qui ont toutes les deux des contraintes sur leurs propriétés. De plus,
l'objet ``Author`` stocke une instance d'``Address`` dans sa propriété ``$address``.
@@ -50,13 +50,15 @@ l'objet ``Author`` stocke une instance d'``Address`` dans sa propriété ``$addr
- NotBlank: ~
zipCode:
- NotBlank: ~
- - MaxLength: 5
+ - Length:
+ max: 5
Acme\HelloBundle\Author:
properties:
firstName:
- NotBlank: ~
- - MinLength: 4
+ - Length:
+ min: 4
lastName:
- NotBlank: ~
@@ -69,14 +71,18 @@ l'objet ``Author`` stocke une instance d'``Address`` dans sa propriété ``$addr
5
+
+
+
4
+
+
+