sop / x501

lib/X501/ASN1/AttributeTypeAndValue.php

Indentation +101 added lines, -101 removed lines

@@ -15,114 +15,114 @@
  */
 class AttributeTypeAndValue
 {
-    use TypedAttribute;
+	use TypedAttribute;
 
-    /**
-     * Attribute value.
-     *
-     * @var AttributeValue
-     */
-    protected $_value;
+	/**
+	 * Attribute value.
+	 *
+	 * @var AttributeValue
+	 */
+	protected $_value;
 
-    /**
-     * Constructor.
-     *
-     * @param AttributeType  $type  Attribute type
-     * @param AttributeValue $value Attribute value
-     */
-    public function __construct(AttributeType $type, AttributeValue $value)
-    {
-        $this->_type = $type;
-        $this->_value = $value;
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param AttributeType  $type  Attribute type
+	 * @param AttributeValue $value Attribute value
+	 */
+	public function __construct(AttributeType $type, AttributeValue $value)
+	{
+		$this->_type = $type;
+		$this->_value = $value;
+	}
 
-    /**
-     * @return string
-     */
-    public function __toString()
-    {
-        return $this->toString();
-    }
+	/**
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return $this->toString();
+	}
 
-    /**
-     * Initialize from ASN.1.
-     *
-     * @param Sequence $seq
-     *
-     * @return self
-     */
-    public static function fromASN1(Sequence $seq): self
-    {
-        $type = AttributeType::fromASN1($seq->at(0)->asObjectIdentifier());
-        $value = AttributeValue::fromASN1ByOID($type->oid(), $seq->at(1));
-        return new self($type, $value);
-    }
+	/**
+	 * Initialize from ASN.1.
+	 *
+	 * @param Sequence $seq
+	 *
+	 * @return self
+	 */
+	public static function fromASN1(Sequence $seq): self
+	{
+		$type = AttributeType::fromASN1($seq->at(0)->asObjectIdentifier());
+		$value = AttributeValue::fromASN1ByOID($type->oid(), $seq->at(1));
+		return new self($type, $value);
+	}
 
-    /**
-     * Convenience method to initialize from attribute value.
-     *
-     * @param AttributeValue $value Attribute value
-     *
-     * @return self
-     */
-    public static function fromAttributeValue(AttributeValue $value): self
-    {
-        return new self(new AttributeType($value->oid()), $value);
-    }
+	/**
+	 * Convenience method to initialize from attribute value.
+	 *
+	 * @param AttributeValue $value Attribute value
+	 *
+	 * @return self
+	 */
+	public static function fromAttributeValue(AttributeValue $value): self
+	{
+		return new self(new AttributeType($value->oid()), $value);
+	}
 
-    /**
-     * Get attribute value.
-     *
-     * @return AttributeValue
-     */
-    public function value(): AttributeValue
-    {
-        return $this->_value;
-    }
+	/**
+	 * Get attribute value.
+	 *
+	 * @return AttributeValue
+	 */
+	public function value(): AttributeValue
+	{
+		return $this->_value;
+	}
 
-    /**
-     * Generate ASN.1 structure.
-     *
-     * @return Sequence
-     */
-    public function toASN1(): Sequence
-    {
-        return new Sequence($this->_type->toASN1(), $this->_value->toASN1());
-    }
+	/**
+	 * Generate ASN.1 structure.
+	 *
+	 * @return Sequence
+	 */
+	public function toASN1(): Sequence
+	{
+		return new Sequence($this->_type->toASN1(), $this->_value->toASN1());
+	}
 
-    /**
-     * Get attributeTypeAndValue string conforming to RFC 2253.
-     *
-     * @see https://tools.ietf.org/html/rfc2253#section-2.3
-     *
-     * @return string
-     */
-    public function toString(): string
-    {
-        return $this->_type->typeName() . '=' . $this->_value->rfc2253String();
-    }
+	/**
+	 * Get attributeTypeAndValue string conforming to RFC 2253.
+	 *
+	 * @see https://tools.ietf.org/html/rfc2253#section-2.3
+	 *
+	 * @return string
+	 */
+	public function toString(): string
+	{
+		return $this->_type->typeName() . '=' . $this->_value->rfc2253String();
+	}
 
-    /**
-     * Check whether attribute is semantically equal to other.
-     *
-     * @param AttributeTypeAndValue $other Object to compare to
-     *
-     * @return bool
-     */
-    public function equals(AttributeTypeAndValue $other): bool
-    {
-        // check that attribute types match
-        if ($this->oid() !== $other->oid()) {
-            return false;
-        }
-        $matcher = $this->_value->equalityMatchingRule();
-        $result = $matcher->compare($this->_value->stringValue(),
-            $other->_value->stringValue());
-        // match
-        if ($result) {
-            return true;
-        }
-        // no match or Undefined
-        return false;
-    }
+	/**
+	 * Check whether attribute is semantically equal to other.
+	 *
+	 * @param AttributeTypeAndValue $other Object to compare to
+	 *
+	 * @return bool
+	 */
+	public function equals(AttributeTypeAndValue $other): bool
+	{
+		// check that attribute types match
+		if ($this->oid() !== $other->oid()) {
+			return false;
+		}
+		$matcher = $this->_value->equalityMatchingRule();
+		$result = $matcher->compare($this->_value->stringValue(),
+			$other->_value->stringValue());
+		// match
+		if ($result) {
+			return true;
+		}
+		// no match or Undefined
+		return false;
+	}
 }

lib/X501/ASN1/Name.php

Indentation +204 added lines, -204 removed lines

@@ -20,208 +20,208 @@
  */
 class Name implements \Countable, \IteratorAggregate
 {
-    /**
-     * Relative distinguished name components.
-     *
-     * @var RDN[]
-     */
-    protected $_rdns;
-
-    /**
-     * Constructor.
-     *
-     * @param RDN ...$rdns RDN components
-     */
-    public function __construct(RDN ...$rdns)
-    {
-        $this->_rdns = $rdns;
-    }
-
-    /**
-     * @return string
-     */
-    public function __toString()
-    {
-        return $this->toString();
-    }
-
-    /**
-     * Initialize from ASN.1.
-     *
-     * @param Sequence $seq
-     *
-     * @return self
-     */
-    public static function fromASN1(Sequence $seq): self
-    {
-        $rdns = array_map(
-            function (UnspecifiedType $el) {
-                return RDN::fromASN1($el->asSet());
-            }, $seq->elements());
-        return new self(...$rdns);
-    }
-
-    /**
-     * Initialize from distinguished name string.
-     *
-     * @see https://tools.ietf.org/html/rfc1779
-     *
-     * @param string $str
-     *
-     * @return self
-     */
-    public static function fromString(string $str): self
-    {
-        $rdns = [];
-        foreach (DNParser::parseString($str) as $nameComponent) {
-            $attribs = [];
-            foreach ($nameComponent as [$name, $val]) {
-                $type = AttributeType::fromName($name);
-                // hexstrings are parsed to ASN.1 elements
-                if ($val instanceof Element) {
-                    $el = $val;
-                } else {
-                    $el = AttributeType::asn1StringForType($type->oid(), $val);
-                }
-                $value = AttributeValue::fromASN1ByOID($type->oid(),
-                    $el->asUnspecified());
-                $attribs[] = new AttributeTypeAndValue($type, $value);
-            }
-            $rdns[] = new RDN(...$attribs);
-        }
-        return new self(...$rdns);
-    }
-
-    /**
-     * Generate ASN.1 structure.
-     *
-     * @return Sequence
-     */
-    public function toASN1(): Sequence
-    {
-        $elements = array_map(
-            function (RDN $rdn) {
-                return $rdn->toASN1();
-            }, $this->_rdns);
-        return new Sequence(...$elements);
-    }
-
-    /**
-     * Get distinguised name string conforming to RFC 2253.
-     *
-     * @see https://tools.ietf.org/html/rfc2253#section-2.1
-     *
-     * @return string
-     */
-    public function toString(): string
-    {
-        $parts = array_map(
-            function (RDN $rdn) {
-                return $rdn->toString();
-            }, array_reverse($this->_rdns));
-        return implode(',', $parts);
-    }
-
-    /**
-     * Whether name is semantically equal to other.
-     *
-     * Comparison conforms to RFC 4518 string preparation algorithm.
-     *
-     * @see https://tools.ietf.org/html/rfc4518
-     *
-     * @param Name $other Object to compare to
-     *
-     * @return bool
-     */
-    public function equals(Name $other): bool
-    {
-        // if RDN count doesn't match
-        if (count($this) != count($other)) {
-            return false;
-        }
-        for ($i = count($this) - 1; $i >= 0; --$i) {
-            $rdn1 = $this->_rdns[$i];
-            $rdn2 = $other->_rdns[$i];
-            if (!$rdn1->equals($rdn2)) {
-                return false;
-            }
-        }
-        return true;
-    }
-
-    /**
-     * Get all RDN objects.
-     *
-     * @return RDN[]
-     */
-    public function all(): array
-    {
-        return $this->_rdns;
-    }
-
-    /**
-     * Get the first AttributeValue of given type.
-     *
-     * Relative name components shall be traversed in encoding order, which is
-     * reversed in regards to the string representation.
-     * Multi-valued RDN with multiple attributes of the requested type is
-     * ambiguous and shall throw an exception.
-     *
-     * @param string $name Attribute OID or name
-     *
-     * @throws \RuntimeException If attribute cannot be resolved
-     *
-     * @return AttributeValue
-     */
-    public function firstValueOf(string $name): AttributeValue
-    {
-        $oid = AttributeType::attrNameToOID($name);
-        foreach ($this->_rdns as $rdn) {
-            $tvs = $rdn->allOf($oid);
-            if (count($tvs) > 1) {
-                throw new \RangeException("RDN with multiple {$name} attributes.");
-            }
-            if (1 == count($tvs)) {
-                return $tvs[0]->value();
-            }
-        }
-        throw new \RangeException("Attribute {$name} not found.");
-    }
-
-    /**
-     * @see \Countable::count()
-     *
-     * @return int
-     */
-    public function count(): int
-    {
-        return count($this->_rdns);
-    }
-
-    /**
-     * Get the number of attributes of given type.
-     *
-     * @param string $name Attribute OID or name
-     *
-     * @return int
-     */
-    public function countOfType(string $name): int
-    {
-        $oid = AttributeType::attrNameToOID($name);
-        return array_sum(
-            array_map(
-                function (RDN $rdn) use ($oid) {
-                    return count($rdn->allOf($oid));
-                }, $this->_rdns));
-    }
-
-    /**
-     * @see \IteratorAggregate::getIterator()
-     *
-     * @return \ArrayIterator
-     */
-    public function getIterator(): \ArrayIterator
-    {
-        return new \ArrayIterator($this->_rdns);
-    }
+	/**
+	 * Relative distinguished name components.
+	 *
+	 * @var RDN[]
+	 */
+	protected $_rdns;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param RDN ...$rdns RDN components
+	 */
+	public function __construct(RDN ...$rdns)
+	{
+		$this->_rdns = $rdns;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return $this->toString();
+	}
+
+	/**
+	 * Initialize from ASN.1.
+	 *
+	 * @param Sequence $seq
+	 *
+	 * @return self
+	 */
+	public static function fromASN1(Sequence $seq): self
+	{
+		$rdns = array_map(
+			function (UnspecifiedType $el) {
+				return RDN::fromASN1($el->asSet());
+			}, $seq->elements());
+		return new self(...$rdns);
+	}
+
+	/**
+	 * Initialize from distinguished name string.
+	 *
+	 * @see https://tools.ietf.org/html/rfc1779
+	 *
+	 * @param string $str
+	 *
+	 * @return self
+	 */
+	public static function fromString(string $str): self
+	{
+		$rdns = [];
+		foreach (DNParser::parseString($str) as $nameComponent) {
+			$attribs = [];
+			foreach ($nameComponent as [$name, $val]) {
+				$type = AttributeType::fromName($name);
+				// hexstrings are parsed to ASN.1 elements
+				if ($val instanceof Element) {
+					$el = $val;
+				} else {
+					$el = AttributeType::asn1StringForType($type->oid(), $val);
+				}
+				$value = AttributeValue::fromASN1ByOID($type->oid(),
+					$el->asUnspecified());
+				$attribs[] = new AttributeTypeAndValue($type, $value);
+			}
+			$rdns[] = new RDN(...$attribs);
+		}
+		return new self(...$rdns);
+	}
+
+	/**
+	 * Generate ASN.1 structure.
+	 *
+	 * @return Sequence
+	 */
+	public function toASN1(): Sequence
+	{
+		$elements = array_map(
+			function (RDN $rdn) {
+				return $rdn->toASN1();
+			}, $this->_rdns);
+		return new Sequence(...$elements);
+	}
+
+	/**
+	 * Get distinguised name string conforming to RFC 2253.
+	 *
+	 * @see https://tools.ietf.org/html/rfc2253#section-2.1
+	 *
+	 * @return string
+	 */
+	public function toString(): string
+	{
+		$parts = array_map(
+			function (RDN $rdn) {
+				return $rdn->toString();
+			}, array_reverse($this->_rdns));
+		return implode(',', $parts);
+	}
+
+	/**
+	 * Whether name is semantically equal to other.
+	 *
+	 * Comparison conforms to RFC 4518 string preparation algorithm.
+	 *
+	 * @see https://tools.ietf.org/html/rfc4518
+	 *
+	 * @param Name $other Object to compare to
+	 *
+	 * @return bool
+	 */
+	public function equals(Name $other): bool
+	{
+		// if RDN count doesn't match
+		if (count($this) != count($other)) {
+			return false;
+		}
+		for ($i = count($this) - 1; $i >= 0; --$i) {
+			$rdn1 = $this->_rdns[$i];
+			$rdn2 = $other->_rdns[$i];
+			if (!$rdn1->equals($rdn2)) {
+				return false;
+			}
+		}
+		return true;
+	}
+
+	/**
+	 * Get all RDN objects.
+	 *
+	 * @return RDN[]
+	 */
+	public function all(): array
+	{
+		return $this->_rdns;
+	}
+
+	/**
+	 * Get the first AttributeValue of given type.
+	 *
+	 * Relative name components shall be traversed in encoding order, which is
+	 * reversed in regards to the string representation.
+	 * Multi-valued RDN with multiple attributes of the requested type is
+	 * ambiguous and shall throw an exception.
+	 *
+	 * @param string $name Attribute OID or name
+	 *
+	 * @throws \RuntimeException If attribute cannot be resolved
+	 *
+	 * @return AttributeValue
+	 */
+	public function firstValueOf(string $name): AttributeValue
+	{
+		$oid = AttributeType::attrNameToOID($name);
+		foreach ($this->_rdns as $rdn) {
+			$tvs = $rdn->allOf($oid);
+			if (count($tvs) > 1) {
+				throw new \RangeException("RDN with multiple {$name} attributes.");
+			}
+			if (1 == count($tvs)) {
+				return $tvs[0]->value();
+			}
+		}
+		throw new \RangeException("Attribute {$name} not found.");
+	}
+
+	/**
+	 * @see \Countable::count()
+	 *
+	 * @return int
+	 */
+	public function count(): int
+	{
+		return count($this->_rdns);
+	}
+
+	/**
+	 * Get the number of attributes of given type.
+	 *
+	 * @param string $name Attribute OID or name
+	 *
+	 * @return int
+	 */
+	public function countOfType(string $name): int
+	{
+		$oid = AttributeType::attrNameToOID($name);
+		return array_sum(
+			array_map(
+				function (RDN $rdn) use ($oid) {
+					return count($rdn->allOf($oid));
+				}, $this->_rdns));
+	}
+
+	/**
+	 * @see \IteratorAggregate::getIterator()
+	 *
+	 * @return \ArrayIterator
+	 */
+	public function getIterator(): \ArrayIterator
+	{
+		return new \ArrayIterator($this->_rdns);
+	}
 }

lib/X501/ASN1/AttributeValue/LocalityNameValue.php

Indentation +12 added lines, -12 removed lines

@@ -14,16 +14,16 @@
  */
 class LocalityNameValue extends DirectoryString
 {
-    /**
-     * Constructor.
-     *
-     * @param string $value      String value
-     * @param int    $string_tag Syntax choice
-     */
-    public function __construct(string $value,
-        int $string_tag = DirectoryString::UTF8)
-    {
-        $this->_oid = AttributeType::OID_LOCALITY_NAME;
-        parent::__construct($value, $string_tag);
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string $value      String value
+	 * @param int    $string_tag Syntax choice
+	 */
+	public function __construct(string $value,
+		int $string_tag = DirectoryString::UTF8)
+	{
+		$this->_oid = AttributeType::OID_LOCALITY_NAME;
+		parent::__construct($value, $string_tag);
+	}
 }

lib/X501/ASN1/AttributeValue/NameValue.php

Indentation +12 added lines, -12 removed lines

@@ -14,16 +14,16 @@
  */
 class NameValue extends DirectoryString
 {
-    /**
-     * Constructor.
-     *
-     * @param string $value      String value
-     * @param int    $string_tag Syntax choice
-     */
-    public function __construct(string $value,
-        int $string_tag = DirectoryString::UTF8)
-    {
-        $this->_oid = AttributeType::OID_NAME;
-        parent::__construct($value, $string_tag);
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string $value      String value
+	 * @param int    $string_tag Syntax choice
+	 */
+	public function __construct(string $value,
+		int $string_tag = DirectoryString::UTF8)
+	{
+		$this->_oid = AttributeType::OID_NAME;
+		parent::__construct($value, $string_tag);
+	}
 }

lib/X501/ASN1/AttributeValue/OrganizationNameValue.php

Indentation +12 added lines, -12 removed lines

@@ -14,16 +14,16 @@
  */
 class OrganizationNameValue extends DirectoryString
 {
-    /**
-     * Constructor.
-     *
-     * @param string $value      String value
-     * @param int    $string_tag Syntax choice
-     */
-    public function __construct(string $value,
-        int $string_tag = DirectoryString::UTF8)
-    {
-        $this->_oid = AttributeType::OID_ORGANIZATION_NAME;
-        parent::__construct($value, $string_tag);
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string $value      String value
+	 * @param int    $string_tag Syntax choice
+	 */
+	public function __construct(string $value,
+		int $string_tag = DirectoryString::UTF8)
+	{
+		$this->_oid = AttributeType::OID_ORGANIZATION_NAME;
+		parent::__construct($value, $string_tag);
+	}
 }

lib/X501/ASN1/AttributeValue/DescriptionValue.php

Indentation +12 added lines, -12 removed lines

@@ -14,16 +14,16 @@
  */
 class DescriptionValue extends DirectoryString
 {
-    /**
-     * Constructor.
-     *
-     * @param string $value      String value
-     * @param int    $string_tag Syntax choice
-     */
-    public function __construct(string $value,
-        int $string_tag = DirectoryString::UTF8)
-    {
-        $this->_oid = AttributeType::OID_DESCRIPTION;
-        parent::__construct($value, $string_tag);
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string $value      String value
+	 * @param int    $string_tag Syntax choice
+	 */
+	public function __construct(string $value,
+		int $string_tag = DirectoryString::UTF8)
+	{
+		$this->_oid = AttributeType::OID_DESCRIPTION;
+		parent::__construct($value, $string_tag);
+	}
 }

lib/X501/ASN1/AttributeValue/GivenNameValue.php

Indentation +12 added lines, -12 removed lines

@@ -14,16 +14,16 @@
  */
 class GivenNameValue extends DirectoryString
 {
-    /**
-     * Constructor.
-     *
-     * @param string $value      String value
-     * @param int    $string_tag Syntax choice
-     */
-    public function __construct(string $value,
-        int $string_tag = DirectoryString::UTF8)
-    {
-        $this->_oid = AttributeType::OID_GIVEN_NAME;
-        parent::__construct($value, $string_tag);
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string $value      String value
+	 * @param int    $string_tag Syntax choice
+	 */
+	public function __construct(string $value,
+		int $string_tag = DirectoryString::UTF8)
+	{
+		$this->_oid = AttributeType::OID_GIVEN_NAME;
+		parent::__construct($value, $string_tag);
+	}
 }

lib/X501/ASN1/AttributeValue/OrganizationalUnitNameValue.php

Indentation +12 added lines, -12 removed lines

@@ -14,16 +14,16 @@
  */
 class OrganizationalUnitNameValue extends DirectoryString
 {
-    /**
-     * Constructor.
-     *
-     * @param string $value      String value
-     * @param int    $string_tag Syntax choice
-     */
-    public function __construct(string $value,
-        int $string_tag = DirectoryString::UTF8)
-    {
-        $this->_oid = AttributeType::OID_ORGANIZATIONAL_UNIT_NAME;
-        parent::__construct($value, $string_tag);
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string $value      String value
+	 * @param int    $string_tag Syntax choice
+	 */
+	public function __construct(string $value,
+		int $string_tag = DirectoryString::UTF8)
+	{
+		$this->_oid = AttributeType::OID_ORGANIZATIONAL_UNIT_NAME;
+		parent::__construct($value, $string_tag);
+	}
 }

lib/X501/ASN1/AttributeValue/AttributeValue.php

Indentation +153 added lines, -153 removed lines

@@ -18,157 +18,157 @@
  */
 abstract class AttributeValue
 {
-    /**
-     * Mapping from attribute type OID to attribute value class name.
-     *
-     * @internal
-     *
-     * @var array
-     */
-    const MAP_OID_TO_CLASS = [
-        AttributeType::OID_COMMON_NAME => CommonNameValue::class,
-        AttributeType::OID_SURNAME => SurnameValue::class,
-        AttributeType::OID_SERIAL_NUMBER => SerialNumberValue::class,
-        AttributeType::OID_COUNTRY_NAME => CountryNameValue::class,
-        AttributeType::OID_LOCALITY_NAME => LocalityNameValue::class,
-        AttributeType::OID_STATE_OR_PROVINCE_NAME => StateOrProvinceNameValue::class,
-        AttributeType::OID_ORGANIZATION_NAME => OrganizationNameValue::class,
-        AttributeType::OID_ORGANIZATIONAL_UNIT_NAME => OrganizationalUnitNameValue::class,
-        AttributeType::OID_TITLE => TitleValue::class,
-        AttributeType::OID_DESCRIPTION => DescriptionValue::class,
-        AttributeType::OID_NAME => NameValue::class,
-        AttributeType::OID_GIVEN_NAME => GivenNameValue::class,
-        AttributeType::OID_PSEUDONYM => PseudonymValue::class,
-    ];
-
-    /**
-     * OID of the attribute type.
-     *
-     * @var string
-     */
-    protected $_oid;
-
-    /**
-     * Get attribute value as an UTF-8 encoded string.
-     *
-     * @return string
-     */
-    public function __toString()
-    {
-        return $this->_transcodedString();
-    }
-
-    /**
-     * Generate ASN.1 element.
-     *
-     * @return Element
-     */
-    abstract public function toASN1(): Element;
-
-    /**
-     * Get attribute value as a string.
-     *
-     * @return string
-     */
-    abstract public function stringValue(): string;
-
-    /**
-     * Get matching rule for equality comparison.
-     *
-     * @return MatchingRule
-     */
-    abstract public function equalityMatchingRule(): MatchingRule;
-
-    /**
-     * Get attribute value as a string conforming to RFC 2253.
-     *
-     * @see https://tools.ietf.org/html/rfc2253#section-2.4
-     *
-     * @return string
-     */
-    abstract public function rfc2253String(): string;
-
-    /**
-     * Initialize from ASN.1.
-     *
-     * @param UnspecifiedType $el
-     *
-     * @return self
-     */
-    public static function fromASN1(UnspecifiedType $el): AttributeValue
-    {
-        throw new \BadMethodCallException(
-            'ASN.1 parsing must be implemented in a concrete class.');
-    }
-
-    /**
-     * Initialize from ASN.1 with given OID hint.
-     *
-     * @param string          $oid Attribute's OID
-     * @param UnspecifiedType $el
-     *
-     * @return self
-     */
-    public static function fromASN1ByOID(string $oid, UnspecifiedType $el): self
-    {
-        if (!array_key_exists($oid, self::MAP_OID_TO_CLASS)) {
-            return new UnknownAttributeValue($oid, $el->asElement());
-        }
-        $cls = self::MAP_OID_TO_CLASS[$oid];
-        return $cls::fromASN1($el);
-    }
-
-    /**
-     * Initialize from another AttributeValue.
-     *
-     * This method is generally used to cast UnknownAttributeValue to
-     * specific object when class is declared outside this package.
-     *
-     * @param self $obj Instance of AttributeValue
-     *
-     * @return self
-     */
-    public static function fromSelf(self $obj): self
-    {
-        return static::fromASN1($obj->toASN1()->asUnspecified());
-    }
-
-    /**
-     * Get attribute type's OID.
-     *
-     * @return string
-     */
-    public function oid(): string
-    {
-        return $this->_oid;
-    }
-
-    /**
-     * Get Attribute object with this as a single value.
-     *
-     * @return Attribute
-     */
-    public function toAttribute(): Attribute
-    {
-        return Attribute::fromAttributeValues($this);
-    }
-
-    /**
-     * Get AttributeTypeAndValue object with this as a value.
-     *
-     * @return AttributeTypeAndValue
-     */
-    public function toAttributeTypeAndValue(): AttributeTypeAndValue
-    {
-        return AttributeTypeAndValue::fromAttributeValue($this);
-    }
-
-    /**
-     * Get attribute value as an UTF-8 string conforming to RFC 4518.
-     *
-     * @see https://tools.ietf.org/html/rfc4518#section-2.1
-     *
-     * @return string
-     */
-    abstract protected function _transcodedString(): string;
+	/**
+	 * Mapping from attribute type OID to attribute value class name.
+	 *
+	 * @internal
+	 *
+	 * @var array
+	 */
+	const MAP_OID_TO_CLASS = [
+		AttributeType::OID_COMMON_NAME => CommonNameValue::class,
+		AttributeType::OID_SURNAME => SurnameValue::class,
+		AttributeType::OID_SERIAL_NUMBER => SerialNumberValue::class,
+		AttributeType::OID_COUNTRY_NAME => CountryNameValue::class,
+		AttributeType::OID_LOCALITY_NAME => LocalityNameValue::class,
+		AttributeType::OID_STATE_OR_PROVINCE_NAME => StateOrProvinceNameValue::class,
+		AttributeType::OID_ORGANIZATION_NAME => OrganizationNameValue::class,
+		AttributeType::OID_ORGANIZATIONAL_UNIT_NAME => OrganizationalUnitNameValue::class,
+		AttributeType::OID_TITLE => TitleValue::class,
+		AttributeType::OID_DESCRIPTION => DescriptionValue::class,
+		AttributeType::OID_NAME => NameValue::class,
+		AttributeType::OID_GIVEN_NAME => GivenNameValue::class,
+		AttributeType::OID_PSEUDONYM => PseudonymValue::class,
+	];
+
+	/**
+	 * OID of the attribute type.
+	 *
+	 * @var string
+	 */
+	protected $_oid;
+
+	/**
+	 * Get attribute value as an UTF-8 encoded string.
+	 *
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return $this->_transcodedString();
+	}
+
+	/**
+	 * Generate ASN.1 element.
+	 *
+	 * @return Element
+	 */
+	abstract public function toASN1(): Element;
+
+	/**
+	 * Get attribute value as a string.
+	 *
+	 * @return string
+	 */
+	abstract public function stringValue(): string;
+
+	/**
+	 * Get matching rule for equality comparison.
+	 *
+	 * @return MatchingRule
+	 */
+	abstract public function equalityMatchingRule(): MatchingRule;
+
+	/**
+	 * Get attribute value as a string conforming to RFC 2253.
+	 *
+	 * @see https://tools.ietf.org/html/rfc2253#section-2.4
+	 *
+	 * @return string
+	 */
+	abstract public function rfc2253String(): string;
+
+	/**
+	 * Initialize from ASN.1.
+	 *
+	 * @param UnspecifiedType $el
+	 *
+	 * @return self
+	 */
+	public static function fromASN1(UnspecifiedType $el): AttributeValue
+	{
+		throw new \BadMethodCallException(
+			'ASN.1 parsing must be implemented in a concrete class.');
+	}
+
+	/**
+	 * Initialize from ASN.1 with given OID hint.
+	 *
+	 * @param string          $oid Attribute's OID
+	 * @param UnspecifiedType $el
+	 *
+	 * @return self
+	 */
+	public static function fromASN1ByOID(string $oid, UnspecifiedType $el): self
+	{
+		if (!array_key_exists($oid, self::MAP_OID_TO_CLASS)) {
+			return new UnknownAttributeValue($oid, $el->asElement());
+		}
+		$cls = self::MAP_OID_TO_CLASS[$oid];
+		return $cls::fromASN1($el);
+	}
+
+	/**
+	 * Initialize from another AttributeValue.
+	 *
+	 * This method is generally used to cast UnknownAttributeValue to
+	 * specific object when class is declared outside this package.
+	 *
+	 * @param self $obj Instance of AttributeValue
+	 *
+	 * @return self
+	 */
+	public static function fromSelf(self $obj): self
+	{
+		return static::fromASN1($obj->toASN1()->asUnspecified());
+	}
+
+	/**
+	 * Get attribute type's OID.
+	 *
+	 * @return string
+	 */
+	public function oid(): string
+	{
+		return $this->_oid;
+	}
+
+	/**
+	 * Get Attribute object with this as a single value.
+	 *
+	 * @return Attribute
+	 */
+	public function toAttribute(): Attribute
+	{
+		return Attribute::fromAttributeValues($this);
+	}
+
+	/**
+	 * Get AttributeTypeAndValue object with this as a value.
+	 *
+	 * @return AttributeTypeAndValue
+	 */
+	public function toAttributeTypeAndValue(): AttributeTypeAndValue
+	{
+		return AttributeTypeAndValue::fromAttributeValue($this);
+	}
+
+	/**
+	 * Get attribute value as an UTF-8 string conforming to RFC 4518.
+	 *
+	 * @see https://tools.ietf.org/html/rfc4518#section-2.1
+	 *
+	 * @return string
+	 */
+	abstract protected function _transcodedString(): string;
 }