zhamao-robot/zhamao-framework
1
0
Fork 0
mirror of https://github.com/zhamao-robot/zhamao-framework.git synced 2026-07-13 19:55:34 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
f91c8b6205bb36dfd0e7a2d03138f4c89f4872e2
zhamao-framework/docs/update/v2.md

286 lines
9.1 KiB
Markdown
Raw Normal View History

update docs
2020-12-23 01:21:51 +08:00
# 更新日志（v2 版本）
update docs
2021-03-29 17:18:19 +08:00
## v2.4.4 (build 405)
> 更新时间：2021.3.29
以下是可能不兼容的变更：
- 新增依赖：框架需要 PHP 安装 pcntl 扩展以及开启 `pcntl_signal` 函数（一般情况下编译安装的都会有，宝塔面板请手动解除函数禁用）
update to 2.4.3 version (build 403) add config: swoole.max_wait_time (default 5) add constant MAIN_WORKER add getExpireTS() for LightCache fix savePersistence() bug add zm_go() to prevent errors
2021-03-29 15:34:24 +08:00
## v2.4.3 (build 403)
update to 2.4.2 version (build 402) change WORKING_DIR constant change logic of savePersistence() add LightCache addPersistence() and removePersistence() method add `./zhamao` command
2021-03-27 16:30:15 +08:00
update to 2.4.3 version (build 403) add config: swoole.max_wait_time (default 5) add constant MAIN_WORKER add getExpireTS() for LightCache fix savePersistence() bug add zm_go() to prevent errors
2021-03-29 15:34:24 +08:00
> 更新时间：2021.3.29
update docs
2021-03-29 15:40:36 +08:00
- 新增：swoole 设置配置新增 `max_wait_time` 项，设置等待进程关闭流程最大时间（秒）
- 新增：常量 `MAIN_WORKER`，值等同于 `worker_cache` 项中的 `worker` 参数（WorkerCache 所在的进程）
- 新增：`LightCache` 新增 `getExpireTS()` 方法，用于返回项目过期的时间戳
- 修复：`savePersistence()` 的部分丢失数据的 bug
- 新增：全局方法 `zm_go()`
- 修复：2.4.2 版本下的刷屏报错
- 优化：Ctrl+C 响应机制，启用异步 重启/关闭 措施，防止残留僵尸进程和丢失数据
update to 2.4.3 version (build 403) add config: swoole.max_wait_time (default 5) add constant MAIN_WORKER add getExpireTS() for LightCache fix savePersistence() bug add zm_go() to prevent errors
2021-03-29 15:34:24 +08:00
## v2.4.2 (build 402)
> 更新时间：2021.3.27
update to 2.4.2 version (build 402) change WORKING_DIR constant change logic of savePersistence() add LightCache addPersistence() and removePersistence() method add `./zhamao` command
2021-03-27 16:30:15 +08:00
- 更改：`WORKING_DIR` 常量的含义
- 修复：未指定 `--remote-terminal` 参数时还依旧开启远程终端的 bug
- 删除：`phar_classloader()` 全局方法
- 更改：持久化存储 LightCache 的逻辑，修复一个愚蠢的容易造成误用的方式
- 新增：LightCache 方法 `addPersistence()` 和 `removePersistence()`
- 新增：框架启动短指令 `./zhamao` 或 `php zhamao`
update to 2.4.1 version (build 401) fix startup warning bug
2021-03-25 17:11:35 +08:00
## v2.4.1 (build 401)
> 更新时间：2021.3.25
- 修复：开启框架时导致的报错
update to v2.4.0 (build 399) add CheckConfigCommand.php add config update record docs adjust swoole version to 4.5.0 fix stop and reload bugs add $_running_annotation add remote terminal update global config add timer tick exception handler add zm_xxx global functions add isAtMe(), splitCommand(), matchCommand() function for MessageUtil add workerAction(), sendActionToWorker(), resumeAllWorkerCoroutines() functions for ProcessManager optimize CQCommand match function add custom TerminalCommand annotation add TuringAPI add getReloadableFiles() function for ZMUtil
2021-03-24 23:34:46 +08:00
## v2.4.0（build 400）
update to v2.4.0 (build 400) add systemd:generate command add check:config command init command add `--force|-F` option add MessageUtil function `addShortCommand()` clear debug message
2021-03-25 16:18:09 +08:00
> 更新时间：2021.3.25
update to v2.4.0 (build 399) add CheckConfigCommand.php add config update record docs adjust swoole version to 4.5.0 fix stop and reload bugs add $_running_annotation add remote terminal update global config add timer tick exception handler add zm_xxx global functions add isAtMe(), splitCommand(), matchCommand() function for MessageUtil add workerAction(), sendActionToWorker(), resumeAllWorkerCoroutines() functions for ProcessManager optimize CQCommand match function add custom TerminalCommand annotation add TuringAPI add getReloadableFiles() function for ZMUtil
2021-03-24 23:34:46 +08:00
- 新增：检查全局配置文件的命令
- 新增：全局配置文件更新记录
- 依赖变更：**Swoole 最低版本需要 4.5.0**
- 优化：reload 和 stop 命令重载和停止框架的逻辑
- 新增：`$_running_annotation` 变量，可在注解事件中的类使用
- 新增：远程终端（Remote Terminal），弥补原来删掉的本地终端，通过 nc 命令连接即可
- 新增：启动参数 `--worker-num`，`--task-worker-num`，`--remote-terminal`
- 更新：全局配置文件结构
- 新增：Swoole 计时器报错处理
- 新增：全局方法（`zm_dump()`，`zm_error()`，`zm_warning()`，`zm_info()`，`zm_success()`，`zm_verbose()`，`zm_debug()`，`zm_config()`）
- 新增：示例模块的图灵机器人和 at 机器人的处理函数
- 新增：MessageUtil 工具类新增 `isAtMe(), splitCommand(), matchCommand()` 方法
- 新增：ProcessManager 进程管理类新增 `workerAction(), sendActionToWorker(), resumeAllWorkerCoroutines()` 方法
- 优化：CQCommand 的匹配逻辑
- 新增：支持添加自定义远程终端指令的 `@TerminalCommand` 注解
- 新增：图灵机器人 API 封装函数
- 新增：ZMUtil 工具杂项类 `getReloadableFiles()` 函数
update to v2.4.0 (build 400) add systemd:generate command add check:config command init command add `--force|-F` option add MessageUtil function `addShortCommand()` clear debug message
2021-03-25 16:18:09 +08:00
- 新增：`vendor/bin/start systemd:generate` 生成 systemd 配置文件的功能
- 新增：`vendor/bin/start check:config` 检查配置文件更新的命令
update to 2.4.2 version (build 402) change WORKING_DIR constant change logic of savePersistence() add LightCache addPersistence() and removePersistence() method add `./zhamao` command
2021-03-27 16:30:15 +08:00
- 新增：`vendor/bin/start init` 新增 `--force` 参数，覆盖现有文件重新生成
update to v2.4.0 (build 400) add systemd:generate command add check:config command init command add `--force|-F` option add MessageUtil function `addShortCommand()` clear debug message
2021-03-25 16:18:09 +08:00
- 新增：MessageUtil 新增方法：`addShortCommand()`，用于快速添加静态文本问答回复的
update to v2.4.0 (build 399) add CheckConfigCommand.php add config update record docs adjust swoole version to 4.5.0 fix stop and reload bugs add $_running_annotation add remote terminal update global config add timer tick exception handler add zm_xxx global functions add isAtMe(), splitCommand(), matchCommand() function for MessageUtil add workerAction(), sendActionToWorker(), resumeAllWorkerCoroutines() functions for ProcessManager optimize CQCommand match function add custom TerminalCommand annotation add TuringAPI add getReloadableFiles() function for ZMUtil
2021-03-24 23:34:46 +08:00
update to v2.4.0 (build 400) add systemd:generate command add check:config command init command add `--force|-F` option add MessageUtil function `addShortCommand()` clear debug message
2021-03-25 16:18:09 +08:00
以下是需要**手动更新**或**更换新写法**的部分：
update to v2.4.0 (build 399) add CheckConfigCommand.php add config update record docs adjust swoole version to 4.5.0 fix stop and reload bugs add $_running_annotation add remote terminal update global config add timer tick exception handler add zm_xxx global functions add isAtMe(), splitCommand(), matchCommand() function for MessageUtil add workerAction(), sendActionToWorker(), resumeAllWorkerCoroutines() functions for ProcessManager optimize CQCommand match function add custom TerminalCommand annotation add TuringAPI add getReloadableFiles() function for ZMUtil
2021-03-24 23:34:46 +08:00
update to v2.4.0 (build 400) add systemd:generate command add check:config command init command add `--force|-F` option add MessageUtil function `addShortCommand()` clear debug message
2021-03-25 16:18:09 +08:00
- 配置文件 `global.php` 中的 `modules` 字段展开，内置模块的配置一律平铺到外面。详见 [更新日志 - 配置文件变更](/update/config)。
update to v2.4.0 (build 399) add CheckConfigCommand.php add config update record docs adjust swoole version to 4.5.0 fix stop and reload bugs add $_running_annotation add remote terminal update global config add timer tick exception handler add zm_xxx global functions add isAtMe(), splitCommand(), matchCommand() function for MessageUtil add workerAction(), sendActionToWorker(), resumeAllWorkerCoroutines() functions for ProcessManager optimize CQCommand match function add custom TerminalCommand annotation add TuringAPI add getReloadableFiles() function for ZMUtil
2021-03-24 23:34:46 +08:00
update to v2.4.0 (build 400) add systemd:generate command add check:config command init command add `--force|-F` option add MessageUtil function `addShortCommand()` clear debug message
2021-03-25 16:18:09 +08:00
以下是默认机器人直接连接产生的变更：
update to v2.4.0 (build 399) add CheckConfigCommand.php add config update record docs adjust swoole version to 4.5.0 fix stop and reload bugs add $_running_annotation add remote terminal update global config add timer tick exception handler add zm_xxx global functions add isAtMe(), splitCommand(), matchCommand() function for MessageUtil add workerAction(), sendActionToWorker(), resumeAllWorkerCoroutines() functions for ProcessManager optimize CQCommand match function add custom TerminalCommand annotation add TuringAPI add getReloadableFiles() function for ZMUtil
2021-03-24 23:34:46 +08:00
update to v2.4.0 (build 400) add systemd:generate command add check:config command init command add `--force|-F` option add MessageUtil function `addShortCommand()` clear debug message
2021-03-25 16:18:09 +08:00
- 2.4.0 新增了默认回复其他人 at 的消息，如果不需要，请将 `Hello.php` 中的 `changeAt()` 和 `turingAPI()` 方法删除。
update to v2.4.0 (build 399) add CheckConfigCommand.php add config update record docs adjust swoole version to 4.5.0 fix stop and reload bugs add $_running_annotation add remote terminal update global config add timer tick exception handler add zm_xxx global functions add isAtMe(), splitCommand(), matchCommand() function for MessageUtil add workerAction(), sendActionToWorker(), resumeAllWorkerCoroutines() functions for ProcessManager optimize CQCommand match function add custom TerminalCommand annotation add TuringAPI add getReloadableFiles() function for ZMUtil
2021-03-24 23:34:46 +08:00
update docs
2021-03-23 14:51:55 +08:00
## v2.3.5 (build 398)
update composer and roll to 397（v2.3.4)
2021-03-23 14:16:56 +08:00
> 更新时间：2021.3.23
update docs
2021-03-23 14:51:55 +08:00
- 修复：MySQL 数据库查询导致的一系列问题
- 修复：内存泄露问题
update composer and roll to 397（v2.3.4)
2021-03-23 14:16:56 +08:00
update docs
2021-03-23 14:51:55 +08:00
> 2.3.2-2.3.4 版本由于操作失误导致代码不完整，请直接使用 2.3.5 即可。
update to build 389 add various global functions
2021-03-18 16:36:28 +08:00
## v2.3.1
> 更新时间：2021.3.18
- 规范代码，修复一个小报错的 bug
## v2.3.0
update to build 386 fix ZM_DATA equals null add containsImage, getImageCQFromLocal function for MessageUtil
2021-03-16 01:34:17 +08:00
> 更新时间：2021.3.16
update docs
2021-03-16 01:39:55 +08:00
- 新增：MessageUtil 消息处理工具类
- 新增：TaskManager，封装了 TaskWorker 进程的应用
- 新增：CQObject，使用 `CQ::getCQ()` 可获取对象形式的 CQ 码解析结果
- 新增：`@OnTask` 注解，绑定任务函数
- 新增：RouteManager 路由管理类，可快速添加路由
- 修复：`ZM_DATA` 和 `DataProvider::getDataFolder()` 返回 false 的问题
- 优化：关闭显示停止框架后多余的输出信息
注：本次升级建议升级后合并全局配置文件，有一些新加的内容。
update to build 386 fix ZM_DATA equals null add containsImage, getImageCQFromLocal function for MessageUtil
2021-03-16 01:34:17 +08:00
update to build 389 add various global functions
2021-03-18 16:36:28 +08:00
## v2.2.11
update to build 385 add CQObject for CQ add after-stop action(set terminal level 0) update global.php modules, add http_proxy_server add MessageUtil.php for message parsing add RouteManager::addStaticFileRoute() for quick handling static file finish onTask function finally!! add TaskManager::runTask()
2021-03-15 02:54:16 +08:00
> 更新时间：2021.3.13
- 新增：内部 ID 版本号（ZM_VERSION_ID）
- 优化：启动时 log 的等级
- 移除：终端输入命令
- 修复：纯 HTTP 服务器的启动 bug
- 新增：`zm_timer` 的报错处理，防止服务器直接崩掉
update docs
2021-03-08 00:56:35 +08:00
## v2.2.10
> 更新时间：2021.3.8
- 新增：用户态 php 编译脚本 `build-runtime.sh`
- 移除：无用的调试信息
- 新增：`--show-php-ver` 启动参数
update to 2.2.9 version update reply() to support quick operation fix reload bug fix reply() bug
2021-03-06 17:22:42 +08:00
## v2.2.9
> 更新时间：2021.3.6
- 更新：`reply()` 方法传入数组则变为快速相应的 API 操作
- 修复：在 Worker 进程下调用 `ZMUtil::reload()` 会导致一些奇怪的 bug
- 修复：`reply()` 时会 at 私聊成员的 bug（由 go-cqhttp 导致）
update to 2.2.8 version update motd message
2021-03-02 21:24:31 +08:00
## v2.2.8
> 更新时间：2021.3.2
- 更新：MOTD 显示的方式，更加直观和炫酷
update to 2.2.7 version fix reply() bug fix access_token bug
2021-02-27 16:19:18 +08:00
## v2.2.7
> 更新时间：2021.2.27
- 修复：2.2.6 版本下 `reply()` 方法在群里调用会 at 成员的 bug
- 修复：空 `access_token` 的情况下会无法连入的 bug
- 修复：使用 Closure 闭包函数自行编写逻辑的判断返回 false 无法阻断连接的 bug
## v2.2.6
> 更新时间：2021.2.26
- 新增：`uuidgen()` 全局函数，快速生成 uuid
- 修复：MySQL `rawQuery()` 在参数为非数组时会报 Warning 的 bug
- 新增：示例模块的 API 示例：一言查询
- 优化：删减部分无用代码
- 更改：`ctx()->reply()` 方法改为调用隐藏方法：`.handle_quick_operation`
- 修复：`ctx()->finalReply()` 一直以来的 bug（未阻断事件）
- 新增：`access_token` 配置项支持闭包函数自行设计判断方式和逻辑
- 新增：全局函数 `working_dir()`
commitment, nothing
2021-02-21 22:17:34 +08:00
## v2.2.5
> 更新时间：2021.2.20
- 新增：`saveToJson()` 和 `loadFromJson()` 方法（DataProvider 类）
- 修复：`@OnSave` 注解事件无法工作的 bug
- 调整：自定义计时器创建时的性能调优
- 新增：WorkerCache 方法：`hasKey()`
- 新增：SpinLock 方法：`transaction()`（直接在事务中上锁）
- 新增：CQ 方法：`getAllCQ()`，`_custom()`（获取消息中的所有 CQ 码）
- 修复：CQ 类中的部分 bug
update docs
2021-02-07 11:48:55 +08:00
## v2.2.4
commitment, nothing
2021-02-21 22:17:34 +08:00
> 更新时间：2021.2.7
update docs
2021-02-07 11:48:55 +08:00
- 修复：终端交互导致的 ssh 断掉后 CPU 占用过高的问题
- 修复：WorkerCache 在缺少配置文件下工作异常的问题
- 新增：全局函数：`zm_atomic()`
update to 2.2.3 version, I am tired fix access_token not working fix waitMessage() not working in v2.2.2
2021-01-30 00:06:42 +08:00
## v2.2.3
> 更新时间：2021.1.30
- 修复：waitMessage() 在 v2.2.2 版本中不可用的 bug
- 修复：access_token 无效的问题
update to 2.2.2 version finally clean redundant code fix API reply in @OnTick for multi-process fix loop error reporting
2021-01-29 23:34:34 +08:00
## v2.2.2
> 更新时间：2021.1.29
- 修复：模块文件错误时避免循环报错
- 优化：代码结构
- 修复：在不同进程时调用机器人 API 无法返回且报错的 bug
- **修复：机器人无法连接的问题（2.1.6 ~ 2.2.1 受影响）**
update docs
2021-01-29 21:37:02 +08:00
## v2.2.1
> 更新时间：2021.1.29
- 修复：配置文件兼容性问题
update Hello.php update docs
2021-01-29 21:30:19 +08:00
## v2.2.0
> 更新时间：2021.1.29
- 新增：`@OnPipeMessageEvent` 注解
- 新增：进程管理器
- 新增：`--daemon` 守护进程化后查看状态以及一系列操作的命令行
- 新增：WorkerCache
- 修复：路由问题
- 修复：`http_header` 配置项不生效的 bug
- 优化：框架内部所有异常全部基于 `ZMException`
- 优化：SingletonTrait 支持扩展
update docs
2021-01-18 18:09:33 +08:00
## v2.1.6
> 更新时间：2021.1.18
- 优化：代码结构
- 增加：更多提示语
- 修复：处理空格消息时的报错
- 修复：上下文的bug
update docs
2021-01-13 15:46:55 +08:00
## v2.1.5
> 更新时间：2021.1.13
- 优化：终端对 PHP Warning 和 PHP Notice 的报错信息显示，统一格式
- 新增：`ctx()->getNumArg()` 上下文中快速获取数字类型的参数的方法
- 优化：删除不必要的调试信息
- 优化：路由组件全面替换为 `symfony/routing`，兼容性和稳定性 up！
add InterruptException catcher to onRequest
2021-01-04 01:35:54 +08:00
## v2.1.4
> 更新时间：2021.1.3
- 修复：启动时会提示丢失类的 bug
- 优化：HTTP 响应类如果被使用了则一律返回 false
- 优化：PHP Warning 等报错统一样式
update to 2.1.3 version fix an AnnotationParser bug which is stupid
2021-01-02 16:36:25 +08:00
## v2.1.3
> 更新时间：2021.1.2
- 修复：注解解析器在某种特殊情况下导致的 bug
## v2.1.2
> 更新时间：2021.1.2
- 修复：引入包模式启动时会导致的满屏报错
## v2.1.1
> 更新时间：2021.1.2
- 修复：自定义加载注解选定 composer.json 文件错误的 bug
## v2.1.0
> 更新时间：2021.1.2
- 新增：`@OnOpenEvent`，`@OnCloseEvent`，`@OnMessageEvent`，`@OnRequestEvent`
- 优化事件分发器，修复一些事件分发过程中的 bug
- 修复 `@CQBefore` 事件的 bug
update to 2.0.3 version
2020-12-31 16:26:51 +08:00
## v2.0.3
update to 2.1.3 version fix an AnnotationParser bug which is stupid
2021-01-02 16:36:25 +08:00
> 更新时间：2020.12.31
update to 2.0.3 version
2020-12-31 16:26:51 +08:00
- 修复：CQBefore 注解事件在 level 低于 200 时无法调用的 bug
- 修复：CQMetaEvent 注解事件调用时报错的 bug
## v2.0.2
> 更新时间：2020.12.31
- 更新：将 CQ 码调用类更新到与最新 OneBot 标准相兼容的状态
update docs
2020-12-23 16:20:35 +08:00
## v2.0.1
update to 2.0.3 version
2020-12-31 16:26:51 +08:00
> 更新时间：2020.12.23
update docs
2020-12-23 16:20:35 +08:00
- 修复：开屏报错文件夹不存在
update docs
2020-12-23 16:14:59 +08:00
## v2.0
> 更新时间：2020.12.23
已发布正式版。
Reference in New Issue Copy Permalink