You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 

126 lines
3.0 KiB

<?php
declare(strict_types=1);
/**
* UserModel.php
* Created by PhpStorm.
* Date: 2026/10/17
* Time: 09:40
* Author: qian.guo
* E-mail: yiyezhiqiutel@gmail.com
*/
namespace app\model;
use think\facade\Db;
/**
* 用户模型
* 设计说明:
* - 表名 user(带 DB_PREFIX,由 .env 的 PREFIX 配置),主键 user_id
* - 逻辑删除 is_delete:0 正常 / 1 已删除,每个查询方法自行兜底
* - 禁用状态用 is_enable:0 启用 / 1 禁用(沿用规范既有语义,不自创 status)
* - 只做数据存取,不做业务校验、不拼 json,失败由调用方决定文案
*
* 依赖提醒:数据库设计与建表已延后,本类方法在未建表前无法实际执行
* 这是「业务层正常用 Model / Db」的直接结果,不是缺漏
*/
class UserModel
{
/**
* 按ID获取用户信息
* getUserInfoById
* @param int $user_id 用户ID
* @return array 不存在返回空数组
*/
public static function getUserInfoById($user_id)
{
$map = [];
$map['user_id'] = $user_id;
$map['is_delete'] = 0;
return Db::name('user')
->where($map)
->find();
}
/**
* 按 openid 获取用户信息
* getUserInfoByOpenid
* @param string $openid 微信 openid
* @return array 不存在返回空数组
*/
public static function getUserInfoByOpenid($openid)
{
$map = [];
$map['openid'] = $openid;
$map['is_delete'] = 0;
return Db::name('user')
->where($map)
->find();
}
/**
* 按条件获取用户信息
* getUserInfoByParam
* @param array $map 查询条件
* @return array 不存在返回空数组
*/
public static function getUserInfoByParam($map)
{
$map['is_delete'] = 0;
return Db::name('user')
->where($map)
->find();
}
/**
* 新增用户
* userAdd
* @param array $data 待写入数据
* @return int 自增ID
*/
public static function userAdd($data)
{
return Db::name('user')
->insertGetId($data);
}
/**
* 修改用户
* userUpdate
* @param int $user_id 用户ID
* @param array $data 待更新数据
* @return int 影响行数
*/
public static function userUpdate($user_id, $data)
{
$map = [];
$map['user_id'] = $user_id;
return Db::name('user')
->where($map)
->update($data);
}
/**
* 登录次数累加
* loginNumInc
* @param int $user_id 用户ID
* @return int 影响行数
*
* 用 Inc 而不是先查再写:后者在并发下会互相覆盖,且多一次查询
*/
public static function loginNumInc($user_id)
{
$map = [];
$map['user_id'] = $user_id;
return Db::name('user')
->where($map)
->Inc('login_num', 1)
->update();
}
}