Project Icon

zhamao-framework

PHP开发的多功能聊天机器人与Web服务框架

炸毛框架是一个基于PHP的开发框架,专注于API服务和聊天机器人开发。框架支持WebSocket和HTTP协议,采用模块化和注解方式,便于功能开发。它提供插件系统、多机器人客户端支持和数据库连接池等特性,适用于构建聊天机器人和Web服务。框架的设计简洁高效,为开发者提供便捷和灵活的开发体验。

炸毛框架

炸毛框架

炸毛框架 (zhamao-framework) 是一个高性能的聊天机器人 + Web 服务器开发框架

OneBot Integration Test 下载数 最新版本 开源协议 TODO

开发者 QQ 群:670821194 点击加入群聊

如果有愿意一起开发框架本身的开发者,请提出 PR 或 Issue 参与开发!如果对框架本身的核心设计有更好的想法,可与作者成立开发组(目前仅 2 人),参与 OneBot V12 生态和框架本身的开发。

相关正在进行的版本任务见 Projects 一栏!

简介

炸毛框架使用 PHP 编写,主要面向 API 服务,聊天机器人,包含 Websocket、HTTP 等监听和请求库,用户代码采用模块化处理,使用注解可以方便地编写各类功能。

框架主要用途为 HTTP 服务器,机器人搭建框架。尤其对于聊天机器人消息处理较为方便和全面,提供了众多会话机制和内部调用机制,可以以各种方式设计你自己的插件。

#[\BotCommand('你好')]
public function hello(\BotContext $ctx) {
  $ctx->reply("你好,我是炸毛!"); // 简单的命令式回复
}
#[\Route('/index')]
public function index() {
  return "<h1>hello!</h1>"; // 快速的 HTTP 服务开发
}

开始

框架目前支持 Linux、WSL、macOS、Windows 环境直接运行,其中 Linux、macOS 环境可直接使用下方一键安装脚本。

如果你想在其他环境安装部署,可使用 Docker 快速部署或手动安装环境后安装框架,详见文档。

# Linux、macOS 下一键检测 PHP 环境、安装框架
bash <(curl -fsSL https://zhamao.xin/v3.sh)

# 启动框架
cd zhamao-v3
./zhamao server

一键安装脚本还有可以自定义参数的方式,比如:

# 脚本默认会检测系统的PHP,如果想直接跳过检测,安装独立的PHP版本,则添加此环境变量
export ZM_NO_LOCAL_PHP="yes"
# 脚本如果安装独立版本PHP,默认版本为8.1,如果想使用其他版本,则添加此环境变量指定版本
export ZM_DOWN_PHP_VERSION="8.2"
# 脚本默认会将框架在当前目录下的 `zhamao-app` 目录进行安装,如果想使用其他目录,则添加此环境变量
export ZM_CUSTOM_DIR="my-custom-app"
# 脚本默认会对本项目使用阿里云国内加速镜像,如果想使用packagist源,则添加此环境变量
export ZM_COMPOSER_PACKAGIST="yes"
# 执行完前面的环境变量再执行一键安装脚本,就可以实现自定义参数!
bash <(curl -fsSL https://zhamao.xin/v3.sh)

关于其他安装方式,请参阅 文档

文档

查看文档(国内自建):https://framework.zhamao.xin/

备用链接(国外托管):https://framework.zhamao.me/

特点

  • 原生支持多个机器人客户端同时连接
  • 灵活的注解事件绑定机制,可同时使用 Annotation 和原生 Attribute 注解
  • 完善的插件系统,可编写插件后打包或分发,供他人使用
  • 采用插件化编写,可自由搭配其他 Composer 组件,也可单文件面向过程编写
  • 支持模块打包、热加载,分享模块更方便
  • 常驻内存,全局缓存变量随处使用,提供多种缓存方案
  • 自带 MySQL、SQLite、Redis 等数据库连接池
  • 本身为 HTTP 服务器、WebSocket 服务器,可以构建属于自己的 HTTP API 接口
  • 可选自带 PHP 环境,无需手动编译安装,by crazywhalecc/static-php-cli

贡献和捐赠

如果你在使用过程中发现任何问题,可以提交 Issue 或自行 Fork 后修改并提交 Pull Request。

目前项目仅两人维护,耗费精力较大,所以非常欢迎对框架的贡献。

本项目为作者闲暇时间开发,如果觉得好用,不妨进行捐助~你的捐助会让我更加有动力完善插件,感谢你的支持!

我们会将捐赠的资金用于本项目驱动的炸毛机器人和框架文档的服务器开销上。捐赠列表

如果您不想直接参与框架的开发,也可以分享你编写的模块,帮助完善框架生态。

支付宝

支付宝二维码

关于

框架和 SDK 是 炸毛机器人 项目的核心框架开源部分。炸毛机器人是作者写的一个高性能机器人,曾获全国计算机设计大赛一等奖。

作者的炸毛机器人已从2018年初起稳定运行了五年,并且持续迭代。

可以提交 Issue加群(670821194) 进行疑难解答。

本项目在更新内容时,请及时关注 GitHub 动态,更新前请将自己的插件或项目代码做好备份。

项目框架采用 Apache-2.0 协议开源,在分发或重写修改等操作时需遵守协议。项目插件部分(除 src/Globalssrc/ZM 文件夹外的其他文件夹) 在非借鉴框架内代码时可不遵守 Apache-2.0 协议进行分发和修改(声明版权)。

注意:在你使用 mirai 等 AGPL-3.0 协议的机器人软件与框架连接时,使用本框架需要将你编写或修改的部分使用 AGPL-3.0 协议重新分发。

在贡献代码时,请保管好自己的全局配置文件中的敏感信息,请勿将带有个人信息的配置文件上传 GitHub 等网站。

感谢 JetBrains 为此开源项目提供 PhpStorm 开发工具支持:

感谢开发者 @sunxyw 中为项目开发规范化提出的一些建议。

star

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号