zhamao framework
3.2.5
zhamao-framework adalah robot obrolan berkinerja tinggi + kerangka pengembangan server web
Grup QQ Pengembang: 670821194 Klik untuk bergabung dengan obrolan grup
Jika ada developer yang bersedia bekerja sama untuk mengembangkan frameworknya sendiri, silakan ajukan PR atau Issue untuk ikut serta dalam pengembangan! Jika Anda memiliki gagasan yang lebih baik tentang desain inti kerangka itu sendiri, Anda dapat membentuk tim pengembangan dengan penulis (saat ini hanya 2 orang) untuk berpartisipasi dalam pengembangan ekosistem OneBot V12 dan kerangka itu sendiri.
Lihat kolom Proyek untuk tugas terkait versi yang sedang berlangsung!
Kerangka kerja Zhamao ditulis dalam PHP dan terutama berorientasi pada layanan API dan robot obrolan. Ini mencakup Websocket, HTTP, dan pustaka pemantauan dan permintaan lainnya. Kode pengguna dimodulasi dan berbagai fungsi dapat dengan mudah ditulis menggunakan anotasi.
Tujuan utama dari kerangka ini adalah server HTTP dan kerangka pembuatan robot. Khusus untuk pemrosesan pesan chatbot, ini lebih nyaman dan komprehensif. Ini menyediakan banyak mekanisme percakapan dan mekanisme panggilan internal, dan Anda dapat merancang plug-in Anda sendiri dengan berbagai cara.
#[BotCommand('Halo')]fungsi publik halo(BotContext $ctx) { $ctx->reply("Halo, saya Zha Mao!"); // Balasan perintah sederhana}
#[Route('/index')]public function index() { return "<h1>halo!</h1>"; // Pengembangan layanan HTTP yang cepat}Kerangka kerja saat ini mendukung operasi langsung di lingkungan Linux, WSL, macOS, dan Windows. Untuk lingkungan Linux dan macOS, Anda dapat langsung menggunakan skrip instalasi sekali klik di bawah.
Jika Anda ingin menginstal dan menerapkan di lingkungan lain, Anda dapat menggunakan penerapan cepat Docker atau menginstal lingkungan secara manual, lalu menginstal kerangka kerja. Lihat dokumentasi untuk detailnya.
# Linux, macOS klik berikutnya untuk mendeteksi lingkungan PHP dan menginstal framework bash <(curl -fsSL https://zhamao.xin/v3.sh)# Mulai framework cd zhamao-v3 ./server zhamao
Skrip instalasi sekali klik juga memungkinkan Anda menyesuaikan parameter, seperti:
# Skrip akan mendeteksi PHP sistem secara default. Jika Anda ingin melewati deteksi secara langsung dan menginstal versi PHP independen, tambahkan variabel lingkungan ini ekspor ZM_NO_LOCAL_PHP="yes" # Jika skrip menginstal versi PHP independen, versi default adalah 8.1. Jika Anda ingin menggunakan versi lain, tambahkan variabel lingkungan ini untuk menentukan versinya ekspor ZM_DOWN_PHP_VERSION="8.2"# Secara default, skrip akan menyimpan `zhamao-app` kerangka kerja di direktori saat ini. Direktori untuk instalasi. Jika Anda ingin menggunakan direktori lain, tambahkan variabel lingkungan ini ekspor ZM_CUSTOM_DIR="my-custom-app"# Skrip akan menggunakan gambar akselerasi domestik Alibaba Cloud untuk proyek ini secara default sumber, tambahkan variabel lingkungan ini ekspor ZM_COMPOSER_PACKAGIST="yes"# Setelah menjalankan variabel lingkungan sebelumnya dan kemudian menjalankan skrip instalasi sekali klik, Anda dapat menerapkan parameter khusus! pesta <(curl -fsSL https://zhamao.xin/v3.sh)
Lihat dokumentasi untuk metode instalasi alternatif.
Lihat dokumen (buatan sendiri di Tiongkok): https://framework.zhamao.xin/
Tautan alternatif (hosting asing): https://framework.zhamao.me/
Dukungan asli untuk beberapa klien robot untuk terhubung secara bersamaan
Mekanisme pengikatan peristiwa anotasi yang fleksibel, yang dapat menggunakan anotasi Anotasi dan Atribut asli secara bersamaan
Sebuah sistem plug-in yang lengkap, plug-in dapat ditulis dan dikemas atau didistribusikan untuk digunakan oleh orang lain.
Ditulis dalam format plug-in, dapat digabungkan secara bebas dengan komponen Komposer lainnya, atau dapat ditulis dalam satu file untuk diproses.
Mendukung pengemasan modul dan pemuatan panas, membuatnya lebih nyaman untuk berbagi modul
Berada di memori, variabel cache global dapat digunakan di mana saja, menyediakan berbagai solusi caching
Dilengkapi dengan MySQL, SQLite, Redis, dan kumpulan koneksi database lainnya
Ini adalah server HTTP dan server WebSocket, dan Anda dapat membuat antarmuka API HTTP Anda sendiri.
Lingkungan PHP bawaan opsional, tidak perlu dikompilasi dan diinstal secara manual, dengan crazywhalecc/static-php-cli
Jika Anda menemukan masalah selama penggunaan, Anda dapat mengajukan Issue atau Fork sendiri, memodifikasinya dan mengirimkan Pull Request.
Saat ini, proyek ini dikelola oleh hanya dua orang, yang menghabiskan banyak energi, sehingga kontribusi terhadap kerangka kerja ini sangat kami harapkan.
Proyek ini dikembangkan di waktu luang penulis. Jika Anda merasa bermanfaat, Anda mungkin ingin memberikan donasi. Donasi Anda akan memberi saya lebih banyak motivasi untuk meningkatkan plugin ini.
Kami akan menggunakan dana yang disumbangkan untuk biaya server Explosive Bot dan dokumentasi kerangka kerja yang didorong oleh proyek ini. Daftar donasi
Jika Anda tidak ingin berpartisipasi langsung dalam pengembangan kerangka kerja, Anda juga dapat membagikan modul yang Anda tulis untuk membantu meningkatkan ekosistem kerangka kerja.
Kerangka kerja dan SDK adalah bagian sumber terbuka kerangka inti dari proyek Robot Peledak. Robot Peledak merupakan robot berperforma tinggi karya penulis yang berhasil meraih juara pertama Kompetisi Desain Komputer Nasional.
Robot peledak buatan penulis telah berjalan stabil selama lima tahun sejak awal tahun 2018 dan terus melakukan iterasi.
Anda dapat mengirimkan masalah atau bergabung dengan grup (670821194) untuk pemecahan masalah.
Saat memperbarui konten proyek ini, harap perhatikan pembaruan GitHub secara tepat waktu. Harap buat cadangan plugin atau kode proyek Anda sebelum memperbarui.
Kerangka kerja proyek adalah sumber terbuka menggunakan protokol Apache-2.0, dan protokol tersebut harus diikuti saat mendistribusikan atau menulis ulang dan memodifikasinya. Bagian plug-in proyek (folder selain folder src/Globals dan src/ZM ) dapat didistribusikan dan dimodifikasi tanpa mematuhi protokol Apache-2.0 (pernyataan hak cipta) ketika tidak mereferensikan kode dalam kerangka.
Catatan : Saat Anda menggunakan perangkat lunak robot protokol AGPL-3.0 seperti mirai untuk terhubung ke kerangka kerja, menggunakan kerangka kerja ini mengharuskan Anda untuk mendistribusikan ulang bagian-bagian yang Anda tulis atau modifikasi menggunakan protokol AGPL-3.0 .
Saat menyumbangkan kode, harap simpan informasi sensitif di file konfigurasi global Anda dengan aman, dan jangan unggah file konfigurasi dengan informasi pribadi ke situs web seperti GitHub.
Terima kasih kepada JetBrains yang telah menyediakan dukungan alat pengembangan PhpStorm untuk proyek sumber terbuka ini:
Terima kasih kepada pengembang @sunxyw atas beberapa saran untuk standarisasi pengembangan proyek.
