jacknoordhuis/discord-php

一个辅助与 Discord 网关 API 交互的非官方库。

v4.0.3 2016-12-28 21:41 UTC

README

Build Status Discord Chat PHP Discorders

一个与 Discord 网关 API 交互的非官方库(DiscordPHP 的延续DiscordPHP)。

常见问题解答

  1. 我可以在 web 服务器(例如 Apache、nginx)上运行 DiscordPHP 吗?
    • 不,DiscordPHP 仅在 CLI 中运行。如果您想为您的机器人创建一个界面,可以将 react/http 与您的机器人集成,并通过 CLI 运行。

入门指南

安装 DiscordPHP

DiscordPHP 通过 Composer 安装。请确保您已安装 Composer 并且熟悉其操作。我们要求至少使用 PHP 5.5.9 版本,但建议您使用 PHP 7。PHP 5.x 支持 将会 在未来被移除。

这个库没有与 HHVM 进行过测试。

  1. 运行 composer require team-reflex/discord-php。这将安装最新版本。
    • 如果您想,也可以通过运行 composer require team-reflex/discord-php dev-develop 来安装开发分支。
  2. 在主文件顶部包含 Composer 自动加载文件
    • include __DIR__.'/vendor/autoload.php';
  3. 创建一个机器人!

基本示例

<?php

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

use Discord\Discord;

$discord = new Discord([
	'token' => 'bot-token',
]);

$discord->on('ready', function ($discord) {
	echo "Bot is ready!", PHP_EOL;

	// Listen for messages.
	$discord->on('message', function ($message, $discord) {
		echo "{$message->author->username}: {$message->content}",PHP_EOL;
	});
});

$discord->run();

注意事项

  • 这个库可能会消耗大量 RAM,PHP 可能会达到内存限制。要增加内存限制,使用 ini_set('memory_limit', '200M') 将其增加到 200 MB。如果您想使其无限制,使用 ini_set('memory_limit', '-1')

文档

原始文档可以在代码中找到,并在 DiscordPHP 类参考 上找到。更多用户友好和示例将很快在 DiscordPHP Wiki 上出现。

贡献

我们欢迎贡献。但是,请确保您遵循我们的编码标准(PSR-4 自动加载和自定义样式)。我们使用 StyleCI 来格式化我们的代码。我们的 StyleCI 设置可以在 这里 找到。

库比较

查看 此图表 以比较功能和 Discord API 库列表。