PHPackages                             kkiernan/validator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation & Sanitization](/categories/validation)
4. /
5. kkiernan/validator

ActiveLibrary[Validation & Sanitization](/categories/validation)

kkiernan/validator
==================

A basic form validation class

1.0.0(10y ago)021MITPHP

Since Jun 27Pushed 8y ago1 watchersCompare

[ Source](https://github.com/kkiernan/php-form-validation)[ Packagist](https://packagist.org/packages/kkiernan/validator)[ RSS](/packages/kkiernan-validator/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

Basic Form Validation with Session Based Messaging
==================================================

[](#basic-form-validation-with-session-based-messaging)

This is a basic form validation class based on Laravel's \[far superior\] validation tools. I am writing it for my own use on simple hand-rolled projects, practice and learning. So, yeah.

Installation
------------

[](#installation)

The easiest way to use the class is through composer. I've added this to Packagist, again basically for my own convenience. In a terminal with composer installed, run the following:

```
composer require kkiernan/validator

```

Or add the package to your composer.json file and run composer install.

Validator
---------

[](#validator)

### Usage

[](#usage)

I am basically copying Laravel here. Create a `Kiernan\Validator` instance, passing it your data and validation rules. Add multiple rules to a field using the pipe separator.

```
$validator = new Validator(
	[
		'name' => 'Kelly Kiernan',
		'email' => 'kelly@kellykiernan.com',
		'password' => 'secret',
		'ip_address' => '192.168.0.1',
	],
	[
		'name' => 'required',
		'email' => 'required|email',
		'password' => 'required',
		'ip_address' => 'required|ip',
	]
);

```

Once you've created the validator instance, you can call either the `Validator::fails()` or `Validator::passes()` methods. For example:

```
if ($validator->fails())
{
    // Validation has failed
}

if ($validator->passes())
{
	// Validation has passed
}

```

If validation has failed, you can retrieve the error messages by calling `Validator::messages()`.

```
print_r($validator->messages());

```

### Available Validation Rules

[](#available-validation-rules)

- boolean
- email
- float
- integer
- ip
- required
- url

Session Based Messages
----------------------

[](#session-based-messages)

The examples/full example shows a hand-rolled example that uses the validator along with the session helper that is included. The session class provides a simple way of storing and retrieving messages from a session.

### Usage

[](#usage-1)

The session class uses the singleton pattern to present you with static methods you can call. Before use, you must first create the session instance. This just ensures that a PHP session is available to the class so that you don't have to check for/start a session in all of your scripts.

```
Session::create();

```

The session class has the following methods available:

- Session::flash();
- Session::old();
- Session::has();
- Session::get();
- Session::clear();

### Session::flash()

[](#sessionflash)

Add data to the session.

```
Session::flash('success', 'We have received your application. Someone will be in touch shortly.');

```

### Session::old()

[](#sessionold)

Retreive old session data. Returns null if data does not exist. You must first flash old data to the session:

```
if ($validator->fails())
{
	Session::flash('old', $_POST);

	Session::flash('errors', $validator->messages());

	header('Location: index.php');

	exit;
}

```

And then old data can be retrieved:

```