🎢 Leaf Forms #

Leaf Form contains methods to simply and quickly handle input from the user.

Installation #

You can quickly install leaf forms using the following composer or the leaf cli.

composer require leafs/form v1.1

or

leaf install form@1.1

sanitizeInput #

sanitizeInput offers basic security for input data, i.e. sanitizing input against SQL injection.

$username = Form::sanitizeInput($username);

If you however need better sanitizing, you can check out the anchor module

Form Submit #

This creates a form and submits it. You can call it a virtual form. It takes in 3 parameters, the request type, the form action and the form data. Currently, it only supports GET and POST requests.

Form::submit("POST", "/book/create", [
  "title" => "Book One",
  "author" => "Mychi"
]);

isEmail #

This checks if a field contains an email or not.

if (Form::isEmail($field)) {
  echo "This is an email";
}

body #

This returns all fields passed into a request as an array.

$data = Form::body();

Validation #

Validation is one of the most important features used in many different types of projects. Leaf Forms provides a very simple way to validate fields returned from forms, json data and even urls and files.

Validate #

Validate simply makes sure that the selected parameters pass these validation tests.

Parameters which fail the form validation are saved in the form's errors which can be accessed with errors(). So In case the validation fails, validate returns false, else true.

$validatorSuccess = Form::validate([
  "username" => "username",
  "email" => "email",
  "password" => "required"
]);

if (!$validatorSuccess) {
  response()->exit(Form::errors());
}

validateData #

validateData works pretty much the same way as validate except that instead of passing the name of the field you want to validate, you validate the data itself.

Form::validateData([
  "mychi.darko" => "validUsername",
  "mickdd22@gmail.com" => "email"
]);

validateField #

This method also allows you validate data, but compared, to the method above, this is much faster.

Form::validateField("username", "michael", "validUsername");

Multiple Rule Validation #

You can also pass an array as the rule parameter. If there's more than one rule, both of them will apply. Also, be sure not to use contradictory rules like number and textOnly or username and email.

Form::validate([
  "username" => "validUsername",
  "email" => "email",
  "password" => ["required", "noSpaces"]
]);

Supported rules #

This is a list of all supported validate rules

• required: field is required
• number: must only contain numbers
• text : must only contain text and spaces
• textOnly: should be text only, no spaces allowed
• validUsername: must only contain characters 0-9, A-Z and _
• username: alias for validUsername
• email: must be a valid email
• noSpaces: can't contain any spaces
• max: max length of a string (require arguments)
• min: min length of a string (require arguments)

Note that these rules aren't case-sensitive, so you can type them anyway you prefer, as long as the spelling is the same.

Create your own rules #

Not every project is the same, as such, you might need validation rules which are not available by default in leaf. As such, the rule method has been created to give you leeway to write your own validation rules.

You will need to use addError to save error messages when the validation fails.

Form::rule("max", function ($field, $value, $params) {
  if (strlen($value) > $params) {
    Form::addError($field, "$field can't be more than $params characters");
    return false;
  }
});

This is an example rule that makes sure that a string isn't longer than it should be. It takes in a $params value which is the max length of the string.

To use this rule, you can simply call max and pass a value into the $params field using :.

Form::validate([
  "username" => "max:10",
  ...

Adding the params field is not compulsory, you can create a rule that doesn't take a params field like this:

Form::rule("required", function ($field, $value) {
  if (($value == "" || $value == null)) {
    Form::addError($field, "$field is required");
    return false;
  }
});

This example doesn't take in any parameters.

supportedRules #

You can also get all the supported rules. This includes custom rules you've created.

$formRules = Form::supportedRules();

errors #

Remember we talked about Leaf Form errors? Leaf Form holds errors for all failed tests, you get all these errors back with errors()

$validation = Form::validate([
  "username" => "validUsername",
  "email" => "email",
  "password" => ["required", "noSpaces"]
]);

if (!$validation) return Form::errors();