sebastiandevs/simplethenticator

TOTP based on https://github.com/PHPGangsta/GoogleAuthenticator updated and reworked to php8.2 because of inactivity of the original creator.

1.0.1 2023-12-14 12:16 UTC

Requires

• php: >=8.1

Requires (Dev)

• phpunit/phpunit: ^10.5

BSD-2-Clause

• Sebastian Poetter

• totp
• 2fa
• 2 factor authenticator library

README

• Copyright (c) 2025, https://poetter-sebastian.github.io
• Author: Sebastian Pötter, (@PHPGangsta, contributors) and contributors
• Licensed under the BSD 2-Clause "Simplified" License.

This class can generate secrets, generate codes, validate codes and present a QR-Code for scanning the secret. It implements TOTP according to RFC6238

Example:

Look at the function TestGenerator() in tests

(Other hash functions other than SHA1 only works for Google-Authenticator at the moment!)

$auth = new SimpleAuthenticator(6, 'SHA1');
try
{
    $secret = $auth->createSecret();
}
catch (Exception $e)
{
    echo $e->getMessage();
    exit();
}
echo 'Secret is: ' . $secret . '\n';

$qrCodeUrl = $auth->getQRCodeGoogleUrl($secret, '[e-mail]', 'Business');
echo 'QR-Code: ' . $qrCodeUrl . '\n';

$oneCode = $auth->getCode($secret);
echo 'Checking Code ' . $oneCode . ' and Secret ' . $secret . ':\n';

echo $auth->verifyCode($secret, $oneCode, 2)? 'OK': 'NOT OK';

output:

Secret is: S4VWK6CWPA3PMU2HZM2YEDZGSF2DQL3V

Google Charts URL for the QR-Code: https://api.qrserver.com/v1/create-qr-code/?data=otpauth%3A%2F%2Ftotp%2FVintage+Story%3ATesto%40test.test%3Fsecret%3DS4VWK6CWPA3PMU2HZM2YEDZGSF2DQL3V%26algorithm%3DSHA256%26issuer%3DVintage+Story&size=200x200&ecc=M

Checking Code '439195' and Secret 'S4VWK6CWPA3PMU2HZM2YEDZGSF2DQL3V':
OK

Installation:

Composer

• To use this package perform the following command:

composer require sebastiandevs/simplethenticator

Simple usage

• To use the class just import the SimpleAuthenticator.php as require_once() in your PHP code

Run Tests:

• All tests are inside tests folder.
• Execute composer run-script build-dev to install all dependencies
• Execute composer run-script test to run all tests in the test folder

Better library:

• For better code or complex implementations: please use RobThree/TwoFactorAuth!