Merge pull request cakephp#5056 from cakephp/3.0-fr

[fr] FR translations

en/controllers/components/security.rst

@@ -249,7 +249,7 @@ There may be cases where you want to disable all security checks for an action
         }
     }
 
-Note: use ``$this->Security->config()`` for CakePHP versions prior to 3.4
+Note: use ``$this->Security->config()`` for CakePHP versions prior to 3.4.0
 
 This example would disable all security checks for the edit action.
 

en/orm/entities.rst

@@ -270,7 +270,7 @@ The ``setErrors()`` or ``setError()`` method can also be used to set the errors
 it easier to test code that works with error messages::
 
     $user->setError('password', ['Password is required']);
-    $user->setErrors(['pasword' => ['Password is required'], 'username' => ['Username is required']]);
+    $user->setErrors(['password' => ['Password is required'], 'username' => ['Username is required']]);
     // Prior to 3.4.0
     $user->errors('password', ['Password is required.']);
 

en/orm/query-builder.rst

@@ -247,8 +247,7 @@ method::
     $query = $articles->find()
         ->order(['title' => 'ASC', 'id' => 'ASC']);
 
-
-When calling ``order()`` multiple times on a query multiple clauses will be appended.
+When calling ``order()`` multiple times on a query, multiple clauses will be appended.
 However, when using finders you may sometimes need to overwrite the ``ORDER BY``.
 Set the second parameter of ``order()`` (as well as ``orderAsc()`` or ``orderDesc()``) to
 ``Query::OVERWRITE`` or to ``true``::

en/orm/validation.rst

@@ -444,9 +444,9 @@ two rules::
 
 .. note::
 
-   ``validCount`` returns ``false`` if the property is not countable or does not exist.
-   E.g. comparing via ``<``, ``<=`` or against ``0`` will return ``false``,
-   if you do not supply at least an empty list of - say - subscriptions.
+    ``validCount`` returns ``false`` if the property is not countable or does not exist.
+    E.g. comparing via ``<``, ``<=`` or against ``0`` will return ``false``,
+    if you do not supply at least an empty list of - say - subscriptions.
 
 .. versionadded:: 3.3.0
     The ``validCount()`` method was added in 3.3.0.

fr/controllers/components/authentication.rst

@@ -22,6 +22,10 @@ etc..
 Tout ceci est couvert étape par étape dans le
 :doc:`Tutorial du Blog </tutorials-and-examples/blog-auth-example/auth>`.
 
+Si vous cherchez des solutions existantes pour l'authentification et / ou
+l'autorisation pour CakePHP, allez jeter un oeil à la section
+`Authentication and Authorization <https://github.com/FriendsOfCake/awesome-cakephp/blob/master/README.md#authentication-and-authorization>`_ de la CakePHP Awesome List.
+
 Authentification
 ================
 
@@ -595,6 +599,7 @@ envoyer des messages flash. Les clés disponibles sont
 
 - ``key`` - La clé à utiliser, 'default' par défaut. Avant 3.4.0, la clé par
   défaut était 'auth'.
+- ``element`` - Le nom de l'élément à utiliser pour le rendu. ``null`` par défaut.
 - ``params`` - Le tableau des paramètres supplémentaires à utiliser, ``[]`` par
   défaut.
 

fr/controllers/components/security.rst

@@ -62,14 +62,17 @@ mise en trou noir (blackhole callback)::
 
     public function beforeFilter(Event $event)
     {
-        $this->Security->config('blackHoleCallback', 'blackhole');
+        $this->Security->setConfig('blackHoleCallback', 'blackhole');
     }
 
     public function blackhole($type)
     {
         // Gère les erreurs.
     }
 
+Note : utilisez ``$this->Security->config()`` pour les versions de CakePHP
+inférieures à 3.4.0.
+
 Le  paramètre ``$type`` peut avoir les valeurs suivantes:
 
 * 'auth' Indique une erreur de validation de formulaire, ou une incohérence
@@ -148,7 +151,8 @@ validatePost
     essentiellement éteindre la validation de formulaire.
 
 Les options de configuration ci-dessus peuvent être _set_ via la méthode
-``config()``
+``setConfig()`` ou ``config()`` si vous utilisez une version de CakePHP avant
+3.4.0.
 
 Utilisation
 ===========
@@ -251,10 +255,13 @@ fonctionnalités de ``SecurityComponent``::
 
         public function beforeFilter(Event $event)
         {
-             $this->Security->config('unlockedActions', ['edit']);
+             $this->Security->setConfig('unlockedActions', ['edit']);
         }
     }
 
+Note : utilisez ``$this->Security->config()`` pour les versions de CakePHP
+inférieures à 3.4.0.
+
 Cet exemple désactiverait toutes les vérifications de sécurité pour une action
 edit.
 

fr/core-libraries/email.rst

@@ -42,7 +42,11 @@ respectifs::
     $email->addTo('[email protected]', 'To2 Example');
     // Les destinaitres de l'email sont: [email protected] et [email protected]
     $email->to('[email protected]', 'ToTest Example');
-    // Le destinaitre de l'email est: [email protected]
+    // Le destinataire de l'email est: [email protected]
+
+.. deprecated:: 3.4.0
+    Utilisez ``setFrom()``, ``setTo()``, ``setCc()`` , ``setBcc()``  et
+    ``setSubject()`` à la place.
 
 Choisir l'émetteur
 ------------------

fr/development/testing.rst

@@ -337,6 +337,14 @@ Cela mettra la couverture des résultats dans le répertoire webroot de votre
 application. Vous pourrez voir les résultats en allant à
 ``http://localhost/votre_app/coverage``.
 
+Si vous utilisez PHP 5.6.0 (ou supérieur), vous pouvez utilisez `phpdbg <http://phpdbg.com/>`__
+pour générer la couverture des résultats à la place de xdebug. ``phpdbg`` est
+généralement plus rapide dans la génération des rapports de couverture :
+
+.. code-block:: bash
+
+    $ phpdbg -qrr phpunit --coverage-html webroot/coverage tests/TestCase/Model/Table/ArticlesTableTest
+
 Combiner les Suites de Test pour les Plugins
 --------------------------------------------
 

fr/intro/cakephp-folder-structure.rst

@@ -4,22 +4,6 @@ Structure du dossier de CakePHP
 Après avoir téléchargé et extrait l'application CakePHP, voici les fichiers et
 répertoires que vous devriez voir:
 
-- bin
-- config
-- logs
-- plugins
-- src
-- tests
-- tmp
-- vendor
-- webroot
-- .htaccess
-- composer.json
-- index.php
-- README.md
-
-Vous remarquerez quelques dossiers principaux:
-
 - Le dossier *bin* contient les exécutables de la console Cake.
 - Le dossier *config* contient les (quelques) fichiers de
   :doc:`/development/configuration` que CakePHP utilise. Les détails sur la
@@ -29,24 +13,23 @@ Vous remarquerez quelques dossiers principaux:
   configuration par défaut des logs.
 - Le dossier *plugins* est l'endroit où sont stockés les :doc:`/plugins` que
   votre application utilise.
-- Le dossier *src* sera celui où vous exercerez votre magie : c'est là
-  que vous placerez les fichiers de votre application.
+- Le dossier *src* sera celui vous placerez les fichiers de votre application.
 - Le dossier *tests* est l'endroit où vous mettez les cas de test pour votre
   application.
 - Le dossier *tmp* est l'endroit où CakePHP stocke les données temporaires. Les
   données qu'il stocke dépendent de la façon dont vous avez configuré CakePHP
-  mais ce dossier est généralement utilisé pour stocker les descriptions de
-  model et parfois les informations de session.
+  mais ce dossier est généralement utilisé pour les stocker les traductions,
+  les descriptions de model et parfois les informations de session.
 - Le dossier *vendor* est l'endroit où CakePHP et d'autres dépendances de
-  l'application vont être installés. Engagez-vous personnellement à ne
-  **pas** modifier les fichiers dans ce dossier. Nous ne pourrons pas vous
-  aider si vous avez modifié le cœur du framework.
+  l'application vont être installés. Modifier ces fichiers est déconseillé car
+  composer écraser vos changements lors du prochain update que vous ferez.
 - Le répertoire *webroot* est la racine publique de votre application. Il
   contient tous les fichiers que vous souhaitez voir accessibles publiquement.
 
   Assurez-vous que les dossiers *tmp* et *logs* existent et qu'ils sont en
   écriture, autrement la performance de votre application sera sévèrement
-  impactée. En mode debug, CakePHP vous avertira si ce n'est pas le cas.
+  impactée. En mode debug, CakePHP vous avertira que ces dossiers ne peuvent
+  pas être écrits.
 
 Le Dossier Src
 ==============
@@ -55,22 +38,21 @@ Le répertoire *src* de CakePHP est l'endroit où vous réaliserez la majorité
 du développement de votre application. Regardons d'un peu plus près les dossiers
 à l'intérieur de *src*.
 
-Console
-    Contient les commandes de la console et les tasks de la console pour votre
-    application. Pour plus d'informations, regardez la section
-    :doc:`/console-and-shells`.
 Controller
     Contient les controllers et les components de votre application.
 Locale
     Stocke les fichiers pour l'internationalisation.
 Model
     Pour les tables, entity et behaviors de votre application.
-View
-    Les fichiers de présentation sont placés ici : cells, helpers et
-    templates de vues.
+Shell
+    Contient les commandes de la console et les tasks de la console pour votre
+    application. Pour plus d'informations, regardez la section
+    :doc:`/console-and-shells`.
 Template
     Les fichiers de présentation se trouvent ici: elements, pages d'erreur,
     les layouts, et les fichiers de template de vue.
+View
+    Les classes de présentation sont placés ici : views, cells, helpers.
 
 
 .. meta::

fr/orm/associations.rst

@@ -677,7 +677,7 @@ Regardez les models suivants::
         public function initialize(array $config)
         {
             $this->belongsToMany('Courses', [
-                'through' => 'CourseMemberships',
+                'through' => 'CoursesMemberships',
             ]);
         }
     }
@@ -687,7 +687,7 @@ Regardez les models suivants::
         public function initialize(array $config)
         {
             $this->belongsToMany('Students', [
-                'through' => 'CourseMemberships',
+                'through' => 'CoursesMemberships',
             ]);
         }
     }

fr/orm/database-basics.rst

@@ -568,12 +568,14 @@ faire correspondre les données dans cet objet et les expressions SQL::
             if ($value instanceof Point) {
                 return new FunctionExpression(
                     'POINT',
-                    $value->lat(),
-                    $value->long()
+                    [
+                        $value->lat(),
+                        $value->long()
+                    ]
                 );
             }
             if (is_array($value)) {
-                return new FunctionExpression('POINT', $value[0], $value[1]);
+                return new FunctionExpression('POINT', [$value[0], $value[1]]);
             }
             // Handle other cases.
         }

fr/orm/entities.rst

@@ -269,18 +269,27 @@ Erreurs de Validation
 
 Après avoir :ref:`sauvegardé une entity <saving-entities>` toute erreur de
 validation sera stockée sur l'entity elle-même. Vous pouvez accéder à toutes
-les erreurs de validation en utilisant la méthode ``errors()``::
+les erreurs de validation en utilisant les méthodes ``getErrors()`` et
+``getError()``::
 
     // Récupère toutes les erreurs
+    $errors = $user->getErrors();
+    // Avant 3.4.0
     $errors = $user->errors();
 
     // Récupère les erreurs pour un champ unique.
+    $errors = $user->getError('password');
+    // Avant 3.4.0
     $errors = $user->errors('password');
 
-La méthode ``errors()`` peut aussi être utilisée pour définir les erreurs sur
-une entity, facilitant les tests du code qui fonctionne avec les messages
-d'erreur::
+Les méthodes ``setErrors()`` et ``setError()`` peuvent aussi être utilisées
+pour définir les erreurs sur une entity, facilitant les tests du code qui
+fonctionne avec les messages d'erreur::
 
+    $user->setError('password', ['Password is required.']);
+    $user->setErrors(['password' => ['Password is required'], 'username' => ['Username is required']]);
+
+    // Avant 3.4.0
     $user->errors('password', ['Password is required.']);
 
 .. _entities-mass-assignment:

fr/orm/query-builder.rst

@@ -262,6 +262,20 @@ vous pouvez utiliser la méthode ``order``::
     $query = $articles->find()
         ->order(['title' => 'ASC', 'id' => 'ASC']);
 
+Lorsque vous appelez ``order()`` plusieurs fois sur une même requête, les clauses
+seront ajoutées les unes après les autres. Cependant, en utilisant les finders,
+vous pouvez parfois avoir besoin d'écraser le ``ORDER BY``. Pour se faire, vous
+pouvez utiliser le second paramètre de ``order()`` (mais aussi de ``orderAsc()``
+ou ``orderDesc()``) et le définir à ``Query::OVERWRITE`` ou ``true``::
+
+    $query = $articles->find()
+        ->order(['title' => 'ASC']);
+
+    // Plus loin dans le code, vous écrasez la clause ORDER BY plutôt
+    // qu'ajouter une autre clause à l'existante.
+    $query = $articles->find()
+        ->order(['created' => 'DESC'], Query::OVERWRITE);
+
 .. versionadded:: 3.0.12
 
     En plus de ``order``, les méthodes ``orderAsc`` et ``orderDesc`` peuvent

fr/orm/saving-data.rst

@@ -409,7 +409,7 @@ sauvegardée. Si vous voulez traiter toutes les entities en transaction unique,
 vous pouvez utiliser ``transactional()``::
 
     // Dans un controller.
-    $articles->connection()->transactional(function () use ($articles, $entities) {
+    $articles->getConnection()->transactional(function () use ($articles, $entities) {
         foreach ($entities as $entity) {
             $articles->save($entity, ['atomic' => false]);
         }

fr/orm/validation.rst

@@ -29,6 +29,10 @@ retournée::
         // validation de l'entity a échouée.
     }
 
+.. versionadded:: 3.4.0
+
+    La méthode ``getErrors()`` a été ajoutée.
+
 Quand vous construisez une entity avec la validation activée, les choses
 suivantes vont se produire:
 
@@ -458,6 +462,14 @@ règles::
     // Entre 3 et 5 tags
     $rules->add($rules->validCount('tags', 3, '>=', 'Vous devez avoir au moins 3 tags'));
     $rules->add($rules->validCount('tags', 5, '<=', 'Vous devez avoir au moins 5 tags'));
+    $rules->add($rules->validCount('subscription', 0, '==', 'Vous pouvez ne pas avoir de subscription'));
+
+.. note::
+
+    ``validCount`` retourne ``false`` si la propriété ne peut pas être comptée
+    ou n'existe pas. Par exemple, comparé via ``<``, ``<=`` ou avec ``0``
+    retournera ``false`` si vous ne fournissez pas au moins une liste vide
+    d'abonnements.
 
 .. versionadded:: 3.3.0
     La méthode ``validCount()`` a été ajoutée dans la version 3.3.0.