MiraiTravel 是一个运行于 PHP 环境的 功能强大的多平台机器人框架
纪念第一个兼容的平台 : Mirai 特命名 MiraiTravel
MiraiTravel 致力于开发一个高效方便的PHP多平台高兼容性的机器人框架。
GithubPage : https://mr-xiexuan.github.io/MiraiTravel/
公告发布页 : https://mr-xiexuan.github.io/MiraiTravel/announcement/
- 安装配置简单 可以通过控制台使用命令行进行 MiraiTravel 的配置。
- 兼容性强 可以在任何装有 PHP 的机器上运行，除了PHP,没有其他任何其他不必要的依赖。
- 账号分离 可以在一个 MiraiTravel 中实现分离管理多个账号。
- 多平台 可以在使用操控各平台,并且可以简单方便的做到互相调用。
- 多入口 有 MiraiTravel 控制台入口 和 Webhook 入口。
- 易于开发 可以开发脚本来实现自己想实现的功能。
- 开发隔离 多命名空间隔离 定义函数或变量不会出现重复导致干扰的问题。
- 稳定 发现组件或者脚本出现异常会取消组件或者脚本的实例化。
- 全开源 该项目全由PHP编写，由于PHP的特殊性 所以开发时你可以看到程序的所有源代码 哪怕没有文档也可快速开发。
- 多平台可一致性 规定了统一的接口,不同平台的脚本可以很方便的迁移与转换。
运行 php MiraiTravel.php 即可启动 MiraiTravel。
启动后使用命令 Help 可以获取帮助。
伪静态配置文件为 .htaccess 请按需获取你HttpServer的配置。
有关伪静态的配置请参考 伪静态配置。
由于部分功能需要使用到伪静态,所以请务必开启伪静态,否则可能会出现一些问题。
- core MiraiTravel核心文件
- data 运行时的数据存储文件
- logs 运行日志文件
- apter 适配器安装路径
- plugins 插件安装路径
- script 用户脚本文件
- docs 文档
交流群 : 604568448
本项目是一个开源项目,我们欢迎任何人参与到本项目的开发中来。
如果你有任何问题或者建议,欢迎在 Issues 中提出。
如果你想参与到本项目的开发中来,欢迎在 Pull requests 中提交你的代码。
如果你在使用本项目的过程中遇到了任何问题,欢迎在 Discussions 中提出。
如果你对本项目感兴趣,欢迎加入我们的交流群,我们会在群中进行一些讨论。
该项目与 MiraiEz 为兄弟项目。
本项目与MiraiEz的区别如下。
| 功能与特性 | MiraiTravel | MiraiEz |
|---|---|---|
| 开发机制 | 开发每个QQ独立的脚本 | 开发通用的插件 |
| API函数实现 | 类方法 | 全局函数 |
| 是否有命名空间 | 是 | 否 |
| 命令注册 | 插件可注册,脚本不必要注册 | 可注册 |
| 插件 | 由脚本进行变种 | 原生开发方向 |
| 调试反馈机制 | 日志 | QQ消息反馈与日志 |
| 插件致命错误错误方式 | 取消插件载入 | 程序终止运行 |
| 基本配置方式 | 控制台命令配置 | 修改PHP文件配置 |
| 多QQ的处理 | 通过不同的脚本处理不同的QQ | 由插件判断 |
致谢 Aber 为本项目绘制了一个可爱的LOGO。
PhpStorm IDE 是一个在各个方面都最大程度地提高开发人员的生产力的 IDE, WebStorm 的所有特性都包含在 PhpStorm 中，并在此基础上增加了对PHP和数据库/SQL的全面支持。
特别感谢 JetBrains 为本项目提供免费的 PhpStorm IDE 等 IDE 的授权 。
特别感谢 vscode 提供了一款开源好用的 IDE , 本项目大部分代码都是在 vscode 中编写的。VScode 拥有丰富的插件,给开发带来了很大的便利。
特别感谢 Github 提供了一个开源的代码托管平台,让我们可以在这里分享和交流代码。
特别感谢 GitKraken GitKraken 是一个免费的跨平台GUI Git客户端，可用于版本控制系统（包括GitHub,Bitbucket,GitLab等）。它旨在通过为你提供直观的UI,任务跟踪,内置代码编辑器,合并冲突编辑器以及对与其他平台集成的支持,使你成为富有生产力的Git用户。
