friendica/src/Model/Register.php

159 lines
3.9 KiB
PHP
Raw Normal View History

<?php
/**
2022-01-02 07:27:47 +00:00
* @copyright Copyright (C) 2010-2022, the Friendica project
2020-02-09 14:45:36 +00:00
*
* @license GNU AGPL version 3 or any later version
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*
*/
namespace Friendica\Model;
2020-02-25 21:16:27 +00:00
use Friendica\Content\Pager;
use Friendica\Database\DBA;
use Friendica\Util\DateTimeFormat;
use Friendica\Util\Strings;
/**
* Class interacting with the register database table
*/
class Register
{
/**
* Return the list of pending registrations
*
2020-02-25 21:16:27 +00:00
* @param int $start Start count (Default is 0)
* @param int $count Count of the items per page (Default is @see Pager::ITEMS_PER_PAGE)
*
* @return array
2019-01-06 21:06:53 +00:00
* @throws \Exception
*/
2020-02-25 21:16:27 +00:00
public static function getPending($start = 0, $count = Pager::ITEMS_PER_PAGE)
{
2020-04-24 15:42:43 +00:00
return DBA::selectToArray('pending-view', [], [], ['limit' => [$start, $count]]);
}
/**
* Returns the pending user based on a given user id
*
* @param int $uid The user id
*
* @return array The pending user information
*
* @throws \Exception
*/
public static function getPendingForUser(int $uid)
{
2020-04-29 01:40:59 +00:00
return DBA::selectFirst('pending-view', [], ['uid' => $uid, 'self' => true]);
}
/**
* Returns the pending registration count
*
* @return int
2019-01-06 21:06:53 +00:00
* @throws \Exception
*/
public static function getPendingCount()
{
2020-04-24 15:42:43 +00:00
return DBA::count('pending-view', ['self' => true]);
}
/**
* Returns the register record associated with the provided hash
*
* @param string $hash
* @return array
2019-01-06 21:06:53 +00:00
* @throws \Exception
*/
public static function getByHash($hash)
{
return DBA::selectFirst('register', [], ['hash' => $hash]);
}
/**
* Returns true if a register record exists with the provided hash
*
2019-01-06 21:06:53 +00:00
* @param string $hash
* @return boolean
2019-01-06 21:06:53 +00:00
* @throws \Exception
*/
public static function existsByHash($hash)
{
return DBA::exists('register', ['hash' => $hash]);
}
/**
* Creates a register record for an invitation and returns the auto-generated code for it
*
* @return string
2019-01-06 21:06:53 +00:00
* @throws \Exception
*/
public static function createForInvitation()
{
$code = Strings::getRandomName(8) . random_int(1000, 9999);
$fields = [
'hash' => $code,
'created' => DateTimeFormat::utcNow()
];
DBA::insert('register', $fields);
return $code;
}
/**
* Creates a register record for approval and returns the success of the database insert
* Checks for the existence of the provided user id
*
* @param integer $uid The ID of the user needing approval
* @param string $language The registration language
* @param string $note An additional message from the user
* @return boolean
2019-01-06 21:06:53 +00:00
* @throws \Exception
*/
public static function createForApproval($uid, $language, $note = '')
{
$hash = Strings::getRandomHex();
if (!User::exists($uid)) {
return false;
}
$fields = [
'hash' => $hash,
'created' => DateTimeFormat::utcNow(),
'uid' => $uid,
'password' => '', // Obsolete, slated for deletion
'language' => $language,
'note' => $note
];
return DBA::insert('register', $fields);
}
/**
* Deletes a register record by the provided hash and returns the success of the database deletion
*
2019-01-06 21:06:53 +00:00
* @param string $hash
* @return boolean
2019-01-06 21:06:53 +00:00
* @throws \Exception
*/
public static function deleteByHash($hash)
{
return DBA::delete('register', ['hash' => $hash]);
}
}