zhamao framework
3.2.5
zhamao-framework es un marco de desarrollo de servidor web y robot de chat de alto rendimiento
Grupo QQ para desarrolladores: 670821194 Haga clic para unirse al chat grupal
Si hay desarrolladores que estén dispuestos a trabajar juntos para desarrollar el marco en sí, envíe un PR o un problema para participar en el desarrollo. Si tiene mejores ideas sobre el diseño central del marco en sí, puede configurar un equipo de desarrollo con el autor (actualmente solo 2 personas) para participar en el desarrollo del ecosistema OneBot V12 y el marco en sí.
¡Consulte la columna Proyectos para conocer las tareas de versión en curso relacionadas!
El marco Zhamao está escrito en PHP y está orientado principalmente a servicios API y robots de chat. Incluye Websocket, HTTP y otras bibliotecas de monitoreo y solicitud. El código de usuario está modularizado y se pueden escribir fácilmente varias funciones mediante anotaciones.
El objetivo principal del marco es el servidor HTTP y el marco de construcción de robots. Especialmente para el procesamiento de mensajes de chatbot, es más conveniente y completo. Proporciona numerosos mecanismos de conversación y mecanismos de llamadas internas, y puede diseñar sus propios complementos de varias maneras.
#[BotCommand('Hola')]public function hola(BotContext $ctx) { $ctx->reply("¡Hola, soy Zha Mao!"); // Respuesta imperativa simple}
#[Route('/index')]public function index() { return "<h1>¡hola!</h1>" // Desarrollo rápido del servicio HTTP};Actualmente, el marco admite la operación directa en entornos Linux, WSL, macOS y Windows. Para entornos Linux y macOS, puede utilizar directamente el siguiente script de instalación con un solo clic.
Si desea instalar e implementar en otros entornos, puede utilizar la implementación rápida de Docker o instalar manualmente el entorno y luego instalar el marco. Consulte la documentación para obtener más detalles.
# Linux, macOS, luego haga clic para detectar el entorno PHP e instalar el marco bash <(curl -fsSL https://zhamao.xin/v3.sh)# Inicie el marco cd zhamao-v3 ./servidor zhamao
El script de instalación con un solo clic también le permite personalizar parámetros, como:
# El script detectará el PHP del sistema de forma predeterminada. Si desea omitir la detección directamente e instalar una versión de PHP independiente, agregue esta variable de entorno export ZM_NO_LOCAL_PHP="yes" # Si el script instala una versión independiente de PHP, la versión predeterminada. es 8.1. Si desea utilizar otra versión, agregue esta variable de entorno para especificar la versión export ZM_DOWN_PHP_VERSION="8.2"# De forma predeterminada, el script almacenará la `zhamao-app` del marco en el directorio actual. Directorio para la instalación Si desea utilizar otro directorio, agregue esta variable de entorno export ZM_CUSTOM_DIR="my-custom-app"# El script utilizará la imagen de aceleración nacional de Alibaba Cloud para este proyecto de forma predeterminada. fuente, agregue esta variable de entorno export ZM_COMPOSER_PACKAGIST="yes"# Después de ejecutar las variables de entorno anteriores y luego ejecutar el script de instalación con un solo clic, ¡puede implementar parámetros personalizados! bash <(curl -fsSL https://zhamao.xin/v3.sh)
Consulte la documentación para conocer métodos de instalación alternativos.
Ver el documento (construcción propia en China): https://framework.zhamao.xin/
Enlace alternativo (alojamiento extranjero): https://framework.zhamao.me/
Soporte nativo para que múltiples clientes robot se conecten simultáneamente
Mecanismo de vinculación de eventos de anotación flexible, que puede utilizar anotaciones de anotaciones y atributos nativos al mismo tiempo.
Un sistema de complementos completo, los complementos se pueden escribir, empaquetar o distribuir para que otros los utilicen.
Escrito en un formato de complemento, se puede combinar libremente con otros componentes de Composer o se puede escribir en un solo archivo para procesarlo.
Admite empaquetado de módulos y carga en caliente, lo que hace que compartir módulos sea más conveniente
Residentes en la memoria, las variables de caché global se pueden utilizar en todas partes, lo que proporciona una variedad de soluciones de almacenamiento en caché.
Viene con MySQL, SQLite, Redis y otros grupos de conexiones de bases de datos
Es un servidor HTTP y un servidor WebSocket, y puede crear su propia interfaz API HTTP.
Entorno PHP integrado opcional, sin necesidad de compilar e instalar manualmente, mediante crazywhalecc/static-php-cli
Si encuentra algún problema durante el uso, puede enviar un problema o bifurcarlo usted mismo, modificarlo y enviar una solicitud de extracción.
Actualmente, el proyecto lo mantienen solo dos personas, lo que consume mucha energía, por lo que las contribuciones al marco son muy bienvenidas.
Este proyecto se desarrolló en el tiempo libre del autor. Si lo encuentra útil, puede hacer una donación. Su donación me dará más motivación para mejorar el complemento.
Usaremos los fondos donados para los gastos del servidor del Explosive Bot y la documentación del marco impulsada por este proyecto. Lista de donaciones
Si no desea participar directamente en el desarrollo del marco, también puede compartir los módulos que escribió para ayudar a mejorar el ecosistema del marco.
El marco y el SDK son las partes principales de código abierto del proyecto Explosive Robot. El Robot Explosivo es un robot de alto rendimiento escrito por el autor, que ganó el primer premio en el Concurso Nacional de Diseño Informático.
El robot explosivo del autor ha estado funcionando de manera estable durante cinco años desde principios de 2018 y continúa iterando.
Puede enviar un problema o unirse al grupo (670821194) para solucionar problemas.
Al actualizar el contenido de este proyecto, preste atención a las actualizaciones de GitHub de manera oportuna. Haga una copia de seguridad de sus complementos o códigos de proyecto antes de actualizar.
El marco del proyecto es de código abierto y utiliza el protocolo Apache-2.0, y se debe seguir el protocolo al distribuirlo o reescribirlo y modificarlo. La parte del complemento del proyecto (carpetas distintas de src/Globals y src/ZM ) se pueden distribuir y modificar sin cumplir con el protocolo Apache-2.0 (declaración de derechos de autor) cuando no se hace referencia al código dentro del marco.
Nota : Cuando utiliza software de robot con protocolo AGPL-3.0 como mirai, para conectarse al marco, el uso de este marco requiere que redistribuya las partes que escribió o modificó utilizando AGPL-3.0 .
Al contribuir con código, mantenga segura la información confidencial en su archivo de configuración global y no cargue archivos de configuración con información personal en sitios web como GitHub.
Gracias a JetBrains por brindar soporte a la herramienta de desarrollo PhpStorm para este proyecto de código abierto:
Gracias al desarrollador @sunxyw por algunas sugerencias para estandarizar el desarrollo de proyectos.
