nigelgreenway/tutis

A framework agnostic authentication library

v1.0.0 2016-06-17 16:08 UTC

Requires

• php: >=5.5

Requires (Dev)

• phpspec/phpspec: ^2.3
• squizlabs/php_codesniffer: ^2.5

MIT

• Nigel Greenway

README

Tutis is a wrapper for handling passwords. It is provided with a password handler that uses bcrypt and allows you to generate a hash, rehash and verify a password, all via a simple call to the Tutis\Pass object.

Install

Via Composer

$ composer require NigelGreenway/Tutis

Usage

Generate a pass for a user (using BasicPasswordHandler)

$username = 'bob.builder';

$password = '9455w0rd';
$options = [
    'cost' => 12,
];
$passwordHandler = Tutis\Handler\BasicPasswordHandler::hash($password, $options);

$pass = Tutis\Pass::generate($username, $passwordHandler, Tutis\Pass::ACTIVE);
echo $pass->toUsername() // bob.builder
echo $pass->toHash() // $0m3l0ngh4sh

Authenticate the password

$username = 'bob.builder';
$password = '9455w0rd';
$hash     = '$0m3l0ngh4sh';

$pass = Tutis\Pass::authenticate(
    $username,
    $password,
    $hash,
    BasicPasswordHandler::class,
    1
)

var_dump($pass); // Instance of Tutis\Pass

Change log

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Nigel Greenway
• All Contributors

License

The Apache License (Apache). Please see License File for more information.