zhamao framework
3.2.5
zhamao-frameworkは高機能チャットロボット+Webサーバー開発フレームワークです
開発者 QQ グループ: 670821194クリックしてグループ チャットに参加してください
フレームワーク自体の開発に協力していただける開発者がいらっしゃいましたら、PR または Issue を送信して開発に参加してください。フレームワーク自体の中核となる設計についてより良いアイデアがある場合は、作成者と開発チーム (現在は 2 人のみ) を立ち上げ、OneBot V12 エコシステムとフレームワーク自体の開発に参加できます。
関連する進行中のバージョンのタスクについては、「プロジェクト」列を参照してください。
Zhamo フレームワークは PHP で書かれており、主に API サービスとチャット ロボットを対象としています。Websocket、HTTP、その他の監視およびリクエスト ライブラリが含まれており、ユーザー コードはモジュール化されており、アノテーションを使用してさまざまな機能を簡単に記述することができます。
このフレームワークの主な目的は、HTTP サーバーとロボットのフレームワーク構築です。特にチャットボットのメッセージ処理では、より便利で包括的な機能が多数の会話メカニズムと内部呼び出しメカニズムを提供しており、さまざまな方法で独自のプラグインを設計できます。
#[BotCommand('Hello')]public function hello(BotContext $ctx) { $ctx->reply("こんにちは、Zha Mao です!"); // 単純な命令型応答}
#[Route('/index')]public functionindex() { 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サーバー
ワンクリック インストール スクリプトを使用すると、次のようなパラメータをカスタマイズすることもできます。
# スクリプトはデフォルトでシステムの PHP を検出します。検出を直接スキップして独立した PHP バージョンをインストールする場合は、この環境変数を追加します。他のバージョンを使用する場合は、この環境変数を追加してバージョンを指定します。export ZM_DOWN_PHP_VERSION="8.2"# デフォルトでは、スクリプトはフレームワークの `zhamao-app` を現在のディレクトリに保存します。インストール用のディレクトリ。別のディレクトリを使用する場合は、この環境変数を追加します。ソースにこの環境変数を追加します。export ZM_COMPOSER_PACKAGIST="yes"# 前の環境変数を実行してからワンクリック インストール スクリプトを実行すると、カスタム パラメーターを実装できます。 bash <(curl -fsSL https://zhamao.xin/v3.sh)
別のインストール方法についてはドキュメントを参照してください。
ドキュメントを表示します (中国で自社構築): https://framework.zhamao.xin/
代替リンク (海外ホスティング): https://framework.zhamao.me/
複数のロボット クライアントの同時接続をネイティブ サポート
注釈とネイティブ属性注釈を同時に使用できる、柔軟な注釈イベント バインディング メカニズム
完全なプラグイン システムであるため、プラグインを作成してパッケージ化したり、他のユーザーが使用できるように配布したりできます。
プラグイン形式で記述されているため、他の Composer コンポーネントと自由に組み合わせたり、単一のファイルに記述して処理したりすることができます。
モジュールのパッケージ化とホットロードをサポートし、モジュールの共有がより便利になります
メモリ内に常駐するグローバル キャッシュ変数はどこでも使用でき、さまざまなキャッシュ ソリューションを提供します。
MySQL、SQLite、Redis、その他のデータベース接続プールが付属
これは HTTP サーバーと WebSocket サーバーであり、独自の HTTP API インターフェイスを構築できます。
オプションの組み込み PHP 環境。手動でコンパイルしてインストールする必要はありません (crazywhalecc/static-php-cli による)
使用中に問題が見つかった場合は、Issue を送信するか、自分でフォークして変更し、Pull Request を送信できます。
現在、このプロジェクトは 2 人だけで維持されており、多大なエネルギーを消費しているため、フレームワークへの貢献は大歓迎です。
このプロジェクトは作者の余暇に開発されたものです。役に立ったと思われる場合は、寄付をしていただければ、プラグインを改善するためのモチベーションが高まります。ご支援よろしくお願いします。
寄付された資金は、このプロジェクトによって推進される Explosive Bot のサーバー費用とフレームワークのドキュメントに使用されます。寄付リスト
フレームワークの開発に直接参加したくない場合は、フレームワークのエコシステムを改善するために作成したモジュールを共有することもできます。
フレームワークと SDK は、Explosive Robot プロジェクトの中核となるフレームワークのオープンソース部分です。 Explosive Robot は著者が作成した高性能ロボットで、全国コンピュータ設計コンペティションで最優秀賞を受賞しました。
著者の爆発ロボットは、2018 年の初めから5 年間安定して動作し、反復を続けています。
問題を送信するか、トラブルシューティングのためにグループ (670821194) に参加できます。
このプロジェクトのコンテンツを更新する場合は、GitHub の更新に注意してください。更新する前にプラグインまたはプロジェクト コードをバックアップしてください。
プロジェクトのフレームワークは Apache-2.0 プロトコルを使用したオープンソースであり、配布または書き換え、変更する場合はプロトコルに従う必要があります。プロジェクトのプラグイン部分（ src/Globals 、 src/ZMフォルダ以外のフォルダ）は、フレームワーク内のコードを参照しない場合、Apache-2.0プロトコル（著作権宣言）に準拠せずに配布、改変することができます。
注: mirai などのAGPL-3.0プロトコルのロボット ソフトウェアを使用してフレームワークに接続する場合、このフレームワークを使用するには、 AGPL-3.0プロトコルを使用して作成または変更した部分を再配布する必要があります。
コードを寄稿する場合は、グローバル構成ファイル内の機密情報を安全に保管し、個人情報を含む構成ファイルを GitHub などの Web サイトにアップロードしないでください。
このオープンソース プロジェクトに PhpStorm 開発ツールのサポートを提供してくれた JetBrains に感謝します。
プロジェクト開発を標準化するためのいくつかの提案を提供してくれた開発者 @sunxyw に感謝します。
