raspisms/controllers/internals/User.php

302 lines
8.9 KiB
PHP
Raw Normal View History

2019-10-29 14:57:13 +01:00
<?php
/*
2019-11-10 17:48:54 +01:00
* This file is part of RaspiSMS.
*
2019-11-10 17:48:54 +01:00
* (c) Pierre-Lin Bonnemaison <plebwebsas@gmail.com>
*
2019-11-10 17:48:54 +01:00
* This source file is subject to the GPL-3.0 license that is bundled
* with this source code in the file LICENSE.
*/
namespace controllers\internals;
2019-10-29 14:57:13 +01:00
/**
2020-01-17 18:19:25 +01:00
* Methods to manage user. Not a standard controller as it has nothing to do with user based restrictions and must be usable only by admin.
*/
2019-10-29 18:36:25 +01:00
class User extends \descartes\InternalController
{
2019-10-29 14:57:13 +01:00
private $model_user;
private $internal_event;
2020-01-17 18:36:53 +01:00
private $internal_setting;
private $internal_phone;
2019-10-29 14:57:13 +01:00
2019-10-29 18:36:25 +01:00
public function __construct(\PDO $bdd)
2019-10-29 14:57:13 +01:00
{
$this->model_user = new \models\User($bdd);
$this->internal_event = new \controllers\internals\Event($bdd);
$this->internal_setting = new \controllers\internals\Setting($bdd);
$this->internal_phone = new Phone($bdd);
2019-10-29 14:57:13 +01:00
}
2019-10-29 18:36:25 +01:00
/**
* Return list of users as an array.
*
2019-10-29 14:57:13 +01:00
* @param mixed(int|bool) $nb_entry : Number of entry to return
* @param mixed(int|bool) $page : Numero of page
*
2019-10-29 14:57:13 +01:00
* @return array|bool : List of user or false
2019-10-29 18:36:25 +01:00
*/
public function list(?int $nb_entry = null, ?int $page = null)
2019-10-29 14:57:13 +01:00
{
2019-11-12 17:37:20 +01:00
return $this->model_user->list($nb_entry, $page * $nb_entry);
2019-10-29 14:57:13 +01:00
}
2019-10-29 14:57:13 +01:00
/**
* Delete a user.
*
2019-10-29 18:36:25 +01:00
* @param array $ids : Les id des useres à supprimer
* @param mixed $id
*
* @return int : Number of users deleted
2019-10-29 18:36:25 +01:00
*/
public function delete($id)
2019-10-29 14:57:13 +01:00
{
return $this->model_user->remove($id);
2019-10-29 18:36:25 +01:00
}
2019-10-29 14:57:13 +01:00
2019-10-29 18:36:25 +01:00
/**
2020-01-17 18:19:25 +01:00
* Check user credentials.
*
* @param string $email : User email
* @param string $password : User password
*
* @return mixed false | array : False if no user for thoses credentials, the user else
2019-10-29 18:36:25 +01:00
*/
public function check_credentials($email, $password)
2019-10-29 14:57:13 +01:00
{
$user = $this->model_user->get_by_email($email);
if (!$user)
{
2019-10-29 14:57:13 +01:00
return false;
}
if (!password_verify($password, $user['password']))
{
2019-10-29 14:57:13 +01:00
return false;
}
return $user;
2019-10-29 18:36:25 +01:00
}
2019-10-29 14:57:13 +01:00
2019-10-29 18:36:25 +01:00
/**
* Update a user password.
*
* @param string $id : User id
2019-10-29 14:57:13 +01:00
* @param string $password : New password
*
* @return bool;
2019-10-29 18:36:25 +01:00
*/
public function update_password(int $id, string $password): bool
2019-10-29 18:36:25 +01:00
{
2019-10-29 14:57:13 +01:00
$password = password_hash($password, PASSWORD_DEFAULT);
2019-10-29 14:57:13 +01:00
return (bool) $this->model_user->update_password($id, $password);
}
2019-10-29 14:57:13 +01:00
/**
* Update user email.
*
* @param string $id : user id
2019-10-29 14:57:13 +01:00
* @param string $email : new mail
*
2019-10-29 18:36:25 +01:00
* @return boolean;
*/
public function update_email($id, $email)
{
2019-10-29 14:57:13 +01:00
return (bool) $this->model_user->update_email($id, $email);
}
2020-03-30 01:52:53 +02:00
/**
* Update user status.
*
* @param string $id : user id
* @param string $status : new status
*
* @return boolean;
*/
public function update_status($id, $status)
{
return (bool) $this->model_user->update($id, ['status' => $status]);
}
2020-01-17 18:19:25 +01:00
/**
* Update user api key.
*
2020-01-17 18:19:25 +01:00
* @param string $id : user id
* @param ?string $api_key : new api key
*
* @return mixed : false on error, else new api key;
*/
public function update_api_key($id, ?string $api_key = null)
{
$api_key = $api_key ?? $this->generate_random_api_key();
$success = $this->model_user->update($id, ['api_key' => $api_key]);
if (!$success)
{
return false;
}
return $api_key;
}
2019-10-29 14:57:13 +01:00
/**
2020-01-17 18:19:25 +01:00
* Get a user by his email address.
*
* @param string $email : User email
*
* @return mixed boolean | array : false if cannot find user for this email, the user else
2019-10-29 14:57:13 +01:00
*/
2019-10-29 18:36:25 +01:00
public function get_by_email($email)
2019-10-29 14:57:13 +01:00
{
return $this->model_user->get_by_email($email);
2019-10-29 14:57:13 +01:00
}
2020-01-17 18:19:25 +01:00
2020-01-08 14:14:40 +01:00
/**
2020-01-17 18:19:25 +01:00
* Find a user by his id.
*
2020-01-08 14:14:40 +01:00
* @param string $id : User id
2020-01-17 18:19:25 +01:00
*
2020-01-08 14:14:40 +01:00
* @return mixed array
*/
2020-01-17 18:19:25 +01:00
public function get($id)
2020-01-08 14:14:40 +01:00
{
return $this->model_user->get($id);
}
2020-01-17 18:19:25 +01:00
/**
2020-01-17 18:19:25 +01:00
* Get a user by his api_key address.
*
* @param string $api_key : User api key
*
* @return mixed boolean | array : false if cannot find user for this api key, the user else
*/
public function get_by_api_key(string $api_key)
{
return $this->model_user->get_by_api_key($api_key);
}
2019-10-29 14:57:13 +01:00
2019-10-29 18:36:25 +01:00
/**
2020-01-17 18:19:25 +01:00
* Update a user by his id.
*
* @param mixed $id
* @param mixed $email
* @param mixed $password
* @param mixed $admin
2020-01-17 18:19:25 +01:00
* @param mixed $api_key
2020-03-30 01:52:53 +02:00
* @param string $status : User status
* @param bool $encrypt_password : Should the password be encrypted, by default true
*
* @return int : Number of modified user
2019-10-29 18:36:25 +01:00
*/
public function update($id, $email, $password, $admin, $api_key, $status, bool $encrypt_password = true)
2019-10-29 14:57:13 +01:00
{
$user = [
'email' => $email,
'password' => $encrypt_password ? password_hash($password, PASSWORD_DEFAULT) : $password,
2019-10-29 14:57:13 +01:00
'admin' => $admin,
2020-01-08 13:45:20 +01:00
'api_key' => $api_key,
2020-03-30 01:52:53 +02:00
'status' => $status,
2019-10-29 14:57:13 +01:00
];
return $this->model_user->update($id, $user);
2019-10-29 14:57:13 +01:00
}
2019-10-29 14:57:13 +01:00
/**
2020-01-17 18:19:25 +01:00
* Create a new user.
*
2020-01-17 18:19:25 +01:00
* @param mixed $email
* @param mixed $password
* @param mixed $admin
* @param ?string $api_key : The api key of the user, if null generate randomly
2020-03-30 01:52:53 +02:00
* @param string $status : User status, default \models\User::STATUS_ACTIVE
* @param bool $encrypt_password : Should the password be encrypted, by default true
*
* @return mixed bool|int : false on error, id of the new user else
2019-10-29 18:36:25 +01:00
*/
public function create($email, $password, $admin, ?string $api_key = null, string $status = \models\User::STATUS_ACTIVE, bool $encrypt_password = true)
2019-10-29 14:57:13 +01:00
{
$user = [
'email' => $email,
'password' => $encrypt_password ? password_hash($password, PASSWORD_DEFAULT) : $password,
2019-10-29 14:57:13 +01:00
'admin' => $admin,
'api_key' => $api_key ?? $this->generate_random_api_key(),
2020-03-30 01:52:53 +02:00
'status' => $status,
2019-10-29 14:57:13 +01:00
];
2020-04-02 19:10:54 +02:00
$new_id_user = $this->model_user->insert($user);
2019-10-29 14:57:13 +01:00
2020-04-02 19:10:54 +02:00
if (!$new_id_user)
{
2019-10-29 14:57:13 +01:00
return false;
}
2020-04-02 19:10:54 +02:00
$success = $this->internal_setting->create_defaults_for_user($new_id_user);
if (!$success)
{
2020-04-02 19:10:54 +02:00
$this->delete($new_id_user);
2020-01-17 18:19:25 +01:00
return false;
}
2020-04-02 19:10:54 +02:00
return $new_id_user;
2019-10-29 18:36:25 +01:00
}
/**
2020-01-17 18:19:25 +01:00
* Generate a random api key.
*
* @return string : The api key
*/
2020-01-17 18:19:25 +01:00
public function generate_random_api_key(): string
{
return bin2hex(random_bytes(16));
}
/**
* Transfer a received sms to user email
* @param int $id_user : User id
* @param array $received : [
* int 'id' => sms id,
* string 'at' => sms reception date,
* string 'text' => sms content,
* string 'destination' => id of phone the sms was sent to
* string 'origin' => phone number that sent the sms
* ]
*
* @return bool : False if no transfer, true else
*/
2020-04-02 19:10:54 +02:00
public function transfer_received (int $id_user, array $received) : bool
{
$settings = $this->internal_setting->gets_for_user($id_user);
if (!$settings['transfer'] ?? false)
{
return false;
}
$user = $this->get($id_user);
if (!$user)
{
return false;
}
2020-06-23 18:49:36 +02:00
$phone = $this->internal_phone->get_for_user($id_user, $received['destination']);
if (!$phone)
{
return false;
}
$mailer = new Mailer();
return $mailer->enqueue($user['email'], EMAIL_TRANSFER_SMS, [
'at' => $received['at'],
'origin' => $received['origin'],
'destination' => $phone['name'],
'text' => $received['text'],
]);
}
2019-10-29 18:36:25 +01:00
}