#10 Simple Webhooks

Author: scrummer

src/DiscordWebhook/EmbedColor.php

@@ -3,6 +3,12 @@
 
 namespace DiscordWebhook;
 
+/**
+ * Enum EmbedColor
+ *
+ * @author Scrummer <[email protected]>
+ * @package DiscordWebhook
+ */
 enum EmbedColor: int
 {
     case DEFAULT = 0;

src/DiscordWebhook/Exception/DiscordWebhookException.php

@@ -0,0 +1,15 @@
+<?php
+declare(strict_types=1);
+
+namespace DiscordWebhook\Exception;
+
+use RuntimeException;
+
+/**
+ * Class DiscordWebhookException
+ *
+ * @package DiscordWebhook\Exception
+ */
+class DiscordWebhookException extends RuntimeException
+{
+}

src/DiscordWebhook/SimpleWebhook.php

@@ -0,0 +1,54 @@
+<?php
+declare(strict_types=1);
+
+namespace DiscordWebhook;
+
+use DiscordWebhook\Exception\DiscordWebhookException;
+use GuzzleHttp\Exception\GuzzleException;
+use Symfony\Component\Serializer\Exception\ExceptionInterface;
+
+/**
+ * Class SimpleWebhook
+ *
+ * @author Scrummer <[email protected]>
+ * @package DiscordWebhook
+ */
+class SimpleWebhook extends Webhook
+{
+    private static ?string $defaultUrl = null;
+
+    private static ?SimpleWebhook $instance = null;
+
+    /**
+     * Send a message instantly.
+     *
+     * @param string      $message The message to be sent
+     * @param string|null $url A specific url if you want to override the default one
+     *
+     * @throws ExceptionInterface
+     * @throws GuzzleException
+     */
+    public static function sendMessage(string $message, string $url = null): bool
+    {
+        if (self::$instance === null) {
+            self::$instance = self::createInstance($url);
+        }
+
+        return self::$instance->setMessage($message)->send();
+    }
+
+    private static function createInstance(?string $url = null): SimpleWebhook
+    {
+        self::$defaultUrl = $url;
+
+        if (self::$defaultUrl === null && array_key_exists('DWH_DEFAULT_URL', $_ENV)) {
+            self::$defaultUrl = $_ENV['DWH_DEFAULT_URL'] ?? null;
+        }
+
+        if (self::$defaultUrl === null) {
+            throw new DiscordWebhookException('No default URL has been set. Either add the `DWH_DEFAULT_URL` env variable or pass it to the `sendMessage` method.');
+        }
+
+        return new self(self::$defaultUrl);
+    }
+}

tests/test.php

@@ -15,6 +15,11 @@
     exit(1);
 }
 
+// TEST simple webhook
+\DiscordWebhook\SimpleWebhook::sendMessage('Test simple WH', 'https://canary.discord.com/api/webhooks/422789288565014530/DbUOQNLXS8-BN9eFkVKCAdvnp2dNpRMebRAOXZEWU0bLx70t689t7QYrG5S4oibNIWI0');
+
+exit;
+
 // CONFIGURE your Webhook below to test
 $wh = new \DiscordWebhook\Webhook([
     $_ENV['DISCORD_TEST_URL']