Improve UriRenderer interface (#154)

CHANGELOG.md

@@ -19,6 +19,7 @@ All Notable changes to `League\Uri\Interfaces` will be documented in this file
 - `UriString::removeDotSegments`
 - `UriString::normalize`
 - `UriString::normalizeAuthority`
+- `FeatureDetection::supportsDom`
 
 ### Fixed
 

Contracts/UriRenderer.php

@@ -58,7 +58,7 @@ public function jsonSerialize(): string;
     /**
      * Returns the markdown string representation of the anchor tag with the current instance as its href attribute.
      */
-    public function toMarkdown(?string $linkTextTemplate = null): string;
+    public function toMarkdownAnchor(?string $linkTextTemplate = null): string;
 
     /**
      * Returns the HTML string representation of the anchor tag with the current instance as its href attribute.
@@ -67,25 +67,25 @@ public function toMarkdown(?string $linkTextTemplate = null): string;
      *
      * @throws DOMException
      */
-    public function toAnchorTag(?string $linkTextTemplate = null, iterable $attributes = []): string;
+    public function toHtmlAnchor(?string $linkTextTemplate = null, iterable $attributes = []): string;
 
     /**
      * Returns the Link tag content for the current instance.
      *
-     * @param iterable<string, string|null> $attributes an ordered map of key value. you must quote the value if needed
+     * @param iterable<string, string|null> $attributes an ordered map of key value
      *
      * @throws DOMException
      */
-    public function toLinkTag(iterable $attributes = []): string;
+    public function toHtmlLink(iterable $attributes = []): string;
 
     /**
      * Returns the Link header content for a single item.
      *
-     * @param iterable<string, string|int|float|bool> $parameters an ordered map of key value. you must quote the value if needed
+     * @param iterable<string, string|int|float|bool|null> $parameters an ordered map of key value.
      *
      * @see https://www.rfc-editor.org/rfc/rfc7230.html#section-3.2.6
      */
-    public function toLinkHeaderValue(iterable $parameters = []): string;
+    public function toHeaderLinkValue(iterable $parameters = []): string;
 
     /**
      * Returns the Unix filesystem path. The method returns null for any other scheme except the file scheme.

FeatureDetection.php

@@ -17,6 +17,8 @@
 use League\Uri\Exceptions\MissingFeature;
 use League\Uri\IPv4\Calculator;
 
+use function extension_loaded;
+
 use const PHP_INT_SIZE;
 
 /**
@@ -53,4 +55,14 @@ public static function supportsIPv4Conversion(): void
             throw new MissingFeature('A '.Calculator::class.' implementation could not be automatically loaded. To perform IPv4 conversion use a x.64 PHP build or install one of the following extension GMP or BCMath. You can also ship your own implmentation.');
         }
     }
+
+    public static function supportsDom(): void
+    {
+        static $isSupported = null;
+        $isSupported = $isSupported ?? extension_loaded('dom');
+
+        if (!$isSupported) {
+            throw new MissingFeature('To use a DOM related feature, the DOM extension must be installed in your system.');
+        }
+    }
 }