Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 

README.md

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.

Usage

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();

Documentation

Please make sure you check the official documentation

About

[READ-ONLY] - Form abstraction used to create forms not tied to ORM backed models, or to other permanent datastores.

Resources

License

Packages

No packages published

Languages

You can’t perform that action at this time.