关于 3.0 都干了啥这件事

[sunxyw]

这里谈论的是（暂定）炸毛框架 3.0 版本相较 2.X 版本的变更，这里只会谈论对于用户而言改变的部分，换言之，内部实现的变更不包括在内。
变更包括了行为变更（参数改变、返回值改变等）、新增功能、弃用功能等。
然后呢，因为我比较懒，所以这里可能写的不全，如果你发现有些变更漏掉了，也欢迎你在此留言。
当然，如果你有一些新功能的想法，也可以在这里提出。

这里是简纲：

• 支持 OneBot 12 协议
• 兼容单进程模式
• 中间件可以用闭包回调写了，不再需要单独的类啦
• 现在很好地支持 Go-CQHttp 以外的实现
• 新增了 segment($type, $data) 全局方法，用于生成消息段
• 内置了抽象的连接池，方便大家快速实现自己的连接池（我们有内置 MySQL、SQLite3 和 Redis 池哦）
• 加了数据库助手函数（忘记是什么了，过会改）
• 数据库连接池可以连接多个库了
• 中间件支持 Pipeline 写法了
• 加了类别名的功能，使用注解更方便啦
• 改进了 Windows 开发的体验
• 可以根据环境来加载特定配置文件（--env）
• 可以查看配置项来自哪里
• 新增了 IoC 容器和依赖注入，让你的代码更加优雅^^
• 新的 CommandArgument 注解，快速创建命令&解析参数
• 重新设计了 ZMConfig
• 修复了 explode_msg 传入参数为 0 时，参数0消失的 BUG
• 改进了安装命令和其他命令，更加好看了（
• 修复了配置被重写的 BUG
• 集成了 REPL (PsySH) 让调试更方便
• 修复了 FileSystem::isRelativePath 在 Windows 下判断错误的 BUG
• 改进了框架内部异常，更精细
• 移除了若干弃用的全局函数
• 使用 zhamao/logger 作为默认日志记录器，并替代了 zhamao/console
• 现在底层基于 php-libonebot
• 增加了开箱即用的 Docker Compose 支持，开发和部署更方便啦
• 迁移到了 Symfony Console V6
• 重新设计插件编写和加载模式，采用独立的文件夹、项目库，支持了单文件插件，避免写代码前摇过长

[sunxyw]

增加了开箱即用的 Docker Compose 支持，开发和部署更方便啦

咱给框架内置了 Docker Compose 的相关配置，只需要执行 vendor/bin/zhamao init --docker 就可以啦
包含了 docker-compose.yml 以及 docker 目录，目录中包含了构建镜像需要的文件。

目前包含了以下容器：

• 项目主容器（包含炸毛项目，也就是你的项目运行的地方，好像是 Ubuntu 系统来着，安装了大部分常用的扩展）
• 实现端容器（目前内置的是 Walle-Q，因为目前似乎只有它支持 OneBot12 协议，有需要的话会考虑集成更多实现）
• PostgreSQL（热门的数据库，虽然目前炸毛好像还不支持）
• Redis（不用多解释了吧，不管是缓存还是什么都很好用）
• 两个数据库管理工具（Adminer 和 Redis Insight）

发布配置的时候会自动帮你生成相关的数据库信息，可以到 docker/environment.env 中查看。

一般来说，主要用到的操作如下：

$ docker compose up -d # 启动
$ docker compose down # 停止
$ docker compose restart bot # 重启炸毛容器

首次启动后，记得去 docker/volumes/walle-q-data 修改相关配置并重启，具体可以参考 Walle-Q 的安装文档。

需要扫码的话可以打开 docker/volumes/walle-q-data/qrcode.png，或者直接查看 walle-q 容器的日志输出。

已知问题

• Walle Q 下载有毛病：我不知道啊，我也不到为什么啊，正式发布前应该会修好吧（希望）

[sunxyw]

移除了在 2.7.3 (build 453) 弃用的一系列全局函数

*单纯的更名使用 🏷️ 标记。行为变更使用 🪄 标记。重大改动使用 💣 标记。
具体改动：

• 🪄 zm_sleep($s = 1): bool -> zm_sleep(int $seconds = 1): void
  • 注意 zm_sleep 现在没有返回值了哦。
• 🪄 explodeMsg($msg, $ban_comma = false): array -> explode_msg(string $msg, array $includes = [' ', "\t"]): array
• 🏷️ getClassPath($class_name) -> get_class_path(string $class_name): ?string
• 🏷️ matchPattern($pattern, $context): bool -> match_pattern(string $pattern, string $subject): bool
• 🏷️ matchArgs($pattern, $context) -> match_args(string $pattern, string $subject)
• 🏷️ connectIs($type): bool -> current_connection_is(string $type): bool
  • connectIsQQ() 和 connectIsDefault() 也请使用 current_connection_is('qq') 和 current_connection_is('default') 替代。
• 🏷️ getAnnotations(): array -> get_annotations(): array
• 🏷️ onebot_target_id_name($message_type): string -> get_onebot_target_id_name(string $message_type): string
• 🏷️ zm_data_hash($v): string -> hash_message(array $message): string
• 🏷️ getAllFdByConnectType(string $type = 'default'): array -> get_all_fd_of_type(string $type = 'default'): array

[sunxyw]

迁移到了 Symfony Console V6

我们还加了个 ZM\Command\Command 抽象类来方便自定义命令的开发。

简单来说，3.0 的自定义命令会是以下格式的：

#[AsCommand(name: 'command:name', description: 'Command Desc')]
class CommandName extends Command
{
    protected function configure()
    {
        $this->setHelp('Help Info');
        $this->addOption(...);
    }

    public function handle(): int
    {
        // do something
        return self::SUCCESS;
    }
}

Command 类还内置了多个常用的方法。
获取 input 可以使用 $this->input，同理 output 是 $this->output。
info error comment question detail 是不同类型的输出方法，会按照预设的样式输出对应内容。
另外还有一个 section 方法，会自动调用 Symfony Console V6 新出的 section 方法。