zhamao-framework é uma estrutura de desenvolvimento de chatbot + servidor web de alto desempenho
Grupo QQ do desenvolvedor: 670821194 Clique para entrar no bate-papo em grupo
Se houver desenvolvedores dispostos a trabalhar juntos para desenvolver o próprio framework, envie um PR ou Issue para participar do desenvolvimento! Se você tiver ideias melhores sobre o design central da estrutura em si, poderá formar uma equipe de desenvolvimento com o autor (atualmente apenas 2 pessoas) para participar do desenvolvimento do ecossistema OneBot V12 e da própria estrutura.
Consulte a coluna Projetos para tarefas de versão em andamento relacionadas!
A estrutura Zhamao é escrita em PHP e é orientada principalmente para serviços API e robôs de chat. Inclui Websocket, HTTP e outras bibliotecas de monitoramento e solicitação. O código do usuário é modularizado e várias funções podem ser facilmente escritas usando anotações.
O objetivo principal da estrutura é o servidor HTTP e a estrutura de construção de robôs. Especialmente para processamento de mensagens de chatbot, é mais conveniente e abrangente. Ele fornece vários mecanismos de conversação e mecanismos de chamada interna, e você pode criar seus próprios plug-ins de várias maneiras.
#[BotCommand('Hello')]public function hello(BotContext $ctx) { $ctx->reply("Olá, sou Zha Mao!" // Resposta imperativa simples}); #[Route('/index')]public function index() { return "<h1>hello!</h1>" // Desenvolvimento rápido de serviço HTTP};
A estrutura atualmente oferece suporte à operação direta em ambientes Linux, WSL, macOS e Windows. Para ambientes Linux e macOS, você pode usar diretamente o script de instalação com um clique abaixo.
Se desejar instalar e implantar em outros ambientes, você pode usar o Docker para implantar rapidamente ou instalar manualmente o ambiente e, em seguida, instalar a estrutura.
# Linux, macOS próximo clique para detectar o ambiente PHP e instalar o framework bash <(curl -fsSL https://zhamao.xin/v3.sh)# Inicie o framework cd zhamao-v3 ./servidor zhamao
O script de instalação com um clique também permite personalizar parâmetros, como:
# O script detectará o PHP do sistema por padrão. Se você quiser pular a detecção diretamente e instalar uma versão independente do PHP, adicione esta variável de ambiente export ZM_NO_LOCAL_PHP="yes" # Se o script instalar uma versão independente do PHP, a versão padrão. é 8.1. Se você quiser usar outra versão, adicione esta variável de ambiente para especificar a versão export ZM_DOWN_PHP_VERSION="8.2"# Por padrão, o script armazenará o `zhamao-app` do framework no diretório atual. Diretório para instalação. Se você quiser usar outro diretório, adicione esta variável de ambiente export ZM_CUSTOM_DIR="my-custom-app"# O script usará a imagem de aceleração doméstica do Alibaba Cloud para este projeto por padrão. source, adicione esta variável de ambiente export ZM_COMPOSER_PACKAGIST="yes"# Depois de executar as variáveis de ambiente anteriores e executar o script de instalação com um clique, você pode implementar parâmetros personalizados! bash <(curl -fsSL https://zhamao.xin/v3.sh)
Consulte a documentação para métodos de instalação alternativos.
Veja o documento (construído na China): https://framework.zhamao.xin/
Link alternativo (hospedagem estrangeira): https://framework.zhamao.me/
Suporte nativo para vários clientes de robôs se conectarem simultaneamente
Mecanismo flexível de vinculação de eventos de anotação, que pode usar anotações de anotação e atributos nativos ao mesmo tempo
Um sistema de plug-ins completo, os plug-ins podem ser escritos e empacotados ou distribuídos para uso por terceiros.
Escrito em formato de plug-in, ele pode ser combinado livremente com outros componentes do Composer ou pode ser escrito em um único arquivo para processamento.
Suporta empacotamento de módulos e carregamento a quente, tornando mais conveniente compartilhar módulos
Residentes na memória, as variáveis de cache globais podem ser usadas em qualquer lugar, fornecendo uma variedade de soluções de cache
Vem com MySQL, SQLite, Redis e outros pools de conexão de banco de dados
É um servidor HTTP e um servidor WebSocket, e você pode construir sua própria interface API HTTP.
Ambiente PHP integrado opcional, sem necessidade de compilar e instalar manualmente, por crazywhalecc/static-php-cli
Se você encontrar algum problema durante o uso, você mesmo pode enviar um Issue ou Fork, modificá-lo e enviar um Pull Request.
Atualmente o projeto é mantido por apenas duas pessoas, o que consome muita energia, por isso contribuições para o framework são muito bem-vindas.
Este projeto foi desenvolvido no tempo livre do autor. Se você achar útil, você pode fazer uma doação. Sua doação me dará mais motivação para melhorar o plug-in.
Usaremos os fundos doados para as despesas do servidor do Explosive Bot e da documentação da estrutura impulsionada por este projeto. Lista de doações
Se não quiser participar diretamente do desenvolvimento do framework, você também pode compartilhar os módulos que escreveu para ajudar a melhorar o ecossistema do framework.
A estrutura e o SDK são as principais partes de código aberto do projeto Explosive Robot. O Robô Explosivo é um robô de alto desempenho escrito pelo autor, que ganhou o primeiro prêmio no Concurso Nacional de Design de Computação.
O robô explosivo do autor funciona de forma estável há cinco anos desde o início de 2018 e continua a iterar.
Você pode enviar um problema ou ingressar no grupo (670821194) para solução de problemas.
Ao atualizar o conteúdo deste projeto, preste atenção às atualizações do GitHub em tempo hábil. Faça backup de seus plug-ins ou códigos de projeto antes de atualizar.
A estrutura do projeto é de código aberto usando o protocolo Apache-2.0, e o protocolo deve ser seguido ao distribuí-lo ou reescrevê-lo e modificá-lo. A parte do plug-in do projeto (outras pastas além src/Globals
e src/ZM
) pode ser distribuída e modificada sem estar em conformidade com o protocolo Apache-2.0 (declaração de direitos autorais) quando não faz referência ao código dentro da estrutura.
Nota : Quando você usa software de robô com protocolo AGPL-3.0
como mirai, para se conectar à estrutura, o uso desta estrutura exige que você redistribua as partes que você escreveu ou modificou usando AGPL-3.0
.
Ao contribuir com código, mantenha as informações confidenciais em seu arquivo de configuração global seguras e não carregue arquivos de configuração com informações pessoais em sites como o GitHub.
Agradecemos à JetBrains por fornecer suporte à ferramenta de desenvolvimento PhpStorm para este projeto de código aberto:
Obrigado ao desenvolvedor @sunxyw por algumas sugestões para padronizar o desenvolvimento de projetos.