PHP 后台管理框架 - FastAdmin/ThinkAdmin/Phinx-Migrations

FastAdmin

官方首页：https://www.fastadmin.net/
开源地址：GitHub | Gitee
最新版下载：FastAdmin 开源框架完整包
文档地址：FastAdmin开发文档中心

安装

bash

# 下载压缩包后解压到网站目录
unzip /path/to/fastadmin_1.6.2.20260323.zip -d /path/to/your/webroot/
# 设置网站根目录为解压后的 public 目录，并且伪静态设置为 ThinkPHP 的伪静态规则
# 访问网站，按照安装向导完成安装访问你的站点域名进行安装
#     https://www.example.com/install.php
# 安装完成后即可进入后台，比如： 
#     https://www.example.com/奇怪的文件名.php （奇怪的文件名.php 是后台安全入口）

个人使用笔记

标签状态 tab 切换不生效

FastAdmin 的标签页筛选机制是这样工作的：

用户点击标签页（HTML 中已正确配置 data-field="status"）

--> 框架自动捕获点击事件

--> 在 commonSearch 表单中查找 name="status" 的字段并设置值

--> 刷新表格时携带该参数

所以这就要求，标签页的字段一定要可以被搜索。所以如果你把标签页的字段设置为了这样：

{
  field: "status",
  title: __("Status"),
  searchList: statusListData,
  operate: false,  // ← 这导致 commonSearch 表单中不生成该字段！
  formatter: Table.api.formatter.status,
},

再点击标签页时，框架会尝试在 commonSearch 表单中找到 name="status" 的字段并设置值，但由于 operate: false 导致该字段没有被生成，所以无法找到并设置值，最终导致标签页切换没有任何效果。

所以如果遇到点击标签页没有数据变化时，可以检查确认下是否存在类似问题：

命令行

快速生成CRUD和菜单

FastAdmin在生成CRUD时会根据字段属性、字段注释、表注释自动生成语言包、组件和排版，所以注释要稍微讲究点。

php

//生成fa_test表的CRUD且控制器生成在二级目录下且一键生成菜单
//     推荐使用，否则如果表名带下划线，会生成多级目录
php think crud -t test -c mydir/test -u 1

//生成fa_test表的CRUD且对应的模型名为testmodel
php think crud -t test -m testmodel

//生成fa_test表的CRUD且所有以list或data结尾的字段都生成复选框
php think crud -t test --setcheckboxsuffix=list --setcheckboxsuffix=data
//生成fa_test表的CRUD且所有以image和img结尾的字段都生成图片上传组件
php think crud -t test --imagefield=image --imagefield=img

//一键生成mydir/test控制器的权限菜单
php think menu -c mydir/test

多语言

加载方式

框架会自动按照当前请求的控制器进行加载对应的语言包。

例如访问 https://demo.fastadmin.net/admin/dashboard/index 时，框架会自动加载：

bash

application/admin/lang/zh-cn.php
application/admin/lang/zh-cn/Dashboard.php

FastAdmin会默认加载 zh-cn.php 这个全局语言包。

扩展函数及辅助类

检测IP是否允许 check_ip_allowed

检测IP是否允许访问，如果检测到IP在常规管理->系统配置中配置的禁止IP中，将会输出403响应

参数

参数名	描述	默认值	必选
$ip	IP地址，不传时将使用当前请求用户的IP	null	否

返回值 无，如果检测到IP不允许，将会输出403响应

示例

php

check_ip_allowed();
//如果检测到IP不允许，将会输出403响应复制

日期时间处理类

php

//获取两个时区间相差的秒数
$seconds = \fast\Date::offset('America/Chicago', 'GMT');

//计算两个数值之间相差的时间
$span = \fast\Date::span(60, 182, 'minutes,seconds'); // array('minutes' => 2, 'seconds' => 2)
$span = \fast\Date::span(60, 182, 'minutes'); // 2，如果第三个参数只需返回一个数据时，此时直接返回值，不返回数组。
//第三个参数支持years,months,weeks,days,hours,minutes,seconds

//格式化时间戳为易读的字符串
$text = \fast\Date::human(time()-10); //10 seconds ago
$text = \fast\Date::human(time()+10); //10 seconds after
$text = \fast\Date::human(time()-70); //1 minute ago
$text = \fast\Date::human(time()+70); //1 minute ago

//获取一个基于时间偏移的Unix时间戳，常用于统计功能筛选日期时间的计算
$timestamp = \fast\Date::unixtime('day'); // 返回今天0点0分0秒的时间戳
$timestamp = \fast\Date::unixtime('day', -1); //返回昨天0点0分0秒的时间戳
$timestamp = \fast\Date::unixtime('day', -1, 'end'); //返回昨天23点59分59秒的时间戳
$timestamp = \fast\Date::unixtime('week'); // 返回本周一0点0分0秒的时间戳
$timestamp = \fast\Date::unixtime('week', -1); //返回上周一0点0分0秒的时间戳
$timestamp = \fast\Date::unixtime('week', -1, 'end'); //返回上周日23点59分59秒的时间戳
//\fast\Date::unixtime($type = 'day', $offset = 0, $type = 'begin');
//$type：默认为day，支持minute,hour,day,week,month,quarter,year
//$offset：默认为0，正数表示当前$type之后，负数表示当前$type之前
//$type：默认为begin，时间的开始或结束，可选前(begin,start,first,front)，end

Http请求处理类

php

//发送一个POST请求并获取返回结果
$result = \fast\Http::post("http://www.example.com", ['name'=>'张三', 'age'=>20]);
//发送一个POST请求并设置Content-Type并获取返回结果
$result = \fast\Http::post("http://www.example.com", ['name'=>'张三', 'age'=>20], [CURLOPT_TIMEOUT => 30, CURLOPT_HTTPHEADER => ['Content-Type: text/plain', 'Authorization: abcdefg']]);

//发送一个GET请求并获取返回结果，此时返回$result=['ret'=>true, 'msg'=>'返回结果'];
$result = \fast\Http::sendRequest("http://www.example.com", ['name'=>'张三', 'age'=>20], [CURLOPT_HTTPHEADER => ['Content-Type: text/plain']]);

//发送一个无需获取返回结果的请求
\fast\Http::sendAsyncRequest("http://www.example.com", ['name'=>'张三', 'age'=>20]);

//发送输出一个临时文件到浏览器端下载，并删除该文件
\fast\Http::sendToBrowser("你的临时文件绝对路径");

随机字符处理类

php

//生成一个包含数字和字母的6位随机字符串，默认为6位
$result = \fast\Random::alnum();
//生成一个包含数字和字母的15位随机字符串
$result = \fast\Random::alnum(15);

//生成一个仅包含字母的15位随机字符串
$result = \fast\Random::alpha(15);

//生成一个仅包含数字的15位随机数字
$result = \fast\Random::numeric(15);
//生成一个仅包含数字且不包含0的15位随机数字
$result = \fast\Random::nozero(15);

//生成全球唯一标识
$result = \fast\Random::uuid();

中文转拼音处理类

php

//中文转拼音全拼
$result = \fast\Pinyin::get("中文"); //返回zhongwen
//中文转拼音首字母
$result = \fast\Pinyin::get("中文", true); //返回zw
//中文转拼音使用-进行连接
$result = \fast\Pinyin::get("中文", false, '-'); //zhong-wen
//中文转拼音使用-进行连接并首字母大写
$result = \fast\Pinyin::get("中文", false, '-', true); //Zhong-Wen
//\fast\Pinyin::get($chinese, $onlyfirst = false, $delimiter = '', $ucfirst = false);
//$chinese：中文字符，必选
//$onlyfirst：是否只返回拼音首字母，默认为false
//$delimiter：拼音间分隔符，默认为空
//$ucfirst：是否拼音首字母大小，默认为false

ThinkAdmin

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

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

安装使用

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

通过 Composer 安装

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

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

bash

### 创建项目（ 需要在英文目录下面执行 ）
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 的应用名称。

配置示例：

php

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

注意事项：

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

忽略权限检查

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

配置示例：

php

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

使用场景：

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

注意事项：

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

数据助手

表单助手

→ 相关文档

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

功能5：回调处理

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

php

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

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

Phinx-Migrations

官方首页：https://phinx.org/

Phinx 是一个强大的数据库迁移工具，允许开发者以编程方式管理数据库结构的变更。它支持多种数据库系统，包括 MySQL、PostgreSQL、SQLite 和 SQL Server。

目前主流的 PHP 框架（如 Laravel、CakePHP、ThinkPHP 等）都集成了类似的迁移工具，Phinx 提供了一个独立且灵活的解决方案，适用于各种项目。

使用

基础使用

在包含 Migrations 的项目中，您可以使用以下命令来管理数据库迁移：

创建迁移文件：

bash

php vendor/bin/phinx create CreateUsersTable
# ThinkPHP
php think make:migration CreateUsersTable

运行迁移：

bash

php vendor/bin/phinx migrate
# ThinkPHP
php think migrate:run

自己定义迁移

迁移的文件位于 database/migrations 目录下
每个迁移文件包含一个类，类名与文件名对应，继承自 AbstractMigration 类
文件名格式为 YYYYMMDDHHMMSS_create_users_table.php，其中 YYYYMMDDHHMMSS 是时间戳，确保迁移的顺序，create_users_table 是描述迁移内容的名称，需要和类名对应
文件名需要严格遵循该格式，否则 Phinx 无法识别
迁移类中包含两个主要方法：
- up(): 定义应用迁移时的操作，如创建表、添加列等
- down(): 定义回滚迁移时的操作，如删除表、移除列等
简单点的话，可以只实现 change() 方法，Phinx 会自动推断出 up() 和 down() 的操作

迁移类示例：

php

use Phinx\Migration\AbstractMigration;

class CreateUsersTable extends AbstractMigration
{
    public function change()
    {
        $this->_createUsersTable();
    }

    protected function _createUsersTable()
        // 创建 users 表
        $table = $this->table('users', [
              'engine' => 'InnoDB', // 数据库引擎
              'collation' => 'utf8mb4_general_ci', // 字符集
              'comment' => '用户表' // 表注释
        ]);
        $table->addColumn('name', 'string', ['limit' => 100])
              ->addColumn('email', 'string', ['limit' => 100])
              ->addColumn('created_at', 'datetime')
              ->addColumn('updated_at', 'datetime')
              ->create();
    }
}

PHP 后台管理框架 - FastAdmin/ThinkAdmin/Phinx-Migrations ​

FastAdmin ​

安装 ​

个人使用笔记 ​

标签状态 tab 切换不生效 ​

命令行 ​

快速生成CRUD和菜单 ​

多语言 ​

加载方式 ​

扩展函数及辅助类 ​

检测IP是否允许 check_ip_allowed ​

日期时间处理类 ​

Http请求处理类 ​

随机字符处理类 ​

中文转拼音处理类 ​

ThinkAdmin ​

安装使用 ​

通过 Composer 安装 ​

新版本 PHP 兼容性解决 ​

经验技巧 ​

开发文档 ​

权限配置 ​

数据助手 ​

表单助手 ​

Phinx-Migrations ​

使用 ​

基础使用 ​

自己定义迁移 ​

PHP 后台管理框架 - FastAdmin/ThinkAdmin/Phinx-Migrations

FastAdmin

安装

个人使用笔记

标签状态 tab 切换不生效

命令行

快速生成CRUD和菜单

多语言

加载方式

扩展函数及辅助类

检测IP是否允许 check_ip_allowed

日期时间处理类

Http请求处理类

随机字符处理类

中文转拼音处理类

ThinkAdmin

安装使用

通过 Composer 安装

新版本 PHP 兼容性解决

经验技巧

开发文档

权限配置

数据助手

表单助手

Phinx-Migrations

使用

基础使用

自己定义迁移