elmyrockers/ezauth

EzAuth PHP library - Lightweight & easy authentication library with secure 'remember me' feature for PHP. With this, you just need to write a few lines of PHP code only in each pages.

1.0.1 2025-01-14 13:21 UTC

Requires

• php: >=7.4
• elmyrockers/ezflash: ^1.0.1
• firebase/php-jwt: ^6.10
• gabordemooij/redbean: ^5.7
• illuminate/support: ^11.20
• illuminate/translation: ^11.20
• illuminate/validation: ^11.20
• phpmailer/phpmailer: ^6.9
• twig/twig: ^3.10

Requires (Dev)

• phpunit/phpunit: ^11.2
• symfony/error-handler: ^7.1
• symfony/var-dumper: ^7.1

MIT

• Helmi Aziz

README

Lightweight & easy authentication library with secure 'remember me' feature for PHP. With this, you just need to write a few lines of PHP code only in each pages.

Usage/Examples

1. Installation:

Install the EzAuth package using Composer:

composer require elmyrockers/ezauth

2. bootstrap.php:

Create bootstrap.php file. The complete code for this file should look like this:

// bootstrap.php
<?php
require_once 'vendor/autoload.php'; //Include composer's autoloader
use elmyrockers\EzAuth; // Use EzAuth package

$config = []; // Create an array contain configuration for our authentication
$auth = new EzAuth( $config ); // Instantiate a new `EzAuth` object, passing the configuration array as an argument.

3. Register Form:

Create a file named register_form.php containing the following HTML form. This form includes Bootstrap 5 for styling (you can replace it with your preferred framework).

<!-- register_form.php -->
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">
<form method="post">
	<?=$flash ?>
	<?=$csrfToken ?>
	
	<h1 class="my-3">Register Form</h1>
	<div class="mb-3 row">
		<label for="username" class="col-sm-3 col-form-label">Username:</label>
		<div class="col-sm-9">
			<input type="text" id="username" class="form-control" value="">
		</div>
	</div>
	<div class="mb-3 row">
		<label for="email" class="col-sm-3 col-form-label">Email:</label>
		<div class="col-sm-9">
			<input type="email" id="email" class="form-control" value="">
		</div>
	</div>
	<div class="mb-3 row">
		<label for="password" class="col-sm-3 col-form-label">Password:</label>
		<div class="col-sm-9">
			<input type="password" id="password" class="form-control">
		</div>
	</div>
	<div class="mb-3 row">
		<label for="confirm-password" class="col-sm-3 col-form-label">Confirm Password:</label>
		<div class="col-sm-9">
			<input type="password" id="confirm-password" class="form-control">
		</div>
	</div>
	<div class="mt-3 mb-3 row">
		<div class="col">
			<button type="submit" class="btn btn-primary float-end">Register</button>
		</div>
	</div>
</form>

4. register.php:

Create a file named register.php with the following code. It includes bootstrap.php and retrieves flash messages and the CSRF token from the EzAuth object before displaying the registration form.

// register.php
<?php
require_once 'bootstrap.php'; // Include bootstrap file

list(,$flash, $csrfToken ) = $auth->register();  // Extract flash message and CSRF token

include 'register_form.php';

You can now access register.php in your web browser to see the registration form and submit registration data. Good luck!

Reference

Configurations:

• $config[ 'database' ]
• $config[ 'email' ]
• $config[ 'message' ]
• $config[ 'auth' ]

Methods:

• __construct( array $config )
• $csrfToken = csrfToken()
• $flash = flashMessage()
• list( $status, $flash, $csrfToken ) = register( $callback = null )
• list( $status, $flash ) = verifyEmail( $callback = null )
• list( $status, $flash, $csrfToken ) = login( $callback = null )
• list( $status, $flash, $csrfToken ) = recoverPassword( $callback = null )
• list( $status, $flash, $csrfToken ) = resetPassword( $callback = null )
• $user = memberArea( null|string|array $allowedRoles = null )
• $user = isLoggedIn()
• redirectLoggedInUser()
• logout()

Simple Tutorial

Authors

@elmyrockers

License

MIT