zhamao framework
3.2.5
Zhamao-Framework ist ein leistungsstarkes Chat-Roboter- und Webserver-Entwicklungsframework
Entwickler-QQ-Gruppe: 670821194 Klicken Sie hier, um dem Gruppenchat beizutreten
Wenn es Entwickler gibt, die bereit sind, bei der Entwicklung des Frameworks selbst zusammenzuarbeiten, reichen Sie bitte eine PR oder ein Problem ein, um an der Entwicklung teilzunehmen! Wenn Sie bessere Vorstellungen vom Kerndesign des Frameworks selbst haben, können Sie mit dem Autor ein Entwicklungsteam (derzeit nur 2 Personen) zusammenstellen, das an der Entwicklung des OneBot V12-Ökosystems und des Frameworks selbst beteiligt ist.
Weitere laufende Versionsaufgaben finden Sie in der Spalte „Projekte“!
Das Zhamao-Framework ist in PHP geschrieben und hauptsächlich auf API-Dienste und Chat-Robots ausgerichtet. Es umfasst Websocket, HTTP und andere Überwachungs- und Anforderungsbibliotheken. Der Benutzercode ist modularisiert und verschiedene Funktionen können einfach mithilfe von Anmerkungen geschrieben werden.
Der Hauptzweck des Frameworks ist der Aufbau eines HTTP-Servers und eines Roboter-Frameworks. Insbesondere für die Verarbeitung von Chatbot-Nachrichten ist es bequemer und umfassender. Es bietet zahlreiche Konversationsmechanismen und interne Anrufmechanismen, und Sie können Ihre eigenen Plug-Ins auf verschiedene Arten entwerfen.
#[BotCommand('Hello')]public function hello(BotContext $ctx) { $ctx->reply("Hallo, ich bin Zha Mao!" // Einfache imperative Antwort}
#[Route('/index')]public function index() { return "<h1>hello!</h1>" // Schnelle HTTP-Dienstentwicklung}Das Framework unterstützt derzeit den direkten Betrieb in Linux-, WSL-, macOS- und Windows-Umgebungen. Für Linux- und macOS-Umgebungen können Sie das unten stehende Ein-Klick-Installationsskript direkt verwenden.
Wenn Sie in anderen Umgebungen installieren und bereitstellen möchten, können Sie die Docker-Schnellbereitstellung verwenden oder die Umgebung manuell installieren und dann das Framework installieren. Weitere Informationen finden Sie in der Dokumentation.
# Klicken Sie als nächstes auf Linux, macOS, um die PHP-Umgebung zu erkennen und das Framework bash zu installieren <(curl -fsSL https://zhamao.xin/v3.sh)# Starten Sie die Framework-CD zhamao-v3 ./zhamao-Server
Mit dem Ein-Klick-Installationsskript können Sie auch Parameter anpassen, wie zum Beispiel:
# Das Skript erkennt standardmäßig das PHP des Systems. Wenn Sie die Erkennung direkt überspringen und eine unabhängige PHP-Version installieren möchten, fügen Sie diese Umgebungsvariable hinzu: export ZM_NO_LOCAL_PHP="yes" # Wenn das Skript eine unabhängige Version von PHP installiert, die Standardversion ist 8.1. Wenn Sie eine andere Version verwenden möchten, fügen Sie diese Umgebungsvariable hinzu, um die Version anzugeben export ZM_DOWN_PHP_VERSION="8.2"# Standardmäßig speichert das Skript die „zhamao-app“ des Frameworks im aktuellen Verzeichnis. Verzeichnis für die Installation. Wenn Sie ein anderes Verzeichnis verwenden möchten, fügen Sie diese Umgebungsvariable export ZM_CUSTOM_DIR="my-custom-app"# hinzu. Das Skript verwendet standardmäßig das inländische Beschleunigungsimage von Alibaba Cloud für dieses Projekt Quelle, fügen Sie diese Umgebungsvariable hinzu export ZM_COMPOSER_PACKAGIST="yes"# Nachdem Sie die vorherigen Umgebungsvariablen ausgeführt und dann das Ein-Klick-Installationsskript ausgeführt haben, können Sie benutzerdefinierte Parameter implementieren! bash <(curl -fsSL https://zhamao.xin/v3.sh)
Informationen zu alternativen Installationsmethoden finden Sie in der Dokumentation.
Sehen Sie sich das Dokument an (selbst erstellt in China): https://framework.zhamao.xin/
Alternativer Link (ausländisches Hosting): https://framework.zhamao.me/
Native Unterstützung für die gleichzeitige Verbindung mehrerer Roboter-Clients
Flexibler Bindungsmechanismus für Annotationsereignisse, der gleichzeitig Annotationen und native Attributanmerkungen verwenden kann
Als vollständiges Plug-In-System können Plug-Ins geschrieben und verpackt oder zur Verwendung durch andere verteilt werden.
Da es im Plug-in-Format geschrieben ist, kann es frei mit anderen Composer-Komponenten kombiniert oder zur Verarbeitung in eine einzige Datei geschrieben werden
Unterstützt Modulpaketierung und Hotloading, was die gemeinsame Nutzung von Modulen erleichtert
Globale Cache-Variablen, die sich im Speicher befinden, können überall verwendet werden und bieten eine Vielzahl von Caching-Lösungen
Kommt mit MySQL, SQLite, Redis und anderen Datenbankverbindungspools
Es handelt sich um einen HTTP-Server und einen WebSocket-Server, und Sie können Ihre eigene HTTP-API-Schnittstelle erstellen.
Optionale integrierte PHP-Umgebung, keine manuelle Kompilierung und Installation erforderlich, von Crazywhalecc/static-php-cli
Wenn Sie während der Nutzung Probleme feststellen, können Sie selbst einen Issue oder Fork einreichen, ihn ändern und einen Pull Request einreichen.
Derzeit wird das Projekt nur von zwei Personen betreut, was viel Energie verbraucht, daher sind Beiträge zum Rahmenwerk sehr willkommen.
Dieses Projekt wurde in der Freizeit des Autors entwickelt. Wenn Sie es nützlich finden, möchten Sie vielleicht eine Spende leisten, um mich noch mehr zu motivieren, das Plug-in zu verbessern.
Wir werden die gespendeten Gelder für die Serverkosten des Explosive Bot und der Framework-Dokumentation verwenden, die durch dieses Projekt vorangetrieben werden. Spendenliste
Wenn Sie nicht direkt an der Entwicklung des Frameworks teilnehmen möchten, können Sie auch die von Ihnen geschriebenen Module teilen, um zur Verbesserung des Framework-Ökosystems beizutragen.
Das Framework und das SDK sind die zentralen Open-Source-Framework-Teile des Explosive Robot-Projekts. Der Explosive Robot ist ein vom Autor geschriebener Hochleistungsroboter, der den ersten Preis im National Computer Design Competition gewann.
Der Sprengroboter des Autors läuft seit Anfang 2018 seit fünf Jahren stabil und iteriert weiter.
Sie können ein Problem einreichen oder der Gruppe (670821194) zur Fehlerbehebung beitreten.
Achten Sie beim Aktualisieren des Inhalts dieses Projekts bitte rechtzeitig auf GitHub-Updates. Bitte sichern Sie Ihre Plug-Ins oder Projektcodes, bevor Sie aktualisieren.
Das Projekt-Framework ist Open Source und verwendet das Apache-2.0-Protokoll. Das Protokoll muss befolgt werden, wenn es verteilt oder neu geschrieben und geändert wird. Der Projekt-Plug-in-Teil (andere Ordner als src/Globals und src/ZM ) kann ohne Einhaltung des Apache-2.0-Protokolls (Urheberrechtserklärung) verteilt und geändert werden, wenn nicht auf Code innerhalb des Frameworks verwiesen wird.
Hinweis : Wenn Sie AGPL-3.0 -Protokoll-Robotersoftware wie Mirai verwenden, um eine Verbindung zum Framework herzustellen, müssen Sie bei Verwendung dieses Frameworks die Teile, die Sie mit AGPL-3.0 Protokoll geschrieben oder geändert haben, neu verteilen.
Wenn Sie Code beisteuern, bewahren Sie bitte die vertraulichen Informationen in Ihrer globalen Konfigurationsdatei sicher auf und laden Sie keine Konfigurationsdateien mit persönlichen Informationen auf Websites wie GitHub hoch.
Vielen Dank an JetBrains für die Unterstützung des PhpStorm-Entwicklungstools für dieses Open-Source-Projekt:
Vielen Dank an Entwickler @sunxyw für einige Vorschläge zur Standardisierung der Projektentwicklung.
