ThinkAdmin 框架使用指南

官方首页：https://thinkadmin.top/

ThinkAdmin 是一个基于 ThinkPHP 6 & 8 开发的强大后台管理框架，专为简化后台管理流程而设计。后台用户界面基于 LayUI 和 RequireJS 构建。

安装使用

安装框架前，请确保您的服务器已经安装了 PHP 8.1+(虽然官方说还支持 PHP7，但由于 composer 的安全机制，已经不支持了) 和 Composer。

通过 Composer 安装

推荐方式，默认只安装 admin 模块

注意: 默认使用 Sqlite 数据库，若使用其他数据库请修改配置后再执行初始化数据库操作。

### 创建项目（ 需要在英文目录下面执行 ）
composer create-project zoujingli/thinkadmin

### 进入项目根目录
cd thinkadmin

### 数据库初始化并安装
php think migrate:run

新版本 PHP 兼容性解决

实测使用 PHP8.5 安装该框架后，会出现兼容性报错：

• Case statements followed by a semicolon (;) are deprecated, use a colon (:) instead

  修改文件 vendor/zoujingli/think-library/src/Plugin.php，包含 case 'getapppackage'; 的行，; 改为 :

• Function imagedestroy() is deprecated since 8.5, as it has no effect since PHP 8.0

  修改文件 vendor/zoujingli/think-library/src/extend/ImageVerify.php 和 vendor/zoujingli/think-library/src/service/CaptchaService.php

  去掉 imagedestroy($img) 代码行

经验和技巧

• 创建新的菜单后，需要创建对应的控制器和视图文件

开发文档

权限配置

创建权限后，需要为权限配置可访问的功能节点。例如，若权限A仅允许访问特定的功能节点，您需要在配置中勾选这些节点。

配置应用名称

在配置授权时，若需展示应用名称，请前往 config/app.php 文件设置 app_names 的应用名称。

配置示例：

// config/app.php
return [
    // 应用名称配置（用于权限管理界面显示）
    'app_names' => [
        'admin' => '系统管理',
        'wechat' => '微信管理',
        'plugin-account' => '账号管理'
    ],
];

注意事项：

• 这些名称在显示前会经过 lang() 函数进行语言转换处理
• 确保在不同语言环境下均能正确显示
• 如果应用名称未配置，将显示应用代码（如 admin）

忽略权限检查

若您不希望某个应用受到后台权限控制，可以通过配置 rbac_ignore 选项来实现。

配置示例：

// config/app.php
return [
    // 忽略 RBAC 权限检查，可以配置多个应用
    'rbac_ignore' => ['index', 'wap', 'api'],
];

使用场景：

• 前台应用：index 应用通常不需要权限控制
• 移动端应用：wap 应用可能需要不同的权限机制
• API 应用：api 应用可能使用 Token 验证

注意事项：

• 被忽略的应用不会进行权限检查
• 所有用户都可以访问被忽略的应用
• 建议只忽略确实不需要权限控制的应用

数据助手

表单助手

→ 相关文档

FormHelper 是 ThinkAdmin 提供的快捷表单助手，能够根据提交的表单数据自动处理保存与更新操作，大幅提升开发效率。

功能5：回调处理

支持前置和后置回调，灵活处理业务逻辑：

// 前置回调：数据保存前处理
protected function _form_filter(array &$data)
{
    // 验证和处理数据
}

// 后置回调：数据保存后处理
protected function _form_result(bool $result, array $data)
{
    // 处理保存结果
}