DiscordPHP

PerselisihanPHP

Pembungkus untuk Discord REST resmi, gateway, dan API suara. Dokumentasi tersedia di sini, meskipun saat ini terbatas, serta referensi kelas. Jangan ragu untuk mengajukan pertanyaan di server Discord di atas.

Untuk pengujian dan stabilitas, akan sangat dihargai jika Anda dapat menambahkan bot pengujian kami ke server Anda. Kami tidak menyimpan data apa pun - bot hanya diam dan tidak berinteraksi dengan siapa pun dan digunakan untuk menguji stabilitas dengan sejumlah besar guild. Anda dapat mengundang bot di sini.

Antarmuka Cache (eksperimental)

Peringatan Cabang ini berisi fitur eksperimental, jangan gunakan dalam produksi! Lihat halaman wiki untuk informasi lebih lanjut tentang cara mengaturnya.

Pertanyaan Umum

1. Bisakah saya menjalankan DiscordPHP di server web (misalnya Apache, nginx)?

• Tidak, DiscordPHP hanya akan berjalan di CLI. Jika Anda ingin memiliki antarmuka untuk bot Anda, Anda dapat mengintegrasikan react/http dengan bot Anda dan menjalankannya melalui CLI.

2. PHP kehabisan memori?

• Coba batasi memori PHP Anda menggunakan ini_set('memory_limit', '-1'); .

Memulai

Sebelum Anda mulai menggunakan Library ini, Anda perlu mengetahui cara kerja PHP, Anda perlu mengetahui cara kerja Event Loops dan Promises. Ini adalah persyaratan mendasar sebelum Anda memulai. Tanpa pengetahuan ini, Anda hanya akan menderita.

Persyaratan

• PHP 8.0 atau lebih tinggi (disarankan versi terbaru)

• x86 (32-bit) PHP memerlukan ext-gmp diaktifkan.

• ext-json

• ext-zlib

Ekstensi yang Direkomendasikan

• Salah satu ext-uv (disarankan), ext-ev atau ext-event untuk perulangan peristiwa yang lebih cepat dan berperforma tinggi.

• ext-mbstring jika menangani karakter non-latin.

Persyaratan Suara

• PHP 64-bit

• ext-sodium

• FFmpeg

Windows dan SSL

Sayangnya PHP di Windows tidak memiliki akses ke Windows Certificate Store. Ini merupakan masalah karena TLS digunakan dan verifikasi sertifikat diterapkan (menonaktifkannya bukanlah suatu pilihan).

Anda akan melihat masalah ini saat skrip Anda keluar segera setelah satu putaran tanpa kesalahan apa pun.

Oleh karena itu, pengguna perpustakaan ini perlu mengunduh ekstrak Certificate Authority dari situs web cURL.
Jalur ke caextract harus diatur di php.ini untuk openssl.cafile .

Menginstal PerselisihanPHP

DiscordPHP diinstal menggunakan Komposer.

1. Jalankan composer require team-reflex/discord-php . Ini akan menginstal rilis stabil terbaru.

• Jika mau, Anda juga dapat menginstal cabang pengembangan dengan menjalankan composer require team-reflex/discord-php dev-master .

2. Sertakan file autoload Composer di bagian atas file utama Anda:

• include __DIR__.'/vendor/autoload.php';

3. Buat bot!

Contoh Dasar

 <?phpinclude __DIR__.'/vendor/autoload.php'; gunakan DiscordDiscord; gunakan DiscordPartsChannelMessage; gunakan DiscordWebSocketsIntents; gunakan DiscordWebSocketsEvent;$discord = new Discord(['token' => 'bot-token','intents' => Maksud ::getDefaultIntents()// | Maksud::MESSAGE_CONTENT, // Catatan: MESSAGE_CONTENT memiliki hak istimewa, lihat https://dis.gd/mcfaq]);$discord->on('ready', function (Discord $discord) {echo "Bot sudah siap!" , PHP_EOL;// Dengarkan pesan.$discord->on(Event::MESSAGE_CREATE, function (Pesan $message, Discord $discord) {echo "{$message->author->username}: {$message->content}", PHP_EOL;// Catatan: Maksud MESSAGE_CONTENT harus diaktifkan untuk mendapatkan konten jika bot tidak disebutkan/DM .});
});$perselisihan->jalankan();

Lihat contoh folder untuk informasi lebih lanjut.

Dokumentasi

Dokumentasi untuk versi terbaru dapat ditemukan di sini. Tutorial kontribusi komunitas dapat ditemukan di wiki.

Berkontribusi

Kami terbuka untuk berkontribusi. Namun, pastikan Anda mengikuti standar pengkodean kami (pemuatan otomatis PSR-4 dan gaya khusus). Silakan jalankan php-cs-fixer sebelum membuka pull request dengan menjalankan composer run-script cs .

Lisensi

Lisensi MIT, © David Cole dan kontributor lainnya 2016-sekarang.