Merge branch '3.1'

Author: wouterj

bundles/extension.rst

@@ -142,7 +142,7 @@ their fully qualified class names::
     {
         // ...
 
-         $this->addClassesToCompile(array(
+        $this->addClassesToCompile(array(
             'AppBundle\\Manager\\UserManager',
             'AppBundle\\Utils\\Slugger',
             // ...

changelog.rst

@@ -13,6 +13,65 @@ documentation.
     Do you also want to participate in the Symfony Documentation? Take a look
     at the ":doc:`/contributing/documentation/overview`" article.
 
+October, 2016
+-------------
+
+New Documentation
+~~~~~~~~~~~~~~~~~
+
+* `#7023 <https://github.com/symfony/symfony-docs/pull/7023>`_ Added useful debug commands in the debug documentation (hiddewie)
+* `#6932 <https://github.com/symfony/symfony-docs/pull/6932>`_ Explain the limitations of the custom messages in UniqueEntity (javiereguiluz)
+
+Fixed Documentation
+~~~~~~~~~~~~~~~~~~~
+
+* `#7049 <https://github.com/symfony/symfony-docs/pull/7049>`_ Fix the platform.sh builds (wouterj)
+
+Minor Documentation Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* `#7090 <https://github.com/symfony/symfony-docs/pull/7090>`_ Remove suggestion to change the `.class` parameters (mpdude)
+* `#7095 <https://github.com/symfony/symfony-docs/pull/7095>`_ Also mention "hasXXX" methods as validation targets (mpdude)
+* `#7091 <https://github.com/symfony/symfony-docs/pull/7091>`_ A bracket was missed (hpatoio)
+* `#7097 <https://github.com/symfony/symfony-docs/pull/7097>`_ link to specific HTTP Cache RFC (snoek09)
+* `#7098 <https://github.com/symfony/symfony-docs/pull/7098>`_ Improved Redirecting paragraph of Testing page (ShinDarth)
+* `#7100 <https://github.com/symfony/symfony-docs/pull/7100>`_ Update birthday.rst (angyvolin)
+* `#7020 <https://github.com/symfony/symfony-docs/pull/7020>`_ Added jQuery symfony-collection plugin to Form collection docs (hiddewie)
+* `#7086 <https://github.com/symfony/symfony-docs/pull/7086>`_ Update bug documentation input console /console/input.rst (Quiss)
+* `#7085 <https://github.com/symfony/symfony-docs/pull/7085>`_ Update custom_authentication_provider.rst (BatsaxIV)
+* `#7083 <https://github.com/symfony/symfony-docs/pull/7083>`_ update github example (hootlex)
+* `#7082 <https://github.com/symfony/symfony-docs/pull/7082>`_ Update metadata.rst (fberthereau)
+* `#7078 <https://github.com/symfony/symfony-docs/pull/7078>`_ Simple typo fix (Renrhaf)
+* `#7077 <https://github.com/symfony/symfony-docs/pull/7077>`_ remove caution message (snoek09)
+* `#7061 <https://github.com/symfony/symfony-docs/pull/7061>`_ Change link to docs instead repo (mik-laj)
+* `#7066 <https://github.com/symfony/symfony-docs/pull/7066>`_ Remove erroneous placeholder text (regularjack)
+* `#7068 <https://github.com/symfony/symfony-docs/pull/7068>`_ Remove double spaces in some YAML configuration (michaelperrin)
+* `#7069 <https://github.com/symfony/symfony-docs/pull/7069>`_ use FCQN to reference the form type in add() (xabbuh)
+* `#6785 <https://github.com/symfony/symfony-docs/pull/6785>`_ Twig reference: Add links from routing functions to special routing parameters (alexislefebvre)
+* `#7043 <https://github.com/symfony/symfony-docs/pull/7043>`_ [Serializer] Move the see also block in the Learn More section (dunglas)
+* `#7035 <https://github.com/symfony/symfony-docs/pull/7035>`_ Redirect /form to /forms for consistency (wouterj)
+* `#7054 <https://github.com/symfony/symfony-docs/pull/7054>`_ Fix IS_AUTHENTICATED_FULLY annotation (mschobner)
+* `#7044 <https://github.com/symfony/symfony-docs/pull/7044>`_ Add Nginx configuration to environment variables (peterkokot)
+* `#6928 <https://github.com/symfony/symfony-docs/pull/6928>`_ Update the Apache Router article to deprecate it entirely (javiereguiluz)
+* `#7053 <https://github.com/symfony/symfony-docs/pull/7053>`_ Minor improvements for the contribution guide (javiereguiluz)
+* `#7050 <https://github.com/symfony/symfony-docs/pull/7050>`_ use single quotes for YAML strings (snoek09)
+* `#7047 <https://github.com/symfony/symfony-docs/pull/7047>`_ Fix typo in doctrine.rst (to manage) (lacyrhoades)
+* `#7046 <https://github.com/symfony/symfony-docs/pull/7046>`_ Fix incorrect callback validation example (mvar)
+* `#7034 <https://github.com/symfony/symfony-docs/pull/7034>`_ Changed RFC links from drafts to proposed standarts (a-ast)
+* `#7038 <https://github.com/symfony/symfony-docs/pull/7038>`_ Remove a dead link to the old PR header (dunglas)
+* `#7037 <https://github.com/symfony/symfony-docs/pull/7037>`_ Fix a typo in the serializer doc (dunglas)
+* `#7036 <https://github.com/symfony/symfony-docs/pull/7036>`_ Fix 404 error link for American English Oxford Dictionary (peterkokot)
+* `#6980 <https://github.com/symfony/symfony-docs/pull/6980>`_ Use strict comparison (greg0ire)
+* `#7025 <https://github.com/symfony/symfony-docs/pull/7025>`_ Update buisness-logic (zairigimad)
+* `#7027 <https://github.com/symfony/symfony-docs/pull/7027>`_ Remove dash prefix from route name (bocharsky-bw)
+* `#7028 <https://github.com/symfony/symfony-docs/pull/7028>`_ A few minor tweaks (bocharsky-bw)
+* `#7029 <https://github.com/symfony/symfony-docs/pull/7029>`_ refer to Symfony instead of Symfony2 (snoek09)
+* `#7031 <https://github.com/symfony/symfony-docs/pull/7031>`_ Capitalize the time designator (simoheinonen)
+* `#7018 <https://github.com/symfony/symfony-docs/pull/7018>`_ Reorder arguments: $request as the first argument (bocharsky-bw)
+* `#7014 <https://github.com/symfony/symfony-docs/pull/7014>`_ Add a note about Filesystem:mkdir behavior (mickaelandrieu)
+* `#6886 <https://github.com/symfony/symfony-docs/pull/6886>`_ Update controllers.rst (asandjivy)
+
+
 September, 2016
 ---------------
 

components/form.rst

@@ -569,7 +569,7 @@ method:
 
         $form->handleRequest($request);
 
-        if ($form->isValid()) {
+        if ($form->isSubmitted() && $form->isValid()) {
             $data = $form->getData();
 
             // ... perform some action, such as saving the data to the database
@@ -598,7 +598,7 @@ method:
 
             $form->handleRequest($request);
 
-            if ($form->isValid()) {
+            if ($form->isSubmitted() && $form->isValid()) {
                 $data = $form->getData();
 
                 // ... perform some action, such as saving the data to the database

console/commands_as_services.rst

@@ -11,7 +11,7 @@ Symfony will even inject the container.
 While making life easier, this has some limitations:
 
 * Your command must live in the ``Command`` directory;
-* There's no way to conditionally register your service based on the environment
+* There's no way to conditionally register your command based on the environment
   or availability of some dependencies;
 * You can't access the container in the ``configure()`` method (because
   ``setContainer`` hasn't been called yet);

controller.rst

@@ -380,7 +380,7 @@ For example, imagine you're processing a :doc:`form </forms>` submission::
     {
         // ...
 
-        if ($form->isValid()) {
+        if ($form->isSubmitted() && $form->isValid()) {
             // do some sort of processing
 
             $this->addFlash(

controller/upload_file.rst

@@ -293,7 +293,7 @@ Now you're ready to use this service in the controller::
     {
         // ...
 
-        if ($form->isValid()) {
+        if ($form->isSubmitted() && $form->isValid()) {
             $file = $product->getBrochure();
             $fileName = $this->get('app.brochure_uploader')->upload($file);
 

doctrine/associations.rst

@@ -316,7 +316,7 @@ You can also query in the other direction::
 
 In this case, the same things occur: you first query out for a single ``Category``
 object, and then Doctrine makes a second query to retrieve the related ``Product``
-objects, but only once/if you ask for them (i.e. when you call ``->getProducts()``).
+objects, but only once/if you ask for them (i.e. when you call ``getProducts()``).
 The ``$products`` variable is an array of all ``Product`` objects that relate
 to the given ``Category`` object via their ``category_id`` value.
 
@@ -365,7 +365,7 @@ Of course, if you know up front that you'll need to access both objects, you
 can avoid the second query by issuing a join in the original query. Add the
 following method to the ``ProductRepository`` class::
 
-    // src/AppBundle/Entity/ProductRepository.php
+    // src/AppBundle/Repository/ProductRepository.php
     public function findOneByIdJoinedToCategory($productId)
     {
         $query = $this->getEntityManager()
@@ -407,7 +407,7 @@ Doctrine's `Association Mapping Documentation`_.
 .. note::
 
     If you're using annotations, you'll need to prepend all annotations with
-    ``ORM\`` (e.g. ``ORM\OneToMany``), which is not reflected in Doctrine's
+    ``@ORM\`` (e.g. ``@ORM\OneToMany``), which is not reflected in Doctrine's
     documentation. You'll also need to include the ``use Doctrine\ORM\Mapping as ORM;``
     statement, which *imports* the ``ORM`` annotations prefix.
 

doctrine/repository.rst

@@ -21,7 +21,7 @@ To do this, add the repository class name to your entity's mapping definition:
         use Doctrine\ORM\Mapping as ORM;
 
         /**
-         * @ORM\Entity(repositoryClass="AppBundle\Entity\ProductRepository")
+         * @ORM\Entity(repositoryClass="AppBundle\Repository\ProductRepository")
          */
         class Product
         {
@@ -33,7 +33,7 @@ To do this, add the repository class name to your entity's mapping definition:
         # src/AppBundle/Resources/config/doctrine/Product.orm.yml
         AppBundle\Entity\Product:
             type: entity
-            repositoryClass: AppBundle\Entity\ProductRepository
+            repositoryClass: AppBundle\Repository\ProductRepository
             # ...
 
     .. code-block:: xml
@@ -47,7 +47,7 @@ To do this, add the repository class name to your entity's mapping definition:
 
             <entity
                 name="AppBundle\Entity\Product"
-                repository-class="AppBundle\Entity\ProductRepository">
+                repository-class="AppBundle\Repository\ProductRepository">
 
                 <!-- ... -->
             </entity>
@@ -72,8 +72,8 @@ entities, ordered alphabetically by name.
 
 .. code-block:: php
 
-    // src/AppBundle/Entity/ProductRepository.php
-    namespace AppBundle\Entity;
+    // src/AppBundle/Repository/ProductRepository.php
+    namespace AppBundle\Repository;
 
     use Doctrine\ORM\EntityRepository;
 

form/direct_submit.rst

@@ -18,7 +18,7 @@ submissions::
 
         $form->handleRequest($request);
 
-        if ($form->isValid()) {
+        if ($form->isSubmitted() && $form->isValid()) {
             // perform some action...
 
             return $this->redirectToRoute('task_success');
@@ -56,7 +56,7 @@ method, pass the submitted data directly to
         if ($request->isMethod('POST')) {
             $form->submit($request->request->get($form->getName()));
 
-            if ($form->isValid()) {
+            if ($form->isSubmitted() && $form->isValid()) {
                 // perform some action...
 
                 return $this->redirectToRoute('task_success');

form/dynamic_form_modification.rst

@@ -555,7 +555,7 @@ your application. Assume that you have a sport meetup creation controller::
             $meetup = new SportMeetup();
             $form = $this->createForm(SportMeetupType::class, $meetup);
             $form->handleRequest($request);
-            if ($form->isValid()) {
+            if ($form->isSubmitted() && $form->isValid()) {
                 // ... save the meetup, redirect etc.
             }