atakde / discord-webhook-php

A php package for sending message to discord with webhook.

discord-webhook-php

A php package for sending message to discord with webhook. Supports both text and embed messages types.

Installation

Install via composer

composer require atakde/discord-webhook-php

Usage (Text Message)

require 'vendor/autoload.php';

use Atakde\DiscordWebhook\DiscordWebhook;
use Atakde\DiscordWebhook\Message\MessageFactory;

$messageFactory = new MessageFactory();
$textMessage = $messageFactory->create('text');
$textMessage->setUsername("John Doe");
$textMessage->setContent("Hello World!");

$webhook = new DiscordWebhook($textMessage);
$webhook->setWebhookUrl("https://discord.com/api/...");
$webhook->send();

Usage (Embed Message)

$embedMessage = $messageFactory->create('embed');
$embedMessage->setAvatarUrl("https://doodleipsum.com/700?i=f8b1abea359b643310916a38aa0b0562");
$embedMessage->setContent("Hello World!");
$embedMessage->setUsername("John Doe");
$embedMessage->setTitle("Title");
$embedMessage->setDescription("Description");
$embedMessage->setUrl("https://doodleipsum.com/700?i=f8b1abea359b643310916a38aa0b0562");
$embedMessage->setColor(0x00ff00);
$embedMessage->setTimestamp(date("Y-m-d", strtotime("now")));
$embedMessage->setFooterIcon("https://doodleipsum.com/700?i=f8b1abea359b643310916a38aa0b0562");
$embedMessage->setFooterText("Footer Text");
$embedMessage->setImageUrl("https://doodleipsum.com/700?i=f8b1abea359b643310916a38aa0b0562");
$embedMessage->setThumbnailUrl("https://doodleipsum.com/700?i=f8b1abea359b643310916a38aa0b0562");
$embedMessage->setAuthorName("Author Name");
$embedMessage->setAuthorUrl("https://doodleipsum.com/700?i=f8b1abea359b643310916a38aa0b0562");
$embedMessage->setAuthorIcon("https://doodleipsum.com/700?i=f8b1abea359b643310916a38aa0b0562");
$embedMessage->setFields([
    [
        'name' => 'Field 1',
        'value' => 'Value 1',
        'inline' => true
    ],
    [
        'name' => 'Field 2',
        'value' => 'Value 2',
        'inline' => false
    ]
]);

$webhook = new DiscordWebhook($embedMessage);
$webhook->setWebhookUrl("https://discord.com/api/...");
$webhook->send();

Usage (File Message)

$messageFactory = new MessageFactory();
$fileMessage = $messageFactory->create('file');
$fileMessage->setUsername('Atakde');
$fileMessage->setContent('Hello World!');
$fileMessage->setAvatarUrl('https://avatars.githubusercontent.com/u/25267804?v=4');
$fileMessage->setTts(false);
$fileMessage->setFileFromURL('https://avatars.githubusercontent.com/u/25267804?v=4');

$webhook = new DiscordWebhook($fileMessage);
$webhook->setWebhookUrl("https://discord.com/api/...");
$webhook->send();

discord-webhook-php's Issues

File support

A FileMessage class would be excellent.

The main thing that needs to be done is a file needs to be attached to file and the header needs to change from JSON to multipart/form-data.

It could get fancy and have an easy way to attach a text-based attachment, but otherwise most of it could be left up to the user.

Using old PHP

I'm using old PHP (7.4) and cannot do "composer require atakde/discord-webhook-php" it will return error
Cannot use atakde/discord-webhook-php's latest version 2.0.0 as it requires php >=8.0.9 which is not satisfied by your platform.

any fix?

Remove `echo` when exception is thrown

Any chance of removing the echo when an exception is thrown?

Forcing output is typically not ideal and it is clashing with my error handler in Laravel. Leaving it as a bool would be great so it'd be up to the user to decide if an exception should be thrown or how it should be handled.