Skip to content

v2.0.0 不兼容更新

历经15个月,BuildAdmin终于发布了第二个主要版本,在本版本中,我们将继续保持流行稳定技术栈的特性,同时一次性优化了所有小版本中不便重构的细节。

历史累计的不兼容更新都将在此版本完成更新,从老版本更新工作量可能较大,请谨慎升级或闲时升级。

新版本特性

  • 最低php版本限定为8.0.2
  • ThinkPHP升级到8.0.0
  • vue升级到v3.3
  • 有数据的表重新生成CRUD代码时,改为根据设计修改表结构,不再删表重建
  • 内置font-awesome
  • 多富文本编辑器共存
  • 前后端类型定义优化
  • 公共函数归类、命名规则统一
  • 省份地区数据与微信同步
  • 表格列可通过slot渲染
  • 升级框架无需在对比安装sql更新数据表结构,一行命令搞定结构迁移
  • 大量细节优化,详见更新日志

完善类型定义

PHP8带来了联合类型,改进了类型系统,我们基于此,完善了所有服务端代码的类型定义,在完善了前后台基类的类型定义后,所有继承于它们的控制器,都需要同步完善类型定义

  1. 控制器有重写index、add、edit、del方法的,均需配置方法的返回类型同父类
  2. 控制器有重写属性的,比如:model、noNeedLogin、preExcludeFields、withJoinTable等等,均需配置属性的类型同父类
  3. 基础框架比如TP,他们并没有为Model等类定义好方法和参数的类型,但BuildAdmin的基类做好了这个工作,这使更新变得繁琐,这是因为ba的基类也可能被开发者修改,同时既然最低要求php8,那就开发期间看到的代码都php8
  • 建议使用IDE,比如PhpStorm的提示快速完成类型配置
  • 亦可直接访问控制器,根据程序报错指引修改类型

命名规则统一

数据表命名规则统一

原数据表修改为备注
menu_ruleadmin_rule因为会员规则表名为user_rule,相关目录/文件名均以修改
原字段修改为
updatetime int(10)update_time bigint(16)
createtime int(10)create_time bigint(16)
lastlogintimelast_login_time
lastloginiplast_login_ip
loginfailurelogin_failure
joinipjoin_ip
jointimejoin_time

这项修改意味着您的数据表结构需要更新,但新版本中数据表字段的修改无需逐一对比sql文件调整,仅需执行一行命令即可完成,我们可称之为数据表迁移

  1. 参考更新文档拉取最新代码
  2. 确定已经执行了composer update命令
  3. 站点根目录执行php think migrate:run命令,成功后输出类似于:
ini
PS C:\build-admin> php think migrate:run

 == 20230620180908 Install: migrating
 == 20230620180908 Install: migrated 0.0179s

 == 20230620180916 InstallData: migrating
 == 20230620180916 InstallData: migrated 0.0288s

 == 20230622221507 Version200: migrating
 == 20230622221507 Version200: migrated 0.0561s

All Done. Took 0.1295s

前端命名规则统一

属性类型定义
原属性名新属性名备注
show-overflow-tooltipshowOverflowTooltip直接引用el的TableColumnCtx
block-helpblockHelpFormItem
label-widthlabelWidthFormItem
show-messageshowMessageFormItem
inline-messageinlineMessageFormItem
inline-messageinlineMessageFormItem

这项修改意味着您需要修改代码使用新的属性名,但不修改并不影响使用,只是编辑器会报属性找不到(属性未改名,只是类型定义的命名规则改变)

请求参数名
原参数名修改为备注
quick_searchquickSearch快速查询关键词
refresh_tokenrefreshToken刷新token

通常无需对这项修改做出反应,除非您自己写了接受quick_search的代码,同时使用了前端公共请求函数

公共函数归纳或名称优化

服务端公共函数

随着系统越来越完善,之前可作为公共函数,但现应归纳为公共类

原函数修改为备注
path_is_writableFilesystem::pathIsWritable路径是否可写
dir_is_emptyFilesystem::dirIsEmpty目录是否是空的
del_empty_dirFilesystem::delEmptyDir删除所有相对空目录
delDirFilesystem::delDir递归删除
path_transformFilesystem::fsFit路径分隔符根据当前系统分隔符适配
get_dir_filesFilesystem::getDirFiles获取目录内的文件列表
file_unit_to_byteFilesystem::fileUnitToByte将文件大小转换为字节单位
\ba\Date::unixtime\ba\Date::unixTime获取一个基于时间偏移的Unix时间戳
Helper::getTableNameTableManager::tableName获取[完整]表名

前端公共函数

原函数修改为备注
/@/components/tabletimeFormat/@/utils/commontimeFormat格式化时间

前端去除多余的 controllerUrls.ts

在以往,我们通常将一些控制器URL统一定义在此文件,然后在它处导入使用,但后续我们发现,它处导入使用的场景并不多,且此文件的存在会给萌新带来是否必须将URL定义在此文件内等困扰,我们舍弃了此文件,并完成了涉及此文件的系统内置代码的更新。您可以自行确定是否需要继续保留该文件,比如您已经在其中定义了很多URL,则推荐保留

公共语言翻译大写开头

此项修改是为了尽量避免公共语言与子级语言包冲突的情况发生,比如公共语言包中存在user,那么与user.user就存在了冲突。

您可能已经使用了部分公共语言翻译,更新后,您可以在web目录搜索关键词批量替换为替换值,按使用频率排序

原翻译key修改后新的key搜索关键词替换值
quick Search PlaceholderQuick search placeholdert('quick Search Placeholder't('Quick search placeholder'
updatetimeUpdate timet('updatetime')t('Update time')
createtimeCreate timet('createtime')t('Create time')
operateOperatet('operate')t('Operate')
idIdt('id')t('Id')
stateStatet('state')t('State')
Click SelectClick selectt('Click Select')t('Click select')
completeCompletet('complete')t('Complete')
addAddt('add')t('Add')
editEdit t('edit') t('Edit')
infoInfot('info')t('Info')
deleteDeletet('delete')t('Delete')
refreshRefresht('refresh')t('Refresh')
shrinkShrinkt('shrink')t('Shrink')
openOpent('open')t('Open')
searchSearcht('search')t('Search')
toTot('to')t('To')
noneNonet('none')t('None')
unknownUnknownt('unknown')t('Unknown')
weighWeight('weigh')t('Weigh')
weigh-sortDrag sortt('weigh-sort')t('Drag sort')

为了适应以上的语言翻译key修改,baTable.form.operate也需要改为大写开头:

搜索值替换值备注
['add', 'edit'].includes['Add', 'Edit'].includespopupForm.vue显示条件
form.operate = 'add'form.operate = 'Add'baTable.form.operate 添加操作标识符
form.operate = 'edit'form.operate = 'Edit'baTable.form.operate 编辑操作标识符
form.operate = 'info'form.operate = 'Info'baTable.form.operate 详情操作标识符
form.operate == 'add'form.operate == 'Add'baTable.form.operate
form.operate == 'edit'form.operate == 'Edit'baTable.form.operate
form.operate == 'info'form.operate == 'Info'baTable.form.operate