raspisms/models/User.php

126 lines
3.4 KiB
PHP
Executable File

<?php
/*
* This file is part of RaspiSMS.
*
* (c) Pierre-Lin Bonnemaison <plebwebsas@gmail.com>
*
* This source file is subject to the GPL-3.0 license that is bundled
* with this source code in the file LICENSE.
*/
namespace models;
/**
* Class for user table administration. Not a standard model because has absolutly no user based restrictions
*/
class User extends \descartes\Model
{
/**
* Find a user by his id
* @param string $id : User id
* @return mixed array
*/
public function get ($id)
{
return $this->_select_one('user', ['id' => $id]);
}
/**
* Find a user using his email
* @param string $email : User email
* @return mixed array
*/
public function get_by_email($email)
{
return $this->_select_one('user', ['email' => $email]);
}
/**
* 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->_select_one('user', ['api_key' => $api_key]);
}
/**
* Return list of user.
*
* @param int $limit : Number of user to return
* @param int $offset : Number of user to skip
*/
public function list($limit, $offset)
{
return $this->_select('user', [], null, false, $limit, $offset);
}
/**
* Retourne une liste de useres sous forme d'un tableau.
*
* @param array $ids : un ou plusieurs id d'entrées à supprimer
* @param mixed $id
*
* @return int : Le nombre de lignes supprimées
*/
public function remove($id)
{
return $this->_delete('user', ['id' => $id]);
}
/**
* Insert a new user
* @param array $user : User to insert
* @return mixed bool|int : false if fail, new user id else
*/
public function insert($user)
{
$success = $this->_insert('user', $user);
return ($success ? $this->_last_id() : false);
}
/**
* Update a user using his is
* @param int $id : User id
* @param array $datas : Datas to update
* @return int : number of modified rows
*/
public function update($id, $datas)
{
return $this->_update('user', $datas, ['id' => $id]);
}
/**
* Update a user password by his id.
* @param int $id : User id
* @param array $password : The new password of the user
* @return int : Number of modified lines
*/
public function update_password($id, $password)
{
return $this->_update('user', ['password' => $password], ['id' => $id]);
}
/**
* Update a user email by his id.
* @param int $id : User id
* @param array $email : The new email
* @return int : Number of modified lines
*/
public function update_email($id, $email)
{
return $this->_update('user', ['email' => $email], ['id' => $id]);
}
}