🚀 快速开始

<?php
declare(strict_types=1);

namespace app\admin\controller;

use think\admin\Controller;
use think\admin\helper\QueryHelper;
use think\admin\model\SystemUser;

/**
 * 用户管理
 * @class User
 * @package app\admin\controller
 */
class User extends Controller
{
    /**
     * 用户列表
     * @auth true
     * @menu true
     * @throws \think\db\exception\DataNotFoundException
     * @throws \think\db\exception\DbException
     * @throws \think\db\exception\ModelNotFoundException
     */
    public function index()
    {
        SystemUser::mQuery()->layTable(function () {
            $this->title = '用户管理';
        }, function (QueryHelper $query) {
            $query->where(['is_deleted' => 0, 'status' => 1]);
            $query->like('username,nickname,phone')
                  ->equal('status')
                  ->dateBetween('create_at')
                  ->order('id desc');
        });
    }

    /**
     * 添加用户
     * @auth true
     */
    public function add()
    {
        SystemUser::mForm('form');
    }

    /**
     * 编辑用户
     * @auth true
     */
    public function edit()
    {
        SystemUser::mForm('form');
    }

    /**
     * 修改用户状态
     * @auth true
     */
    public function state()
    {
        $this->_checkInput();
        SystemUser::mSave($this->_vali([
            'status.in:0,1'  => '状态值范围异常！',
            'status.require' => '状态值不能为空！',
        ]));
    }

    /**
     * 删除用户
     * @auth true
     */
    public function remove()
    {
        $this->_checkInput();
        SystemUser::mDelete();
    }

    /**
     * 检查输入变量（私有方法，防止删除系统超级账号）
     */
    private function _checkInput()
    {
        if (in_array('10000', str2arr(input('id', '')))) {
            $this->error('系统超级账号禁止删除！');
        }
    }

    /**
     * 表单数据处理
     * @param array $data
     * @throws \think\db\exception\DataNotFoundException
     * @throws \think\db\exception\DbException
     * @throws \think\db\exception\ModelNotFoundException
     */
    protected function _form_filter(array &$data)
    {
        if ($this->request->isPost()) {
            // 检查资料是否完整
            empty($data['username']) && $this->error('登录账号不能为空！');
            
            // 处理权限配置（实际项目中的权限处理）
            $data['authorize'] = arr2str($data['authorize'] ?? []);
            
            if (empty($data['id'])) {
                // 新增：检查账号是否重复
                $map = ['username' => $data['username'], 'is_deleted' => 0];
                if (SystemUser::mk()->where($map)->count() > 0) {
                    $this->error("账号已经存在，请使用其它账号！");
                }
                // 新添加的用户密码与账号相同
                $data['password'] = md5($data['username']);
            } else {
                // 编辑：不允许修改用户名
                unset($data['username']);
            }
        } else {
            // GET 请求：准备表单数据
            // 权限绑定处理（将字符串转换为数组）
            $data['authorize'] = str2arr($data['authorize'] ?? '');
        }
    }
}

<?php
use think\facade\Route;

// 自定义路由示例
Route::group('user', function () {
    Route::get('list', 'User/index');
    Route::get('create', 'User/add');
    Route::get('update', 'User/edit');
});

<?php
declare(strict_types=1);

namespace app\admin\controller;

use think\admin\Controller;

/**
 * 用户管理
 * @class User
 * @package app\admin\controller
 */
class User extends Controller
{
    // 控制器方法
}

<?php
declare(strict_types=1);

namespace app\admin\model;

use think\admin\Model;

/**
 * 用户模型
 * @class SystemUser
 * @package app\admin\model
 */
class SystemUser extends Model
{
    // 模型方法
}

// 使用 QueryHelper 进行数据查询（推荐使用模型方法）
SystemUser::mQuery()->layTable(function () {
    $this->title = '用户管理';
}, function (QueryHelper $query) {
    $query->where(['is_deleted' => 0]);
    $query->like('username,email')
          ->equal('status')
          ->dateBetween('create_at')
          ->order('id desc');
});

// 使用 FormHelper 处理表单
SystemUser::mForm('form');

// 使用 SaveHelper 更新状态
SystemUser::mSave($this->_vali([
    'status.require' => '状态不能为空！',
    'status.in:0,1'  => '状态值范围异常！'
]));

// 使用 DeleteHelper 删除数据
SystemUser::mDelete();

/**
 * 用户管理
 * @auth true    # 需要权限验证
 * @menu true    # 显示在菜单中
 * @throws \think\db\exception\DataNotFoundException
 * @throws \think\db\exception\DbException
 * @throws \think\db\exception\ModelNotFoundException
 */
public function index()
{
    SystemUser::mQuery()->layTable();
}

/**
 * 修改用户资料
 * @login true   # 只需要登录即可访问
 */
public function info()
{
    // 个人资料修改，登录用户即可访问
}

// 在 config/cache.php 中配置
'default' => 'redis',
'stores' => [
    'redis' => [
        'type' => 'redis',
        'host' => '127.0.0.1',
        'port' => 6379,
        'password' => '',
        'select' => 0,
        'timeout' => 0,
        'expire' => 0,
        'persistent' => false,
        'prefix' => '',
    ],
],

// 记录调试信息
$this->app->log->info('用户登录', ['user_id' => $userId]);
$this->app->log->error('数据库错误', ['error' => $e->getMessage()]);

// 开启 SQL 日志
$this->app->db->getLastSql();

// 查看执行的 SQL 语句
$sql = $this->app->db->getLastSql();
echo $sql;