Version 5.0.0 beta 1

system/3rd_party/Pdp/Host.php

@@ -0,0 +1,60 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pdp;
+
+use Countable;
+use JsonSerializable;
+
+/**
+ * @see https://tools.ietf.org/html/rfc1034#section-3.5
+ * @see https://tools.ietf.org/html/rfc1123#section-2.1
+ * @see https://tools.ietf.org/html/rfc5890
+ */
+interface Host extends Countable, JsonSerializable
+{
+    /**
+     * Returns the domain content.
+     */
+    public function value(): ?string;
+
+    /**
+     * Returns the domain content as a string.
+     */
+    public function toString(): string;
+
+    /**
+     * Returns the domain content.
+     */
+    public function jsonSerialize(): ?string;
+
+    /**
+     * The labels total number.
+     */
+    public function count(): int;
+
+    /**
+     * Converts the domain to its IDNA ASCII form.
+     *
+     * This method MUST retain the state of the current instance, and return
+     * an instance with its content converted to its IDNA ASCII form
+     *
+     * @throws CannotProcessHost if the domain can not be converted to ASCII using IDN UTS46 algorithm
+     *
+     * @return static
+     */
+    public function toAscii(): self;
+
+    /**
+     * Converts the domain to its IDNA UTF8 form.
+     *
+     * This method MUST retain the state of the current instance, and return
+     * an instance with its content converted to its IDNA UTF8 form
+     *
+     * @throws CannotProcessHost if the domain can not be converted to Unicode using IDN UTS46 algorithm
+     *
+     * @return static
+     */
+    public function toUnicode(): self;
+}