symfony · colinodell · Apr 6, 2015
diff --git a/UPGRADE-3.0.md b/UPGRADE-3.0.md
@@ -110,6 +110,8 @@ UPGRADE FROM 2.x to 3.0
 
 ### Form
 
+ * The method `clearErrors()` was added to `FormInterface`.
+
  * The option "precision" was renamed to "scale".
 
    Before:

diff --git a/src/Symfony/Component/Form/Button.php b/src/Symfony/Component/Form/Button.php
@@ -189,6 +189,14 @@ public function getErrors($deep = false, $flatten = true)
         return new FormErrorIterator($this, array());
     }
 
+    /**
+     * {@inheritdoc}
+     */
+    public function clearErrors($deep = false)
+    {
+        return $this;
+    }
+
     /**
      * Unsupported method.
      *

diff --git a/src/Symfony/Component/Form/CHANGELOG.md b/src/Symfony/Component/Form/CHANGELOG.md
@@ -10,6 +10,7 @@ CHANGELOG
  * removed `AbstractTypeExtension::setDefaultOptions()` method
  * added `FormTypeInterface::configureOptions()` method
  * added `FormTypeExtensionInterface::configureOptions()` method
+ * added `FormInterface::clearErrors()` method
 
 2.7.0
 -----

diff --git a/src/Symfony/Component/Form/Form.php b/src/Symfony/Component/Form/Form.php
@@ -834,6 +834,23 @@ public function getErrors($deep = false, $flatten = true)
         return new FormErrorIterator($this, $errors);
     }
 
+    /**
+     * {@inheritdoc}
+     */
+    public function clearErrors($deep = false)
+    {
+        $this->errors = array();
+
+        // Copy the errors of nested forms to the $errors array
+        if ($deep) {
+            foreach ($this as $child) {
+                $child->clearErrors(true);
+            }
+        }
+
+        return $this;
+    }
+
     /**
      * Returns a string representation of all form errors (including children errors).
      *

diff --git a/src/Symfony/Component/Form/FormInterface.php b/src/Symfony/Component/Form/FormInterface.php
@@ -108,6 +108,15 @@ public function all();
      */
     public function getErrors($deep = false, $flatten = true);
 
+    /**
+     * Removes all the errors of this form.
+     *
+     * @param bool $deep Whether to remove errors of child forms as well
+     *
+     * @return FormInterface The form instance
+     */
+    public function clearErrors($deep = false);
+
     /**
      * Updates the form with default data.
      *

diff --git a/src/Symfony/Component/Form/Tests/CompoundFormTest.php b/src/Symfony/Component/Form/Tests/CompoundFormTest.php
@@ -918,6 +918,46 @@ public function testGetErrorsDeepRecursive()
         $this->assertSame($nestedError, $nestedErrorsAsArray[0]);
     }
 
+    public function testClearErrors()
+    {
+        $this->form->addError(new FormError('Error 1'));
+        $this->form->addError(new FormError('Error 2'));
+
+        $this->form->clearErrors();
+
+        $this->assertCount(0, $this->form->getErrors());
+    }
+
+    public function testClearErrorsShallow()
+    {
+        $this->form->addError($error1 = new FormError('Error 1'));
+        $this->form->addError($error2 = new FormError('Error 2'));
+
+        $childForm = $this->getBuilder('Child')->getForm();
+        $childForm->addError(new FormError('Nested Error'));
+        $this->form->add($childForm);
+
+        $this->form->clearErrors(false);
+
+        $this->assertCount(0, $this->form->getErrors(false));
+        $this->assertCount(1, $this->form->getErrors(true));
+    }
+
+    public function testClearErrorsDeep()
+    {
+        $this->form->addError($error1 = new FormError('Error 1'));
+        $this->form->addError($error2 = new FormError('Error 2'));
+
+        $childForm = $this->getBuilder('Child')->getForm();
+        $childForm->addError($nestedError = new FormError('Nested Error'));
+        $this->form->add($childForm);
+
+        $this->form->clearErrors(true);
+
+        $this->assertCount(0, $this->form->getErrors(false));
+        $this->assertCount(0, $this->form->getErrors(true));
+    }
+
     // Basic cases are covered in SimpleFormTest
     public function testCreateViewWithChildren()
     {

diff --git a/src/Symfony/Component/Form/Tests/SimpleFormTest.php b/src/Symfony/Component/Form/Tests/SimpleFormTest.php
@@ -339,6 +339,14 @@ public function testHasNoErrors()
         $this->assertCount(0, $this->form->getErrors());
     }
 
+    public function testClearErrors()
+    {
+        $this->form->addError(new FormError('Error!'));
+        $this->form->clearErrors();
+
+        $this->assertCount(0, $this->form->getErrors());
+    }
+
     /**
      * @expectedException \Symfony\Component\Form\Exception\AlreadySubmittedException
      */
-Original file line number
+Diff line change
@@ Expand Up / @@ -110,6 +110,8 @@ UPGRADE FROM 2.x to 3.0 @@
     ### Form
+     * The method `clearErrors()` was added to `FormInterface`.
      * The option "precision" was renamed to "scale".
        Before:
@@ Expand Down @@