raspisms/models/Phone.php

<?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;

    /**
     * Allow phone database management 
     */
    class Phone extends \descartes\Model
    {
        /**
         * Return a phone by his id
         * @param int $id : Phone id
         * @return array
         */
        public function get (int $id)
        {
            return $this->_select_one('phone', ['id' => $id]);
        }


        /**
         * Return list of phones.
         * @param int $id_user : User id
         * @param int $limit  : Number of user to return
         * @param int $offset : Number of user to skip
         */
        public function list_for_user($id_user, $limit, $offset)
        {
            return $this->_select('phone', ['id_user' => $id_user], null, false, $limit, $offset);
        }

        
        /**
         * Return a phone by his number and user
         * @param string $number :  phone number
         * @param int $id_user : user id
         * @return array
         */
        public function get_by_number_for_user (string $number, int $id_user)
        {
            return $this->_select_one('phone', ['number' => $number, 'id_user' => $id_user]);
        }


        /**
         * Find phones of a user
         * @param string $id_user : user's id
         * @return array 
         */
        public function gets_for_user (int $id_user)
        {
            return $this->_select('phone', ['id_user' => $id_user]);
        }


        /**
         * Delete a phone
         * @param int $id : phone id
         * @return array
         */
        public function delete_for_user ($id_user, $id)
        {
            return $this->_delete('phone', ['id_user' => $id_user, 'id' => $id]);
        }


        /**
         * Create a phone
         * @param int $id_user : User to insert phone for
         * @param string $number : The number of the phone
         * @param string $adapter : The adapter to use the phone
         * @param string JSON $adapter_datas : A json string representing the datas of the adapter (for exemple credentials of an api)
         * @return mixed bool : false on error, true on success
         */
        public function insert($phone)
        {
            return (bool) $this->_insert('phone', $phone);
        }
        
        
        /**
         * Update a phone
         * @param int $id : Id of the phone
         * @param int $id_user : User to insert phone for
         * @param array $phone : updated datas
         * @return mixed bool : false on error, true on success
         */
        public function update_for_user ($id_user, $id, $phone)
        {
            return (bool) $this->_update('phone', $phone, ['id_user' => $id_user, 'id' => $id]);
        }
    }