This repository has been archived on 2024-06-26. You can view files and clone it, but cannot push or open issues or pull requests.
sakura/libraries/ActionCode.php

76 lines
1.9 KiB
PHP
Raw Normal View History

<?php
namespace Sakura;
/**
2016-02-02 21:04:15 +00:00
* Used to generate one-time keys for user automatic user actions e.g. account activation.
*
* @package Sakura
2016-02-02 21:04:15 +00:00
* @author Julian van de Groep <me@flash.moe>
*/
2015-12-09 20:21:08 +00:00
class ActionCode
{
2016-02-02 21:04:15 +00:00
/**
* Generate an Action Code.
*
* @param string $action The identifier of the action.
* @param int $user The user this action code is intended for (leave 0 for universal).
*
* @return string The action code given to the user.
*/
2016-01-09 21:57:54 +00:00
public static function generate($action, $user = 0)
{
2016-01-09 21:57:54 +00:00
// Generate a code
$code = uniqid();
// Insert it
Database::insert('actioncodes', [
'code_action' => $action,
'user_id' => $user,
'action_code' => $code,
]);
// Return the code
return $code;
}
2016-02-02 21:04:15 +00:00
/**
* Validate an action code.
*
* @param string $action The action identifier.
* @param string $code The action code.
* @param int $user The id of the user validating this code.
* @param bool $invalidate Set if the code should be invalidated once validated.
*
* @return bool Boolean indicating success.
*/
2016-01-09 21:57:54 +00:00
public static function validate($action, $code, $user = 0, $invalidate = true)
{
2016-01-09 21:57:54 +00:00
// Fetch the code from the db
$get = Database::count('actioncodes', [
'code_action' => [$action, '='],
'action_code' => [$code, '='],
'user_id' => [$user, '='],
]);
// Invalidate the code if requested
if ($invalidate) {
self::invalidate($code);
}
// Return the result
return $get[0] > 0;
}
2016-02-02 21:04:15 +00:00
/**
* Make a code invalid.
*
* @param string $code The code that is being invalidated.
*/
2016-01-09 21:57:54 +00:00
public static function invalidate($code)
{
2016-01-09 21:57:54 +00:00
Database::delete('actioncodes', [
2016-01-10 18:24:47 +00:00
'code_action' => [$code, '='],
2016-01-09 21:57:54 +00:00
]);
}
}