CakePHP Form library

5.1.0-RC1 2024-02-27 16:49 UTC

This package is auto-updated.

Last update: 2024-05-21 02:48:16 UTC


Total Downloads License

CakePHP Form Library

Form abstraction used to create forms not tied to ORM backed models, or to other permanent datastores. Ideal for implementing forms on top of API services, or contact forms.


use Cake\Form\Form;
use Cake\Form\Schema;
use Cake\Validation\Validator;

class ContactForm extends Form

    protected function _buildSchema(Schema $schema)
        return $schema->addField('name', 'string')
            ->addField('email', ['type' => 'string'])
            ->addField('body', ['type' => 'text']);

    public function validationDefault(Validator $validator)
        return $validator->add('name', 'length', [
                'rule' => ['minLength', 10],
                'message' => 'A name is required'
            ])->add('email', 'format', [
                'rule' => 'email',
                'message' => 'A valid email address is required',

    protected function _execute(array $data)
        // Send an email.
        return true;

In the above example we see the 3 hook methods that forms provide:

  • _buildSchema() is used to define the schema data. You can define field type, length, and precision.
  • validationDefault() Gets a Cake\Validation\Validator instance that you can attach validators to.
  • _execute() lets you define the behavior you want to happen when execute() is called and the data is valid.

You can always define additional public methods as you need as well.

$contact = new ContactForm();
$success = $contact->execute($data);
$errors = $contact->getErrors();


Please make sure you check the official documentation