deprecate Form::_execute

Author: LordSimal

src/Form/Form.php

@@ -23,6 +23,7 @@
 use Cake\Utility\Hash;
 use Cake\Validation\ValidatorAwareInterface;
 use Cake\Validation\ValidatorAwareTrait;
+use function Cake\Core\deprecationWarning;
 
 /**
  * Form abstraction used to create forms not tied to ORM backed models,
@@ -282,6 +283,21 @@ public function execute(array $data, array $options = []): bool
      * @return bool
      */
     protected function _execute(array $data): bool
+    {
+        deprecationWarning('5.3.0', 'The _execute() method is deprecated. Override the process() method instead.');
+
+        return $this->process($data);
+    }
+
+    /**
+     * Hook method to be implemented in subclasses.
+     *
+     * Used by `execute()` to execute the form's action.
+     *
+     * @param array $data Form data.
+     * @return bool
+     */
+    protected function process(array $data): bool
     {
         return true;
     }

tests/TestCase/Form/FormTest.php

@@ -193,7 +193,9 @@ public function testExecuteValid(): void
             'email' => 'test@example.com',
         ];
 
-        $this->assertTrue($form->execute($data));
+        $this->deprecated(function () use ($form, $data): void {
+            $this->assertTrue($form->execute($data));
+        });
     }
 
     /**
@@ -208,7 +210,9 @@ public function testExecuteSkipValidation(): void
             'email' => 'wrong',
         ];
 
-        $this->assertTrue($form->execute($data, ['validate' => false]));
+        $this->deprecated(function () use ($form, $data): void {
+            $this->assertTrue($form->execute($data, ['validate' => false]));
+        });
     }
 
     /**