The authentication utility simplifies the process of registering and login users into the database.
It's built on top of the
Wolff\Core\DB class so it uses PDO.
Keep in mind that the PHP PDO extension must be installed and enabled for the authentication utility to work.
First you need to instantiate the
Auth class, its constructor looks like this:
__construct([array $data[, array $options]])
It takes two parameters, an array with the destination database credentials, and an array which will be used as the options for the
password_hash function that the utility uses internally.
If no data array is passed, it will use the credentials defined in the
$credentials = [ 'dsn' => 'sqlite:example.db', 'username' => 'root', 'password' => '12345', ]; $options = [ 'cost' => 16, ]; $auth = new \Wolff\Utils\Auth($credentials, $options);
register(array $data): bool
Registers a new user into the database.
The only required keys that the given array must have are
password_confirm, both values must be a string and equal.
This method returns
true if the user has been successfully inserted into the database,
$auth->register([ 'name' => 'Alex', 'email' => '[email protected]', 'password' => 'canis123', 'password_confirm' => 'canis123', ]);
Take in consideration the following points:
The password is hashed before storing it, using the
BCRYPT algorithm with a default cost of 10.
The array keys are directly maped to the database table (except for the
password_confirm key). Meaning that an array with the following keys:
phone, will be inserted into a table that must have a
phone columns for this to work.
The example showed above should run a query "similar" to this:
INSERT INTO users (name, email, password) VALUES ('Alex', '[email protected]ail.com', 'canis123');
login(array $data): bool
true if the given user data exists in the database and is valid,
This method takes as parameter an array which will be the user data to validate. The only required key that the array must have is
$auth->login([ 'email' => '[email protected]', 'password' => 'canis123', ]);
If a user with the giving email and password exists in the
user table (in this example), it will return true.
setTable([string $table]): void
Sets the name of the database table that will be used to register and login users. By default its value is
setUnique(string $unique_column): void
Sets the name of the unique column that cannot be repeated when registering new users in the table. This function is available to avoid any duplicate entry.
setOptions(array $options): void
Set the options that will be used when hashing passwords.
This is the equivalent to defining the third parameter of the
password_hash function that is used internally in this utility.
$auth->setOptions([ 'cost' => 16 ]);
That will set the cost of the pasword hashing function to 16. By default it's 10.
Get the options that will be used when hashing passwords.
Returns the id of the last inserted/registered user into the database.
Returns the currently authenticated user data.
This function returns an associative array with the user data.
If no user has been logged in previously with the
login method or if the last login attempt failed this will return