romash1408/formchecker

Checks form fields and generates html-table to mail it to administrator

Maintainers

Details

github.com/romash1408/formchecker

Source

Issues

Installs: 248

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

Type:package

v1.0.2 2018-02-21 10:55 UTC

Requires

  • php: >=5.3.0

MIT 40a8085d3fee1777528d73e8fc364c31694d4910

  • romash1408 <work.woop@romash1408.ru>

This package is not auto-updated.

Last update: 2025-07-06 08:38:04 UTC

README

Description

Makes similar checking of form fields filled on your web site. It verifies required fields, including email addresses (checks @ existing and hostname MX record).
After that html report is generated and sent by mail(), or user custom function, callback called with filtered fields and autosend is sent by same method.

Install

Via Composer

$ composer require romash1408/formchecker

Example

require "vendor/autoload.php";

use R14\FormChecker;
use R14\FormException;

$usermail;

$checker = new FormChecker(
    $forms = [
		"mainform" =>
		[
			"subject" => "Test main form",
			"fields" =>
			[
                "name" => [
                    "placeholder" => "Name",
                ],
                "phone" => [
                    "type" => "tel",
                    "placeholder" => "Phone number",
                    "required" => true,
                ],
                "email" => [
                    "type" => "email",
                    "placeholder" => "E-mail",
                    "required" => true,
                ],
                "list" => [
                    "type" => "list",
                    "placeholder" => "List",
                    "required" => true,
                    "list" => [
                        "One", "Two", "Three",
                    ],
                ],
			],
			"callback" => function($fields) use(&$usermail)
			{

                $usermail = $fields["email"];
                // We can send post request with filtered and checked data to CRM server, if needed
                // $fields["key"] = "123456";
                // Formsender::post("https://crm-server.com", $fields);
			},
			"autosend" =>
			[
				"template" => function()
				{

                    return <<<HTML
<h3>Thank you for your request!</h3>
HTML;

				},
				"address" => function() use(&$usermail)
				{
					return [ $usermail ];
				},
				"subject" => function()
				{
					return "Answer to user";
				},
			],
			"to" => [ "admin@server" ],
        ],
        "contactform" => [
            "subject" => "Contact form",
            "fields" => [
                "author" => [
                    "type" => "email",
                    "placeholder" => "Author e-mail",
                    "required" => true,
                ],
                "message" => [
                    "type" => "textarea",
                    "placeholder" => "Message",
                    "required" => true,
                ],
            ],
            "to" => [ "moder@gmail.com" ],
        ],
    ],
    $config = [
       "send" => function ($mail) {
            echo '
            <h2>Sending mail to ' . implode(", ", $mail["to"]) . ' with subject "' . $mail["subject"] . '"</h2>
            ' . $mail["body"] . '
            ';
        },
    ]
);

Now we have $checker variable with information about all our forms and send function. To make magic just call $checker->work() with formname ("default" by default) and form fields array ($_POST + $_FILES by default), like this:

try
{
    $checker->work($_POST["formname"]);
}
catch (FormException $e)
{
    echo '<h2 style="color: red">' . $e->getMessage() . '</h2>';
}

#1

$_POST = [
    "formname" => "mainform",
];

Output:

Field Phone number must not be empty

#2

$_POST = [
    "formname" => "mainform",
    "phone" => "+7 (999) 999-99-9",
    "email" => "test",
];

try {

    $checker->work($_POST["formname"]);

} catch (FormException $e) {

    echo '<h2 style="color: red">' . $e->getMessage() . '</h2>';

}

Output:

Incorrect phone number format

#3

$_POST = [
    "formname" => "mainform",
    "phone" => "+7 (999) 999-99-99",
    "email" => "test@gmail.co",
];

try {

    $checker->work($_POST["formname"]);

} catch (FormException $e) {

    echo '<h2 style="color: red">' . $e->getMessage() . '</h2>';

}

Output:

Incorrect email address format

#4

$_POST = [
    "formname" => "mainform",
    "name" => "Tester",
    "phone" => "+7 (999) 999-99-99",
    "email" => "test@gmail.com",
];

try {

    $checker->work($_POST["formname"]);

} catch (FormException $e) {

    echo '<h2 style="color: red">' . $e->getMessage() . '</h2>';

}

Output:

Field List must not be empty

#5

$_POST = [
    "formname" => "mainform",
    "name" => "Tester",
    "phone" => "+7 (999) 999-99-99",
    "email" => "test@gmail.com",
    "list" => [
        "One", "Four",
    ],
];

try {

    $checker->work($_POST["formname"]);

} catch (FormException $e) {

    echo '<h2 style="color: red">' . $e->getMessage() . '</h2>';

}

Output:

Did not found Four in List

#6

$_POST = [
    "formname" => "mainform",
    "name" => "Tester",
    "phone" => "+7 (999) 999-99-99",
    "email" => "test@gmail.com",
    "list" => [
        "One", "Three",
    ],
];

try {

    $checker->work($_POST["formname"]);

} catch (FormException $e) {

    echo '<h2 style="color: red">' . $e->getMessage() . '</h2>';

}

Output:

Result of sending main form

#7

$_POST = [
    "formname" => "contactform",
    "author" => "work@romash1408.ru",
    "message" => <<<TEXT
Helo, this is a test of FormChecker.
It is using <a href='http://php.net/manual/ru/function.htmlspecialchars.php'>htmlspecialchars</a>,
Su users can not <script>hack(you);</script>
TEXT
];

try {

    $checker->work($_POST["formname"]);

} catch (FormException $e) {

    echo '<h2 style="color: red">' . $e->getMessage() . '</h2>';

}

Output:

Result of sending contact form