symfony
diff --git a/‎UPGRADE-3.2.md
Copy file name to clipboardExpand all lines: UPGRADE-3.2.md
+22Lines changed: 22 additions & 0 deletions b/‎UPGRADE-3.2.md
Copy file name to clipboardExpand all lines: UPGRADE-3.2.md
+22Lines changed: 22 additions & 0 deletions
diff --git a/‎UPGRADE-4.0.md
Copy file name to clipboardExpand all lines: UPGRADE-4.0.md
+19Lines changed: 19 additions & 0 deletions b/‎UPGRADE-4.0.md
Copy file name to clipboardExpand all lines: UPGRADE-4.0.md
+19Lines changed: 19 additions & 0 deletions
diff --git a/‎src/Symfony/Component/Form/Form.php
Copy file name to clipboardExpand all lines: src/Symfony/Component/Form/Form.php
+2Lines changed: 2 additions & 0 deletions b/‎src/Symfony/Component/Form/Form.php
Copy file name to clipboardExpand all lines: src/Symfony/Component/Form/Form.php
+2Lines changed: 2 additions & 0 deletions
diff --git a/‎src/Symfony/Component/Form/FormInterface.php
Copy file name to clipboardExpand all lines: src/Symfony/Component/Form/FormInterface.php
+1-1Lines changed: 1 addition & 1 deletion b/‎src/Symfony/Component/Form/FormInterface.php
Copy file name to clipboardExpand all lines: src/Symfony/Component/Form/FormInterface.php
+1-1Lines changed: 1 addition & 1 deletion
diff --git a/‎src/Symfony/Component/Form/Tests/SimpleFormTest.php
Copy file name to clipboardExpand all lines: src/Symfony/Component/Form/Tests/SimpleFormTest.php
+4-1Lines changed: 4 additions & 1 deletion b/‎src/Symfony/Component/Form/Tests/SimpleFormTest.php
Copy file name to clipboardExpand all lines: src/Symfony/Component/Form/Tests/SimpleFormTest.php
+4-1Lines changed: 4 additions & 1 deletion
@@ -7,6 +7,28 @@ DependencyInjection
  * Calling `get()` on a `ContainerBuilder` instance before compiling the
    container is deprecated and will throw an exception in Symfony 4.0.
 
+Form
+----
+
+ * Calling `isValid()` on a `Form` instance before submitting it
+   is deprecated and will throw an exception in Symfony 4.0.
+
+   Before:
+
+   ```php
+   if ($form->isValid()) {
+       // ...
+   }
+   ```
+
+   After:
+
+   ```php
+   if ($form->isSubmitted() && $form->isValid()) {
+       // ...
+   }
+   ```
+
 Validator
 ---------
 
 
@@ -42,6 +42,25 @@ Form
  * Caching of the loaded `ChoiceListInterface` in the `LazyChoiceList` has been removed,
    it must be cached in the `ChoiceLoaderInterface` implementation instead.
 
+ * Calling `isValid()` on a `Form` instance before submitting it is not supported
+   anymore and raises an exception.
+
+   Before:
+
+   ```php
+   if ($form->isValid()) {
+       // ...
+   }
+   ```
+
+   After:
+
+   ```php
+   if ($form->isSubmitted() && $form->isValid()) {
+       // ...
+   }
+   ```
+
 FrameworkBundle
 ---------------
 
 
@@ -724,6 +724,8 @@ public function isEmpty()
     public function isValid()
     {
         if (!$this->submitted) {
+            @trigger_error('Call Form::isValid() with an unsubmitted form is deprecated since version 3.2 and will throw an exception in 4.0. Use Form::isSubmitted() before Form::isValid() instead.', E_USER_DEPRECATED);
+
             return false;
         }
 
 
@@ -192,7 +192,7 @@ public function addError(FormError $error);
     /**
      * Returns whether the form and all children are valid.
      *
-     * If the form is not submitted, this method always returns false.
+     * If the form is not submitted, this method always returns false (but will throw an exception in 4.0).
      *
      * @return bool
      */
 
@@ -11,6 +11,7 @@
 
 namespace Symfony\Component\Form\Tests;
 
+use Symfony\Bridge\PhpUnit\ErrorAssert;
 use Symfony\Component\Form\Form;
 use Symfony\Component\Form\FormEvent;
 use Symfony\Component\Form\FormEvents;
@@ -315,7 +316,9 @@ public function testValidIfSubmittedAndDisabled()
 
     public function testNotValidIfNotSubmitted()
     {
-        $this->assertFalse($this->form->isValid());
+        ErrorAssert::assertDeprecationsAreTriggered(array('Call Form::isValid() with an unsubmitted form'), function () {
+            $this->assertFalse($this->form->isValid());
+        });
     }
 
     public function testNotValidIfErrors()
Original file line number	Diff line number	Diff line change
`@@ -724,6 +724,8 @@ public function isEmpty()`
`724`	`724`	`public function isValid()`
`725`	`725`	`{`
`726`	`726`	`if (!$this->submitted) {`
	`727`	`+ @trigger_error('Call Form::isValid() with an unsubmitted form is deprecated since version 3.2 and will throw an exception in 4.0. Use Form::isSubmitted() before Form::isValid() instead.', E_USER_DEPRECATED);`
	`728`	`+`
`727`	`729`	`return false;`
`728`	`730`	`}`
`729`	`731`
Original file line number	Diff line number	Diff line change
`@@ -192,7 +192,7 @@ public function addError(FormError $error);`
`192`	`192`	`/**`
`193`	`193`	`* Returns whether the form and all children are valid.`
`194`	`194`	`*`
`195`		`- * If the form is not submitted, this method always returns false.`
	`195`	`+ * If the form is not submitted, this method always returns false (but will throw an exception in 4.0).`
`196`	`196`	`*`
`197`	`197`	`* @return bool`
`198`	`198`	`*/`