* * 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; /** * 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. */ class User extends \descartes\InternalController { private $model_user; private $internal_event; private $internal_setting; private $internal_phone; public function __construct(\PDO $bdd) { $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); } /** * Return list of users as an array. * * @param mixed(int|bool) $nb_entry : Number of entry to return * @param mixed(int|bool) $page : Numero of page * * @return array|bool : List of user or false */ public function list(?int $nb_entry = null, ?int $page = null) { return $this->model_user->list($nb_entry, $page * $nb_entry); } /** * Delete a user. * * @param array $ids : Les id des useres à supprimer * @param mixed $id * * @return int : Number of users deleted */ public function delete($id) { return $this->model_user->remove($id); } /** * 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 */ public function check_credentials($email, $password) { $user = $this->model_user->get_by_email($email); if (!$user) { return false; } if (!password_verify($password, $user['password'])) { return false; } return $user; } /** * Update a user password. * * @param string $id : User id * @param string $password : New password * * @return bool; */ public function update_password(int $id, string $password): bool { $password = password_hash($password, PASSWORD_DEFAULT); return (bool) $this->model_user->update_password($id, $password); } /** * Update user email. * * @param string $id : user id * @param string $email : new mail * * @return boolean; */ public function update_email($id, $email) { return (bool) $this->model_user->update_email($id, $email); } /** * 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]); } /** * Update user api key. * * @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; } /** * 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 */ public function get_by_email($email) { return $this->model_user->get_by_email($email); } /** * Find a user by his id. * * @param string $id : User id * * @return mixed array */ public function get($id) { return $this->model_user->get($id); } /** * 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); } /** * Update a user by his id. * * @param mixed $id * @param mixed $email * @param mixed $password * @param mixed $admin * @param mixed $api_key * @param string $status : User status * @param bool $encrypt_password : Should the password be encrypted, by default true * * @return int : Number of modified user */ public function update($id, $email, $password, $admin, $api_key, $status, bool $encrypt_password = true) { $user = [ 'email' => $email, 'password' => $encrypt_password ? password_hash($password, PASSWORD_DEFAULT) : $password, 'admin' => $admin, 'api_key' => $api_key, 'status' => $status, ]; return $this->model_user->update($id, $user); } /** * Create a new user. * * @param mixed $email * @param mixed $password * @param mixed $admin * @param ?string $api_key : The api key of the user, if null generate randomly * @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 */ public function create($email, $password, $admin, ?string $api_key = null, string $status = \models\User::STATUS_ACTIVE, bool $encrypt_password = true) { $user = [ 'email' => $email, 'password' => $encrypt_password ? password_hash($password, PASSWORD_DEFAULT) : $password, 'admin' => $admin, 'api_key' => $api_key ?? $this->generate_random_api_key(), 'status' => $status, ]; $new_id_user = $this->model_user->insert($user); if (!$new_id_user) { return false; } $success = $this->internal_setting->create_defaults_for_user($new_id_user); if (!$success) { $this->delete($new_id_user); return false; } return $new_id_user; } /** * Generate a random api key. * * @return string : The api key */ 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 * bool 'mms' => is the sms a mms * ] * * @return bool : False if no transfer, true else */ 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; } $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'], ]); } }