sop / asn1

lib/ASN1/Type/TaggedType.php

Indentation +72 added lines, -72 removed lines

@@ -14,79 +14,79 @@
  */
 abstract class TaggedType extends Element
 {
-    /**
-     * Check whether element supports explicit tagging.
-     *
-     * @param null|int $expectedTag Optional outer tag expectation
-     *
-     * @throws \UnexpectedValueException If expectation fails
-     *
-     * @return ExplicitTagging
-     */
-    public function expectExplicit(?int $expectedTag = null): ExplicitTagging
-    {
-        $el = $this;
-        if (!$el instanceof ExplicitTagging) {
-            throw new \UnexpectedValueException(
-                "Element doesn't implement explicit tagging.");
-        }
-        if (isset($expectedTag)) {
-            $el->expectTagged($expectedTag);
-        }
-        return $el;
-    }
+	/**
+	 * Check whether element supports explicit tagging.
+	 *
+	 * @param null|int $expectedTag Optional outer tag expectation
+	 *
+	 * @throws \UnexpectedValueException If expectation fails
+	 *
+	 * @return ExplicitTagging
+	 */
+	public function expectExplicit(?int $expectedTag = null): ExplicitTagging
+	{
+		$el = $this;
+		if (!$el instanceof ExplicitTagging) {
+			throw new \UnexpectedValueException(
+				"Element doesn't implement explicit tagging.");
+		}
+		if (isset($expectedTag)) {
+			$el->expectTagged($expectedTag);
+		}
+		return $el;
+	}
 
-    /**
-     * Get the wrapped inner element employing explicit tagging.
-     *
-     * @param null|int $expectedTag Optional outer tag expectation
-     *
-     * @throws \UnexpectedValueException If expectation fails
-     *
-     * @return UnspecifiedType
-     */
-    public function asExplicit(?int $expectedTag = null): UnspecifiedType
-    {
-        return $this->expectExplicit($expectedTag)->explicit();
-    }
+	/**
+	 * Get the wrapped inner element employing explicit tagging.
+	 *
+	 * @param null|int $expectedTag Optional outer tag expectation
+	 *
+	 * @throws \UnexpectedValueException If expectation fails
+	 *
+	 * @return UnspecifiedType
+	 */
+	public function asExplicit(?int $expectedTag = null): UnspecifiedType
+	{
+		return $this->expectExplicit($expectedTag)->explicit();
+	}
 
-    /**
-     * Check whether element supports implicit tagging.
-     *
-     * @param null|int $expectedTag Optional outer tag expectation
-     *
-     * @throws \UnexpectedValueException If expectation fails
-     *
-     * @return ImplicitTagging
-     */
-    public function expectImplicit(?int $expectedTag = null): ImplicitTagging
-    {
-        $el = $this;
-        if (!$el instanceof ImplicitTagging) {
-            throw new \UnexpectedValueException(
-                "Element doesn't implement implicit tagging.");
-        }
-        if (isset($expectedTag)) {
-            $el->expectTagged($expectedTag);
-        }
-        return $el;
-    }
+	/**
+	 * Check whether element supports implicit tagging.
+	 *
+	 * @param null|int $expectedTag Optional outer tag expectation
+	 *
+	 * @throws \UnexpectedValueException If expectation fails
+	 *
+	 * @return ImplicitTagging
+	 */
+	public function expectImplicit(?int $expectedTag = null): ImplicitTagging
+	{
+		$el = $this;
+		if (!$el instanceof ImplicitTagging) {
+			throw new \UnexpectedValueException(
+				"Element doesn't implement implicit tagging.");
+		}
+		if (isset($expectedTag)) {
+			$el->expectTagged($expectedTag);
+		}
+		return $el;
+	}
 
-    /**
-     * Get the wrapped inner element employing implicit tagging.
-     *
-     * @param int      $tag           Type tag of the inner element
-     * @param null|int $expectedTag   Optional outer tag expectation
-     * @param int      $expectedClass Optional inner type class expectation
-     *
-     * @throws \UnexpectedValueException If expectation fails
-     *
-     * @return UnspecifiedType
-     */
-    public function asImplicit(int $tag, ?int $expectedTag = null,
-        int $expectedClass = Identifier::CLASS_UNIVERSAL): UnspecifiedType
-    {
-        return $this->expectImplicit($expectedTag)->implicit($tag,
-            $expectedClass);
-    }
+	/**
+	 * Get the wrapped inner element employing implicit tagging.
+	 *
+	 * @param int      $tag           Type tag of the inner element
+	 * @param null|int $expectedTag   Optional outer tag expectation
+	 * @param int      $expectedClass Optional inner type class expectation
+	 *
+	 * @throws \UnexpectedValueException If expectation fails
+	 *
+	 * @return UnspecifiedType
+	 */
+	public function asImplicit(int $tag, ?int $expectedTag = null,
+		int $expectedClass = Identifier::CLASS_UNIVERSAL): UnspecifiedType
+	{
+		return $this->expectImplicit($expectedTag)->implicit($tag,
+			$expectedClass);
+	}
 }

lib/ASN1/Type/StringType.php

Indentation +43 added lines, -43 removed lines

@@ -11,50 +11,50 @@
  */
 abstract class StringType extends Element
 {
-    /**
-     * String value.
-     *
-     * @var string
-     */
-    protected $_string;
+	/**
+	 * String value.
+	 *
+	 * @var string
+	 */
+	protected $_string;
 
-    /**
-     * Constructor.
-     *
-     * @param string $string
-     *
-     * @throws \InvalidArgumentException
-     */
-    public function __construct(string $string)
-    {
-        if (!$this->_validateString($string)) {
-            throw new \InvalidArgumentException(
-                sprintf('Not a valid %s string.',
-                    self::tagToName($this->_typeTag)));
-        }
-        $this->_string = $string;
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string $string
+	 *
+	 * @throws \InvalidArgumentException
+	 */
+	public function __construct(string $string)
+	{
+		if (!$this->_validateString($string)) {
+			throw new \InvalidArgumentException(
+				sprintf('Not a valid %s string.',
+					self::tagToName($this->_typeTag)));
+		}
+		$this->_string = $string;
+	}
 
-    /**
-     * Get the string value.
-     *
-     * @return string
-     */
-    public function string(): string
-    {
-        return $this->_string;
-    }
+	/**
+	 * Get the string value.
+	 *
+	 * @return string
+	 */
+	public function string(): string
+	{
+		return $this->_string;
+	}
 
-    /**
-     * Check whether string is valid for the concrete type.
-     *
-     * @param string $string
-     *
-     * @return bool
-     */
-    protected function _validateString(string $string): bool
-    {
-        // Override in derived classes
-        return true;
-    }
+	/**
+	 * Check whether string is valid for the concrete type.
+	 *
+	 * @param string $string
+	 *
+	 * @return bool
+	 */
+	protected function _validateString(string $string): bool
+	{
+		// Override in derived classes
+		return true;
+	}
 }

lib/ASN1/DERData.php

Indentation +65 added lines, -65 removed lines

@@ -14,76 +14,76 @@
  */
 class DERData extends Element
 {
-    /**
-     * DER encoded data.
-     *
-     * @var string
-     */
-    protected $_der;
+	/**
+	 * DER encoded data.
+	 *
+	 * @var string
+	 */
+	protected $_der;
 
-    /**
-     * Identifier of the underlying type.
-     *
-     * @var Identifier
-     */
-    protected $_identifier;
+	/**
+	 * Identifier of the underlying type.
+	 *
+	 * @var Identifier
+	 */
+	protected $_identifier;
 
-    /**
-     * Offset to the content in DER data.
-     *
-     * @var int
-     */
-    protected $_contentOffset = 0;
+	/**
+	 * Offset to the content in DER data.
+	 *
+	 * @var int
+	 */
+	protected $_contentOffset = 0;
 
-    /**
-     * Constructor.
-     *
-     * @param string $data DER encoded data
-     *
-     * @throws \Sop\ASN1\Exception\DecodeException If data does not adhere to DER
-     */
-    public function __construct(string $data)
-    {
-        $this->_identifier = Identifier::fromDER($data, $this->_contentOffset);
-        // check that length encoding is valid
-        Length::expectFromDER($data, $this->_contentOffset);
-        $this->_der = $data;
-        $this->_typeTag = $this->_identifier->intTag();
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string $data DER encoded data
+	 *
+	 * @throws \Sop\ASN1\Exception\DecodeException If data does not adhere to DER
+	 */
+	public function __construct(string $data)
+	{
+		$this->_identifier = Identifier::fromDER($data, $this->_contentOffset);
+		// check that length encoding is valid
+		Length::expectFromDER($data, $this->_contentOffset);
+		$this->_der = $data;
+		$this->_typeTag = $this->_identifier->intTag();
+	}
 
-    /**
-     * {@inheritdoc}
-     */
-    public function typeClass(): int
-    {
-        return $this->_identifier->typeClass();
-    }
+	/**
+	 * {@inheritdoc}
+	 */
+	public function typeClass(): int
+	{
+		return $this->_identifier->typeClass();
+	}
 
-    /**
-     * {@inheritdoc}
-     */
-    public function isConstructed(): bool
-    {
-        return $this->_identifier->isConstructed();
-    }
+	/**
+	 * {@inheritdoc}
+	 */
+	public function isConstructed(): bool
+	{
+		return $this->_identifier->isConstructed();
+	}
 
-    /**
-     * {@inheritdoc}
-     */
-    public function toDER(): string
-    {
-        return $this->_der;
-    }
+	/**
+	 * {@inheritdoc}
+	 */
+	public function toDER(): string
+	{
+		return $this->_der;
+	}
 
-    /**
-     * {@inheritdoc}
-     */
-    protected function _encodedContentDER(): string
-    {
-        // if there's no content payload
-        if (strlen($this->_der) == $this->_contentOffset) {
-            return '';
-        }
-        return substr($this->_der, $this->_contentOffset);
-    }
+	/**
+	 * {@inheritdoc}
+	 */
+	protected function _encodedContentDER(): string
+	{
+		// if there's no content payload
+		if (strlen($this->_der) == $this->_contentOffset) {
+			return '';
+		}
+		return substr($this->_der, $this->_contentOffset);
+	}
 }

lib/ASN1/Util/BigInt.php

Indentation +95 added lines, -95 removed lines

@@ -6,107 +6,107 @@
 
 class BigInt
 {
-    /**
-     * Number as a base10 integer string.
-     *
-     * @var string
-     */
-    private $_num;
+	/**
+	 * Number as a base10 integer string.
+	 *
+	 * @var string
+	 */
+	private $_num;
 
-    /**
-     * Number as an integer type.
-     *
-     * @internal Lazily initialized
-     *
-     * @var null|int
-     */
-    private $_intNum;
+	/**
+	 * Number as an integer type.
+	 *
+	 * @internal Lazily initialized
+	 *
+	 * @var null|int
+	 */
+	private $_intNum;
 
-    /**
-     * Constructor.
-     *
-     * @param int|string $num
-     */
-    public function __construct($num)
-    {
-        $this->_num = strval($num);
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param int|string $num
+	 */
+	public function __construct($num)
+	{
+		$this->_num = strval($num);
+	}
 
-    /**
-     * @return string
-     */
-    public function __toString()
-    {
-        return $this->base10();
-    }
+	/**
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return $this->base10();
+	}
 
-    /**
-     * Get the number as a base10 integer string.
-     *
-     * @return string
-     */
-    public function base10(): string
-    {
-        return $this->_num;
-    }
+	/**
+	 * Get the number as a base10 integer string.
+	 *
+	 * @return string
+	 */
+	public function base10(): string
+	{
+		return $this->_num;
+	}
 
-    /**
-     * Get the number as an integer.
-     *
-     * @throws \RuntimeException If number overflows integer size
-     *
-     * @return int
-     */
-    public function intVal(): int
-    {
-        if (!isset($this->_intNum)) {
-            $num = gmp_init($this->_num, 10);
-            if (gmp_cmp($num, $this->_intMaxGmp()) > 0) {
-                throw new \RuntimeException('Integer overflow.');
-            }
-            if (gmp_cmp($num, $this->_intMinGmp()) < 0) {
-                throw new \RuntimeException('Integer underflow.');
-            }
-            $this->_intNum = gmp_intval($num);
-        }
-        return $this->_intNum;
-    }
+	/**
+	 * Get the number as an integer.
+	 *
+	 * @throws \RuntimeException If number overflows integer size
+	 *
+	 * @return int
+	 */
+	public function intVal(): int
+	{
+		if (!isset($this->_intNum)) {
+			$num = gmp_init($this->_num, 10);
+			if (gmp_cmp($num, $this->_intMaxGmp()) > 0) {
+				throw new \RuntimeException('Integer overflow.');
+			}
+			if (gmp_cmp($num, $this->_intMinGmp()) < 0) {
+				throw new \RuntimeException('Integer underflow.');
+			}
+			$this->_intNum = gmp_intval($num);
+		}
+		return $this->_intNum;
+	}
 
-    /**
-     * Get the number as a GMP object.
-     *
-     * @return \GMP
-     */
-    public function gmpObj(): \GMP
-    {
-        return gmp_init($this->_num, 10);
-    }
+	/**
+	 * Get the number as a GMP object.
+	 *
+	 * @return \GMP
+	 */
+	public function gmpObj(): \GMP
+	{
+		return gmp_init($this->_num, 10);
+	}
 
-    /**
-     * Get the maximum integer value.
-     *
-     * @return \GMP
-     */
-    private function _intMaxGmp(): \GMP
-    {
-        static $gmp;
-        if (!isset($gmp)) {
-            $gmp = gmp_init(PHP_INT_MAX, 10);
-        }
-        return $gmp;
-    }
+	/**
+	 * Get the maximum integer value.
+	 *
+	 * @return \GMP
+	 */
+	private function _intMaxGmp(): \GMP
+	{
+		static $gmp;
+		if (!isset($gmp)) {
+			$gmp = gmp_init(PHP_INT_MAX, 10);
+		}
+		return $gmp;
+	}
 
-    /**
-     * Get the minimum integer value.
-     *
-     * @return \GMP
-     */
-    private function _intMinGmp(): \GMP
-    {
-        static $gmp;
-        if (!isset($gmp)) {
-            $gmp = gmp_init(PHP_INT_MIN, 10);
-        }
-        return $gmp;
-    }
+	/**
+	 * Get the minimum integer value.
+	 *
+	 * @return \GMP
+	 */
+	private function _intMinGmp(): \GMP
+	{
+		static $gmp;
+		if (!isset($gmp)) {
+			$gmp = gmp_init(PHP_INT_MIN, 10);
+		}
+		return $gmp;
+	}
 }

lib/ASN1/Component/Identifier.php

Indentation +275 added lines, -275 removed lines

@@ -13,301 +13,301 @@
  */
 class Identifier implements Encodable
 {
-    // Type class enumerations
-    const CLASS_UNIVERSAL = 0b00;
-    const CLASS_APPLICATION = 0b01;
-    const CLASS_CONTEXT_SPECIFIC = 0b10;
-    const CLASS_PRIVATE = 0b11;
+	// Type class enumerations
+	const CLASS_UNIVERSAL = 0b00;
+	const CLASS_APPLICATION = 0b01;
+	const CLASS_CONTEXT_SPECIFIC = 0b10;
+	const CLASS_PRIVATE = 0b11;
 
-    /**
-     * Mapping from type class to human readable name.
-     *
-     * @internal
-     *
-     * @var array
-     */
-    const MAP_CLASS_TO_NAME = [
-        self::CLASS_UNIVERSAL => 'UNIVERSAL',
-        self::CLASS_APPLICATION => 'APPLICATION',
-        self::CLASS_CONTEXT_SPECIFIC => 'CONTEXT SPECIFIC',
-        self::CLASS_PRIVATE => 'PRIVATE',
-    ];
+	/**
+	 * Mapping from type class to human readable name.
+	 *
+	 * @internal
+	 *
+	 * @var array
+	 */
+	const MAP_CLASS_TO_NAME = [
+		self::CLASS_UNIVERSAL => 'UNIVERSAL',
+		self::CLASS_APPLICATION => 'APPLICATION',
+		self::CLASS_CONTEXT_SPECIFIC => 'CONTEXT SPECIFIC',
+		self::CLASS_PRIVATE => 'PRIVATE',
+	];
 
-    // P/C enumerations
-    const PRIMITIVE = 0b0;
-    const CONSTRUCTED = 0b1;
+	// P/C enumerations
+	const PRIMITIVE = 0b0;
+	const CONSTRUCTED = 0b1;
 
-    /**
-     * Type class.
-     *
-     * @var int
-     */
-    private $_class;
+	/**
+	 * Type class.
+	 *
+	 * @var int
+	 */
+	private $_class;
 
-    /**
-     * Primitive or Constructed.
-     *
-     * @var int
-     */
-    private $_pc;
+	/**
+	 * Primitive or Constructed.
+	 *
+	 * @var int
+	 */
+	private $_pc;
 
-    /**
-     * Content type tag.
-     *
-     * @var BigInt
-     */
-    private $_tag;
+	/**
+	 * Content type tag.
+	 *
+	 * @var BigInt
+	 */
+	private $_tag;
 
-    /**
-     * Constructor.
-     *
-     * @param int        $class Type class
-     * @param int        $pc    Primitive / Constructed
-     * @param int|string $tag   Type tag number
-     */
-    public function __construct(int $class, int $pc, $tag)
-    {
-        $this->_class = 0b11 & $class;
-        $this->_pc = 0b1 & $pc;
-        $this->_tag = new BigInt($tag);
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param int        $class Type class
+	 * @param int        $pc    Primitive / Constructed
+	 * @param int|string $tag   Type tag number
+	 */
+	public function __construct(int $class, int $pc, $tag)
+	{
+		$this->_class = 0b11 & $class;
+		$this->_pc = 0b1 & $pc;
+		$this->_tag = new BigInt($tag);
+	}
 
-    /**
-     * Decode identifier component from DER data.
-     *
-     * @param string   $data   DER encoded data
-     * @param null|int $offset Reference to the variable that contains offset
-     *                         into the data where to start parsing.
-     *                         Variable is updated to the offset next to the
-     *                         parsed identifier. If null, start from offset 0.
-     *
-     * @throws DecodeException If decoding fails
-     *
-     * @return self
-     */
-    public static function fromDER(string $data, int &$offset = null): Identifier
-    {
-        $idx = $offset ?? 0;
-        $datalen = strlen($data);
-        if ($idx >= $datalen) {
-            throw new DecodeException('Invalid offset.');
-        }
-        $byte = ord($data[$idx++]);
-        // bits 8 and 7 (class)
-        // 0 = universal, 1 = application, 2 = context-specific, 3 = private
-        $class = (0b11000000 & $byte) >> 6;
-        // bit 6 (0 = primitive / 1 = constructed)
-        $pc = (0b00100000 & $byte) >> 5;
-        // bits 5 to 1 (tag number)
-        $tag = (0b00011111 & $byte);
-        // long-form identifier
-        if (0x1f == $tag) {
-            $tag = self::_decodeLongFormTag($data, $idx);
-        }
-        if (isset($offset)) {
-            $offset = $idx;
-        }
-        return new self($class, $pc, $tag);
-    }
+	/**
+	 * Decode identifier component from DER data.
+	 *
+	 * @param string   $data   DER encoded data
+	 * @param null|int $offset Reference to the variable that contains offset
+	 *                         into the data where to start parsing.
+	 *                         Variable is updated to the offset next to the
+	 *                         parsed identifier. If null, start from offset 0.
+	 *
+	 * @throws DecodeException If decoding fails
+	 *
+	 * @return self
+	 */
+	public static function fromDER(string $data, int &$offset = null): Identifier
+	{
+		$idx = $offset ?? 0;
+		$datalen = strlen($data);
+		if ($idx >= $datalen) {
+			throw new DecodeException('Invalid offset.');
+		}
+		$byte = ord($data[$idx++]);
+		// bits 8 and 7 (class)
+		// 0 = universal, 1 = application, 2 = context-specific, 3 = private
+		$class = (0b11000000 & $byte) >> 6;
+		// bit 6 (0 = primitive / 1 = constructed)
+		$pc = (0b00100000 & $byte) >> 5;
+		// bits 5 to 1 (tag number)
+		$tag = (0b00011111 & $byte);
+		// long-form identifier
+		if (0x1f == $tag) {
+			$tag = self::_decodeLongFormTag($data, $idx);
+		}
+		if (isset($offset)) {
+			$offset = $idx;
+		}
+		return new self($class, $pc, $tag);
+	}
 
-    /**
-     * {@inheritdoc}
-     */
-    public function toDER(): string
-    {
-        $bytes = [];
-        $byte = $this->_class << 6 | $this->_pc << 5;
-        $tag = $this->_tag->gmpObj();
-        if ($tag < 0x1f) {
-            $bytes[] = $byte | $tag;
-        }
-        // long-form identifier
-        else {
-            $bytes[] = $byte | 0x1f;
-            $octets = [];
-            for (; $tag > 0; $tag >>= 7) {
-                array_push($octets, gmp_intval(0x80 | ($tag & 0x7f)));
-            }
-            // last octet has bit 8 set to zero
-            $octets[0] &= 0x7f;
-            foreach (array_reverse($octets) as $octet) {
-                $bytes[] = $octet;
-            }
-        }
-        return pack('C*', ...$bytes);
-    }
+	/**
+	 * {@inheritdoc}
+	 */
+	public function toDER(): string
+	{
+		$bytes = [];
+		$byte = $this->_class << 6 | $this->_pc << 5;
+		$tag = $this->_tag->gmpObj();
+		if ($tag < 0x1f) {
+			$bytes[] = $byte | $tag;
+		}
+		// long-form identifier
+		else {
+			$bytes[] = $byte | 0x1f;
+			$octets = [];
+			for (; $tag > 0; $tag >>= 7) {
+				array_push($octets, gmp_intval(0x80 | ($tag & 0x7f)));
+			}
+			// last octet has bit 8 set to zero
+			$octets[0] &= 0x7f;
+			foreach (array_reverse($octets) as $octet) {
+				$bytes[] = $octet;
+			}
+		}
+		return pack('C*', ...$bytes);
+	}
 
-    /**
-     * Get class of the type.
-     *
-     * @return int
-     */
-    public function typeClass(): int
-    {
-        return $this->_class;
-    }
+	/**
+	 * Get class of the type.
+	 *
+	 * @return int
+	 */
+	public function typeClass(): int
+	{
+		return $this->_class;
+	}
 
-    /**
-     * Get P/C.
-     *
-     * @return int
-     */
-    public function pc(): int
-    {
-        return $this->_pc;
-    }
+	/**
+	 * Get P/C.
+	 *
+	 * @return int
+	 */
+	public function pc(): int
+	{
+		return $this->_pc;
+	}
 
-    /**
-     * Get the tag number.
-     *
-     * @return string Base 10 integer string
-     */
-    public function tag(): string
-    {
-        return $this->_tag->base10();
-    }
+	/**
+	 * Get the tag number.
+	 *
+	 * @return string Base 10 integer string
+	 */
+	public function tag(): string
+	{
+		return $this->_tag->base10();
+	}
 
-    /**
-     * Get the tag as an integer.
-     *
-     * @return int
-     */
-    public function intTag(): int
-    {
-        return $this->_tag->intVal();
-    }
+	/**
+	 * Get the tag as an integer.
+	 *
+	 * @return int
+	 */
+	public function intTag(): int
+	{
+		return $this->_tag->intVal();
+	}
 
-    /**
-     * Check whether type is of an universal class.
-     *
-     * @return bool
-     */
-    public function isUniversal(): bool
-    {
-        return self::CLASS_UNIVERSAL === $this->_class;
-    }
+	/**
+	 * Check whether type is of an universal class.
+	 *
+	 * @return bool
+	 */
+	public function isUniversal(): bool
+	{
+		return self::CLASS_UNIVERSAL === $this->_class;
+	}
 
-    /**
-     * Check whether type is of an application class.
-     *
-     * @return bool
-     */
-    public function isApplication(): bool
-    {
-        return self::CLASS_APPLICATION === $this->_class;
-    }
+	/**
+	 * Check whether type is of an application class.
+	 *
+	 * @return bool
+	 */
+	public function isApplication(): bool
+	{
+		return self::CLASS_APPLICATION === $this->_class;
+	}
 
-    /**
-     * Check whether type is of a context specific class.
-     *
-     * @return bool
-     */
-    public function isContextSpecific(): bool
-    {
-        return self::CLASS_CONTEXT_SPECIFIC === $this->_class;
-    }
+	/**
+	 * Check whether type is of a context specific class.
+	 *
+	 * @return bool
+	 */
+	public function isContextSpecific(): bool
+	{
+		return self::CLASS_CONTEXT_SPECIFIC === $this->_class;
+	}
 
-    /**
-     * Check whether type is of a private class.
-     *
-     * @return bool
-     */
-    public function isPrivate(): bool
-    {
-        return self::CLASS_PRIVATE === $this->_class;
-    }
+	/**
+	 * Check whether type is of a private class.
+	 *
+	 * @return bool
+	 */
+	public function isPrivate(): bool
+	{
+		return self::CLASS_PRIVATE === $this->_class;
+	}
 
-    /**
-     * Check whether content is primitive type.
-     *
-     * @return bool
-     */
-    public function isPrimitive(): bool
-    {
-        return self::PRIMITIVE === $this->_pc;
-    }
+	/**
+	 * Check whether content is primitive type.
+	 *
+	 * @return bool
+	 */
+	public function isPrimitive(): bool
+	{
+		return self::PRIMITIVE === $this->_pc;
+	}
 
-    /**
-     * Check hether content is constructed type.
-     *
-     * @return bool
-     */
-    public function isConstructed(): bool
-    {
-        return self::CONSTRUCTED === $this->_pc;
-    }
+	/**
+	 * Check hether content is constructed type.
+	 *
+	 * @return bool
+	 */
+	public function isConstructed(): bool
+	{
+		return self::CONSTRUCTED === $this->_pc;
+	}
 
-    /**
-     * Get self with given type class.
-     *
-     * @param int $class One of <code>CLASS_*</code> enumerations
-     *
-     * @return self
-     */
-    public function withClass(int $class): Identifier
-    {
-        $obj = clone $this;
-        $obj->_class = 0b11 & $class;
-        return $obj;
-    }
+	/**
+	 * Get self with given type class.
+	 *
+	 * @param int $class One of <code>CLASS_*</code> enumerations
+	 *
+	 * @return self
+	 */
+	public function withClass(int $class): Identifier
+	{
+		$obj = clone $this;
+		$obj->_class = 0b11 & $class;
+		return $obj;
+	}
 
-    /**
-     * Get self with given type tag.
-     *
-     * @param int|string $tag Tag number
-     *
-     * @return self
-     */
-    public function withTag($tag): Identifier
-    {
-        $obj = clone $this;
-        $obj->_tag = new BigInt($tag);
-        return $obj;
-    }
+	/**
+	 * Get self with given type tag.
+	 *
+	 * @param int|string $tag Tag number
+	 *
+	 * @return self
+	 */
+	public function withTag($tag): Identifier
+	{
+		$obj = clone $this;
+		$obj->_tag = new BigInt($tag);
+		return $obj;
+	}
 
-    /**
-     * Get human readable name of the type class.
-     *
-     * @param int $class
-     *
-     * @return string
-     */
-    public static function classToName(int $class): string
-    {
-        if (!array_key_exists($class, self::MAP_CLASS_TO_NAME)) {
-            return "CLASS ${class}";
-        }
-        return self::MAP_CLASS_TO_NAME[$class];
-    }
+	/**
+	 * Get human readable name of the type class.
+	 *
+	 * @param int $class
+	 *
+	 * @return string
+	 */
+	public static function classToName(int $class): string
+	{
+		if (!array_key_exists($class, self::MAP_CLASS_TO_NAME)) {
+			return "CLASS ${class}";
+		}
+		return self::MAP_CLASS_TO_NAME[$class];
+	}
 
-    /**
-     * Parse long form tag.
-     *
-     * @param string $data   DER data
-     * @param int    $offset Reference to the variable containing offset to data
-     *
-     * @throws DecodeException If decoding fails
-     *
-     * @return string Tag number
-     */
-    private static function _decodeLongFormTag(string $data, int &$offset): string
-    {
-        $datalen = strlen($data);
-        $tag = gmp_init(0, 10);
-        while (true) {
-            if ($offset >= $datalen) {
-                throw new DecodeException(
-                    'Unexpected end of data while decoding' .
-                    ' long form identifier.');
-            }
-            $byte = ord($data[$offset++]);
-            $tag <<= 7;
-            $tag |= 0x7f & $byte;
-            // last byte has bit 8 set to zero
-            if (!(0x80 & $byte)) {
-                break;
-            }
-        }
-        return gmp_strval($tag, 10);
-    }
+	/**
+	 * Parse long form tag.
+	 *
+	 * @param string $data   DER data
+	 * @param int    $offset Reference to the variable containing offset to data
+	 *
+	 * @throws DecodeException If decoding fails
+	 *
+	 * @return string Tag number
+	 */
+	private static function _decodeLongFormTag(string $data, int &$offset): string
+	{
+		$datalen = strlen($data);
+		$tag = gmp_init(0, 10);
+		while (true) {
+			if ($offset >= $datalen) {
+				throw new DecodeException(
+					'Unexpected end of data while decoding' .
+					' long form identifier.');
+			}
+			$byte = ord($data[$offset++]);
+			$tag <<= 7;
+			$tag |= 0x7f & $byte;
+			// last byte has bit 8 set to zero
+			if (!(0x80 & $byte)) {
+				break;
+			}
+		}
+		return gmp_strval($tag, 10);
+	}
 }

lib/ASN1/Component/Length.php

Indentation +213 added lines, -213 removed lines

@@ -13,226 +13,226 @@
  */
 class Length implements Encodable
 {
-    /**
-     * Length.
-     *
-     * @var BigInt
-     */
-    private $_length;
+	/**
+	 * Length.
+	 *
+	 * @var BigInt
+	 */
+	private $_length;
 
-    /**
-     * Whether length is indefinite.
-     *
-     * @var bool
-     */
-    private $_indefinite;
+	/**
+	 * Whether length is indefinite.
+	 *
+	 * @var bool
+	 */
+	private $_indefinite;
 
-    /**
-     * Constructor.
-     *
-     * @param int|string $length     Length
-     * @param bool       $indefinite Whether length is indefinite
-     */
-    public function __construct($length, bool $indefinite = false)
-    {
-        $this->_length = new BigInt($length);
-        $this->_indefinite = $indefinite;
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param int|string $length     Length
+	 * @param bool       $indefinite Whether length is indefinite
+	 */
+	public function __construct($length, bool $indefinite = false)
+	{
+		$this->_length = new BigInt($length);
+		$this->_indefinite = $indefinite;
+	}
 
-    /**
-     * Decode length component from DER data.
-     *
-     * @param string   $data   DER encoded data
-     * @param null|int $offset Reference to the variable that contains offset
-     *                         into the data where to start parsing.
-     *                         Variable is updated to the offset next to the
-     *                         parsed length component. If null, start from offset 0.
-     *
-     * @throws DecodeException If decoding fails
-     *
-     * @return self
-     */
-    public static function fromDER(string $data, int &$offset = null): self
-    {
-        $idx = $offset ?? 0;
-        $datalen = strlen($data);
-        if ($idx >= $datalen) {
-            throw new DecodeException(
-                'Unexpected end of data while decoding length.');
-        }
-        $indefinite = false;
-        $byte = ord($data[$idx++]);
-        // bits 7 to 1
-        $length = (0x7f & $byte);
-        // long form
-        if (0x80 & $byte) {
-            if (!$length) {
-                $indefinite = true;
-            } else {
-                if ($idx + $length > $datalen) {
-                    throw new DecodeException(
-                        'Unexpected end of data while decoding long form length.');
-                }
-                $length = self::_decodeLongFormLength($length, $data, $idx);
-            }
-        }
-        if (isset($offset)) {
-            $offset = $idx;
-        }
-        return new self($length, $indefinite);
-    }
+	/**
+	 * Decode length component from DER data.
+	 *
+	 * @param string   $data   DER encoded data
+	 * @param null|int $offset Reference to the variable that contains offset
+	 *                         into the data where to start parsing.
+	 *                         Variable is updated to the offset next to the
+	 *                         parsed length component. If null, start from offset 0.
+	 *
+	 * @throws DecodeException If decoding fails
+	 *
+	 * @return self
+	 */
+	public static function fromDER(string $data, int &$offset = null): self
+	{
+		$idx = $offset ?? 0;
+		$datalen = strlen($data);
+		if ($idx >= $datalen) {
+			throw new DecodeException(
+				'Unexpected end of data while decoding length.');
+		}
+		$indefinite = false;
+		$byte = ord($data[$idx++]);
+		// bits 7 to 1
+		$length = (0x7f & $byte);
+		// long form
+		if (0x80 & $byte) {
+			if (!$length) {
+				$indefinite = true;
+			} else {
+				if ($idx + $length > $datalen) {
+					throw new DecodeException(
+						'Unexpected end of data while decoding long form length.');
+				}
+				$length = self::_decodeLongFormLength($length, $data, $idx);
+			}
+		}
+		if (isset($offset)) {
+			$offset = $idx;
+		}
+		return new self($length, $indefinite);
+	}
 
-    /**
-     * Decode length from DER.
-     *
-     * Throws an exception if length doesn't match with expected or if data
-     * doesn't contain enough bytes.
-     *
-     * Requirement of definite length is relaxed contrary to the specification
-     * (sect. 10.1).
-     *
-     * @see self::fromDER
-     *
-     * @param string   $data     DER data
-     * @param int      $offset   Reference to the offset variable
-     * @param null|int $expected Expected length, null to bypass checking
-     *
-     * @throws DecodeException If decoding or expectation fails
-     *
-     * @return self
-     */
-    public static function expectFromDER(string $data, int &$offset,
-        int $expected = null): self
-    {
-        $idx = $offset;
-        $length = self::fromDER($data, $idx);
-        // if certain length was expected
-        if (isset($expected)) {
-            if ($length->isIndefinite()) {
-                throw new DecodeException('Expected length %d, got indefinite.',
-                    $expected);
-            }
-            if ($expected !== $length->intLength()) {
-                throw new DecodeException(
-                    sprintf('Expected length %d, got %d.', $expected,
-                        $length->intLength()));
-            }
-        }
-        // check that enough data is available
-        if (!$length->isIndefinite() &&
-            strlen($data) < $idx + $length->intLength()) {
-            throw new DecodeException(
-                sprintf('Length %d overflows data, %d bytes left.',
-                    $length->intLength(), strlen($data) - $idx));
-        }
-        $offset = $idx;
-        return $length;
-    }
+	/**
+	 * Decode length from DER.
+	 *
+	 * Throws an exception if length doesn't match with expected or if data
+	 * doesn't contain enough bytes.
+	 *
+	 * Requirement of definite length is relaxed contrary to the specification
+	 * (sect. 10.1).
+	 *
+	 * @see self::fromDER
+	 *
+	 * @param string   $data     DER data
+	 * @param int      $offset   Reference to the offset variable
+	 * @param null|int $expected Expected length, null to bypass checking
+	 *
+	 * @throws DecodeException If decoding or expectation fails
+	 *
+	 * @return self
+	 */
+	public static function expectFromDER(string $data, int &$offset,
+		int $expected = null): self
+	{
+		$idx = $offset;
+		$length = self::fromDER($data, $idx);
+		// if certain length was expected
+		if (isset($expected)) {
+			if ($length->isIndefinite()) {
+				throw new DecodeException('Expected length %d, got indefinite.',
+					$expected);
+			}
+			if ($expected !== $length->intLength()) {
+				throw new DecodeException(
+					sprintf('Expected length %d, got %d.', $expected,
+						$length->intLength()));
+			}
+		}
+		// check that enough data is available
+		if (!$length->isIndefinite() &&
+			strlen($data) < $idx + $length->intLength()) {
+			throw new DecodeException(
+				sprintf('Length %d overflows data, %d bytes left.',
+					$length->intLength(), strlen($data) - $idx));
+		}
+		$offset = $idx;
+		return $length;
+	}
 
-    /**
-     * @see Encodable::toDER()
-     *
-     * @throws \DomainException If length is too large to encode
-     *
-     * @return string
-     */
-    public function toDER(): string
-    {
-        $bytes = [];
-        if ($this->_indefinite) {
-            $bytes[] = 0x80;
-        } else {
-            $num = $this->_length->gmpObj();
-            // long form
-            if ($num > 127) {
-                $octets = [];
-                for (; $num > 0; $num >>= 8) {
-                    $octets[] = gmp_intval(0xff & $num);
-                }
-                $count = count($octets);
-                // first octet must not be 0xff
-                if ($count >= 127) {
-                    throw new \DomainException('Too many length octets.');
-                }
-                $bytes[] = 0x80 | $count;
-                foreach (array_reverse($octets) as $octet) {
-                    $bytes[] = $octet;
-                }
-            }
-            // short form
-            else {
-                $bytes[] = gmp_intval($num);
-            }
-        }
-        return pack('C*', ...$bytes);
-    }
+	/**
+	 * @see Encodable::toDER()
+	 *
+	 * @throws \DomainException If length is too large to encode
+	 *
+	 * @return string
+	 */
+	public function toDER(): string
+	{
+		$bytes = [];
+		if ($this->_indefinite) {
+			$bytes[] = 0x80;
+		} else {
+			$num = $this->_length->gmpObj();
+			// long form
+			if ($num > 127) {
+				$octets = [];
+				for (; $num > 0; $num >>= 8) {
+					$octets[] = gmp_intval(0xff & $num);
+				}
+				$count = count($octets);
+				// first octet must not be 0xff
+				if ($count >= 127) {
+					throw new \DomainException('Too many length octets.');
+				}
+				$bytes[] = 0x80 | $count;
+				foreach (array_reverse($octets) as $octet) {
+					$bytes[] = $octet;
+				}
+			}
+			// short form
+			else {
+				$bytes[] = gmp_intval($num);
+			}
+		}
+		return pack('C*', ...$bytes);
+	}
 
-    /**
-     * Get the length.
-     *
-     * @throws \LogicException If length is indefinite
-     *
-     * @return string Length as an integer string
-     */
-    public function length(): string
-    {
-        if ($this->_indefinite) {
-            throw new \LogicException('Length is indefinite.');
-        }
-        return $this->_length->base10();
-    }
+	/**
+	 * Get the length.
+	 *
+	 * @throws \LogicException If length is indefinite
+	 *
+	 * @return string Length as an integer string
+	 */
+	public function length(): string
+	{
+		if ($this->_indefinite) {
+			throw new \LogicException('Length is indefinite.');
+		}
+		return $this->_length->base10();
+	}
 
-    /**
-     * Get the length as an integer.
-     *
-     * @throws \LogicException   If length is indefinite
-     * @throws \RuntimeException If length overflows integer size
-     *
-     * @return int
-     */
-    public function intLength(): int
-    {
-        if ($this->_indefinite) {
-            throw new \LogicException('Length is indefinite.');
-        }
-        return $this->_length->intVal();
-    }
+	/**
+	 * Get the length as an integer.
+	 *
+	 * @throws \LogicException   If length is indefinite
+	 * @throws \RuntimeException If length overflows integer size
+	 *
+	 * @return int
+	 */
+	public function intLength(): int
+	{
+		if ($this->_indefinite) {
+			throw new \LogicException('Length is indefinite.');
+		}
+		return $this->_length->intVal();
+	}
 
-    /**
-     * Whether length is indefinite.
-     *
-     * @return bool
-     */
-    public function isIndefinite(): bool
-    {
-        return $this->_indefinite;
-    }
+	/**
+	 * Whether length is indefinite.
+	 *
+	 * @return bool
+	 */
+	public function isIndefinite(): bool
+	{
+		return $this->_indefinite;
+	}
 
-    /**
-     * Decode long form length.
-     *
-     * @param int    $length Number of octets
-     * @param string $data   Data
-     * @param int    $offset reference to the variable containing offset to the
-     *                       data
-     *
-     * @throws DecodeException If decoding fails
-     *
-     * @return string Integer as a string
-     */
-    private static function _decodeLongFormLength(int $length, string $data,
-        int &$offset): string
-    {
-        // first octet must not be 0xff (spec 8.1.3.5c)
-        if (127 == $length) {
-            throw new DecodeException('Invalid number of length octets.');
-        }
-        $num = gmp_init(0, 10);
-        while (--$length >= 0) {
-            $byte = ord($data[$offset++]);
-            $num <<= 8;
-            $num |= $byte;
-        }
-        return gmp_strval($num);
-    }
+	/**
+	 * Decode long form length.
+	 *
+	 * @param int    $length Number of octets
+	 * @param string $data   Data
+	 * @param int    $offset reference to the variable containing offset to the
+	 *                       data
+	 *
+	 * @throws DecodeException If decoding fails
+	 *
+	 * @return string Integer as a string
+	 */
+	private static function _decodeLongFormLength(int $length, string $data,
+		int &$offset): string
+	{
+		// first octet must not be 0xff (spec 8.1.3.5c)
+		if (127 == $length) {
+			throw new DecodeException('Invalid number of length octets.');
+		}
+		$num = gmp_init(0, 10);
+		while (--$length >= 0) {
+			$byte = ord($data[$offset++]);
+			$num <<= 8;
+			$num |= $byte;
+		}
+		return gmp_strval($num);
+	}
 }

lib/ASN1/Feature/ElementBase.php

Indentation +79 added lines, -79 removed lines

@@ -13,91 +13,91 @@
  */
 interface ElementBase extends Encodable
 {
-    /**
-     * Get the class of the ASN.1 type.
-     *
-     * One of <code>Identifier::CLASS_*</code> constants.
-     *
-     * @return int
-     */
-    public function typeClass(): int;
+	/**
+	 * Get the class of the ASN.1 type.
+	 *
+	 * One of <code>Identifier::CLASS_*</code> constants.
+	 *
+	 * @return int
+	 */
+	public function typeClass(): int;
 
-    /**
-     * Check whether the element is constructed.
-     *
-     * Otherwise it's primitive.
-     *
-     * @return bool
-     */
-    public function isConstructed(): bool;
+	/**
+	 * Check whether the element is constructed.
+	 *
+	 * Otherwise it's primitive.
+	 *
+	 * @return bool
+	 */
+	public function isConstructed(): bool;
 
-    /**
-     * Get the tag of the element.
-     *
-     * Interpretation of the tag depends on the context. For example it may
-     * represent a universal type tag or a tag of an implicitly or explicitly
-     * tagged type.
-     *
-     * @return int
-     */
-    public function tag(): int;
+	/**
+	 * Get the tag of the element.
+	 *
+	 * Interpretation of the tag depends on the context. For example it may
+	 * represent a universal type tag or a tag of an implicitly or explicitly
+	 * tagged type.
+	 *
+	 * @return int
+	 */
+	public function tag(): int;
 
-    /**
-     * Check whether the element is a type of a given tag.
-     *
-     * @param int $tag Type tag
-     *
-     * @return bool
-     */
-    public function isType(int $tag): bool;
+	/**
+	 * Check whether the element is a type of a given tag.
+	 *
+	 * @param int $tag Type tag
+	 *
+	 * @return bool
+	 */
+	public function isType(int $tag): bool;
 
-    /**
-     * Check whether the element is a type of a given tag.
-     *
-     * Throws an exception if expectation fails.
-     *
-     * @param int $tag Type tag
-     *
-     * @throws \UnexpectedValueException If the element type differs from the
-     *                                   expected
-     *
-     * @return ElementBase
-     */
-    public function expectType(int $tag): ElementBase;
+	/**
+	 * Check whether the element is a type of a given tag.
+	 *
+	 * Throws an exception if expectation fails.
+	 *
+	 * @param int $tag Type tag
+	 *
+	 * @throws \UnexpectedValueException If the element type differs from the
+	 *                                   expected
+	 *
+	 * @return ElementBase
+	 */
+	public function expectType(int $tag): ElementBase;
 
-    /**
-     * Check whether the element is tagged (context specific).
-     *
-     * @return bool
-     */
-    public function isTagged(): bool;
+	/**
+	 * Check whether the element is tagged (context specific).
+	 *
+	 * @return bool
+	 */
+	public function isTagged(): bool;
 
-    /**
-     * Check whether the element is tagged (context specific) and optionally has
-     * a given tag.
-     *
-     * Throws an exception if the element is not tagged or tag differs from
-     * the expected.
-     *
-     * @param null|int $tag Optional type tag
-     *
-     * @throws \UnexpectedValueException If expectation fails
-     *
-     * @return TaggedType
-     */
-    public function expectTagged(?int $tag = null): TaggedType;
+	/**
+	 * Check whether the element is tagged (context specific) and optionally has
+	 * a given tag.
+	 *
+	 * Throws an exception if the element is not tagged or tag differs from
+	 * the expected.
+	 *
+	 * @param null|int $tag Optional type tag
+	 *
+	 * @throws \UnexpectedValueException If expectation fails
+	 *
+	 * @return TaggedType
+	 */
+	public function expectTagged(?int $tag = null): TaggedType;
 
-    /**
-     * Get the object as an abstract Element instance.
-     *
-     * @return Element
-     */
-    public function asElement(): Element;
+	/**
+	 * Get the object as an abstract Element instance.
+	 *
+	 * @return Element
+	 */
+	public function asElement(): Element;
 
-    /**
-     * Get the object as an UnspecifiedType instance.
-     *
-     * @return UnspecifiedType
-     */
-    public function asUnspecified(): UnspecifiedType;
+	/**
+	 * Get the object as an UnspecifiedType instance.
+	 *
+	 * @return UnspecifiedType
+	 */
+	public function asUnspecified(): UnspecifiedType;
 }

lib/ASN1/Type/Primitive/Real.php

Indentation +255 added lines, -255 removed lines

@@ -17,276 +17,276 @@
  */
 class Real extends Element
 {
-    use UniversalClass;
-    use PrimitiveType;
+	use UniversalClass;
+	use PrimitiveType;
 
-    /**
-     * Regex pattern to parse NR3 form number conforming to DER.
-     *
-     * @var string
-     */
-    const NR3_REGEX = '/^(-?)(\d+)?\.E([+\-]?\d+)$/';
+	/**
+	 * Regex pattern to parse NR3 form number conforming to DER.
+	 *
+	 * @var string
+	 */
+	const NR3_REGEX = '/^(-?)(\d+)?\.E([+\-]?\d+)$/';
 
-    /**
-     * Regex pattern to parse PHP exponent number format.
-     *
-     * @see http://php.net/manual/en/language.types.float.php
-     *
-     * @var string
-     */
-    const PHP_EXPONENT_DNUM = '/^' .
-        '([+\-]?' . // sign
-        '(?:' .
-            '\d+' . // LNUM
-            '|' .
-            '(?:\d*\.\d+|\d+\.\d*)' . // DNUM
-        '))[eE]' .
-        '([+\-]?\d+)' . // exponent
-    '$/';
+	/**
+	 * Regex pattern to parse PHP exponent number format.
+	 *
+	 * @see http://php.net/manual/en/language.types.float.php
+	 *
+	 * @var string
+	 */
+	const PHP_EXPONENT_DNUM = '/^' .
+		'([+\-]?' . // sign
+		'(?:' .
+			'\d+' . // LNUM
+			'|' .
+			'(?:\d*\.\d+|\d+\.\d*)' . // DNUM
+		'))[eE]' .
+		'([+\-]?\d+)' . // exponent
+	'$/';
 
-    /**
-     * Number zero represented in NR3 form.
-     *
-     * @var string
-     */
-    const NR3_ZERO = '.E+0';
+	/**
+	 * Number zero represented in NR3 form.
+	 *
+	 * @var string
+	 */
+	const NR3_ZERO = '.E+0';
 
-    /**
-     * Number in NR3 form.
-     *
-     * @var string
-     */
-    private $_number;
+	/**
+	 * Number in NR3 form.
+	 *
+	 * @var string
+	 */
+	private $_number;
 
-    /**
-     * Constructor.
-     *
-     * @param string $number number in NR3 form
-     */
-    public function __construct(string $number)
-    {
-        $this->_typeTag = self::TYPE_REAL;
-        if (!self::_validateNumber($number)) {
-            throw new \InvalidArgumentException(
-                "'${number}' is not a valid NR3 form real.");
-        }
-        $this->_number = $number;
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string $number number in NR3 form
+	 */
+	public function __construct(string $number)
+	{
+		$this->_typeTag = self::TYPE_REAL;
+		if (!self::_validateNumber($number)) {
+			throw new \InvalidArgumentException(
+				"'${number}' is not a valid NR3 form real.");
+		}
+		$this->_number = $number;
+	}
 
-    /**
-     * Initialize from float.
-     *
-     * @param float $number
-     *
-     * @return self
-     */
-    public static function fromFloat(float $number): self
-    {
-        return new self(self::_decimalToNR3(strval($number)));
-    }
+	/**
+	 * Initialize from float.
+	 *
+	 * @param float $number
+	 *
+	 * @return self
+	 */
+	public static function fromFloat(float $number): self
+	{
+		return new self(self::_decimalToNR3(strval($number)));
+	}
 
-    /**
-     * Get number as a float.
-     *
-     * @return float
-     */
-    public function float(): float
-    {
-        return self::_nr3ToDecimal($this->_number);
-    }
+	/**
+	 * Get number as a float.
+	 *
+	 * @return float
+	 */
+	public function float(): float
+	{
+		return self::_nr3ToDecimal($this->_number);
+	}
 
-    /**
-     * {@inheritdoc}
-     */
-    protected function _encodedContentDER(): string
-    {
-        /* if the real value is the value zero, there shall be no contents
+	/**
+	 * {@inheritdoc}
+	 */
+	protected function _encodedContentDER(): string
+	{
+		/* if the real value is the value zero, there shall be no contents
          octets in the encoding. (X.690 07-2002, section 8.5.2) */
-        if (self::NR3_ZERO == $this->_number) {
-            return '';
-        }
-        // encode in NR3 decimal encoding
-        return chr(0x03) . $this->_number;
-    }
+		if (self::NR3_ZERO == $this->_number) {
+			return '';
+		}
+		// encode in NR3 decimal encoding
+		return chr(0x03) . $this->_number;
+	}
 
-    /**
-     * {@inheritdoc}
-     */
-    protected static function _decodeFromDER(Identifier $identifier,
-        string $data, int &$offset): ElementBase
-    {
-        $idx = $offset;
-        $length = Length::expectFromDER($data, $idx)->intLength();
-        // if length is zero, value is zero (spec 8.5.2)
-        if (!$length) {
-            $obj = new self(self::NR3_ZERO);
-        } else {
-            $bytes = substr($data, $idx, $length);
-            $byte = ord($bytes[0]);
-            if (0x80 & $byte) { // bit 8 = 1
-                $obj = self::_decodeBinaryEncoding($bytes);
-            } elseif (0x00 == $byte >> 6) { // bit 8 = 0, bit 7 = 0
-                $obj = self::_decodeDecimalEncoding($bytes);
-            } else { // bit 8 = 0, bit 7 = 1
-                $obj = self::_decodeSpecialRealValue($bytes);
-            }
-        }
-        $offset = $idx + $length;
-        return $obj;
-    }
+	/**
+	 * {@inheritdoc}
+	 */
+	protected static function _decodeFromDER(Identifier $identifier,
+		string $data, int &$offset): ElementBase
+	{
+		$idx = $offset;
+		$length = Length::expectFromDER($data, $idx)->intLength();
+		// if length is zero, value is zero (spec 8.5.2)
+		if (!$length) {
+			$obj = new self(self::NR3_ZERO);
+		} else {
+			$bytes = substr($data, $idx, $length);
+			$byte = ord($bytes[0]);
+			if (0x80 & $byte) { // bit 8 = 1
+				$obj = self::_decodeBinaryEncoding($bytes);
+			} elseif (0x00 == $byte >> 6) { // bit 8 = 0, bit 7 = 0
+				$obj = self::_decodeDecimalEncoding($bytes);
+			} else { // bit 8 = 0, bit 7 = 1
+				$obj = self::_decodeSpecialRealValue($bytes);
+			}
+		}
+		$offset = $idx + $length;
+		return $obj;
+	}
 
-    /**
-     * @todo Implement
-     *
-     * @param string $data
-     */
-    protected static function _decodeBinaryEncoding(string $data)
-    {
-        throw new \RuntimeException(
-            'Binary encoding of REAL is not implemented.');
-    }
+	/**
+	 * @todo Implement
+	 *
+	 * @param string $data
+	 */
+	protected static function _decodeBinaryEncoding(string $data)
+	{
+		throw new \RuntimeException(
+			'Binary encoding of REAL is not implemented.');
+	}
 
-    /**
-     * @param string $data
-     *
-     * @throws \RuntimeException
-     *
-     * @return self
-     */
-    protected static function _decodeDecimalEncoding(string $data): self
-    {
-        $nr = ord($data[0]) & 0x03;
-        if (0x03 != $nr) {
-            throw new \RuntimeException('Only NR3 form supported.');
-        }
-        $str = substr($data, 1);
-        return new self($str);
-    }
+	/**
+	 * @param string $data
+	 *
+	 * @throws \RuntimeException
+	 *
+	 * @return self
+	 */
+	protected static function _decodeDecimalEncoding(string $data): self
+	{
+		$nr = ord($data[0]) & 0x03;
+		if (0x03 != $nr) {
+			throw new \RuntimeException('Only NR3 form supported.');
+		}
+		$str = substr($data, 1);
+		return new self($str);
+	}
 
-    /**
-     * @todo Implement
-     *
-     * @param string $data
-     */
-    protected static function _decodeSpecialRealValue(string $data)
-    {
-        if (1 != strlen($data)) {
-            throw new DecodeException(
-                'SpecialRealValue must have one content octet.');
-        }
-        $byte = ord($data[0]);
-        if (0x40 == $byte) { // positive infinity
-            throw new \RuntimeException('PLUS-INFINITY not supported.');
-        }
-        if (0x41 == $byte) { // negative infinity
-            throw new \RuntimeException('MINUS-INFINITY not supported.');
-        }
-        throw new DecodeException('Invalid SpecialRealValue encoding.');
-    }
+	/**
+	 * @todo Implement
+	 *
+	 * @param string $data
+	 */
+	protected static function _decodeSpecialRealValue(string $data)
+	{
+		if (1 != strlen($data)) {
+			throw new DecodeException(
+				'SpecialRealValue must have one content octet.');
+		}
+		$byte = ord($data[0]);
+		if (0x40 == $byte) { // positive infinity
+			throw new \RuntimeException('PLUS-INFINITY not supported.');
+		}
+		if (0x41 == $byte) { // negative infinity
+			throw new \RuntimeException('MINUS-INFINITY not supported.');
+		}
+		throw new DecodeException('Invalid SpecialRealValue encoding.');
+	}
 
-    /**
-     * Convert decimal number string to NR3 form.
-     *
-     * @param string $str
-     *
-     * @return string
-     */
-    private static function _decimalToNR3(string $str): string
-    {
-        // if number is in exponent form
-        /** @var string[] $match */
-        if (preg_match(self::PHP_EXPONENT_DNUM, $str, $match)) {
-            $parts = explode('.', $match[1]);
-            $m = ltrim($parts[0], '0');
-            $e = intval($match[2]);
-            // if mantissa had decimals
-            if (2 == count($parts)) {
-                $d = rtrim($parts[1], '0');
-                $e -= strlen($d);
-                $m .= $d;
-            }
-        } else {
-            // explode from decimal
-            $parts = explode('.', $str);
-            $m = ltrim($parts[0], '0');
-            // if number had decimals
-            if (2 == count($parts)) {
-                // exponent is negative number of the decimals
-                $e = -strlen($parts[1]);
-                // append decimals to the mantissa
-                $m .= $parts[1];
-            } else {
-                $e = 0;
-            }
-            // shift trailing zeroes from the mantissa to the exponent
-            while ('0' === substr($m, -1)) {
-                ++$e;
-                $m = substr($m, 0, -1);
-            }
-        }
-        /* if exponent is zero, it must be prefixed with a "+" sign
+	/**
+	 * Convert decimal number string to NR3 form.
+	 *
+	 * @param string $str
+	 *
+	 * @return string
+	 */
+	private static function _decimalToNR3(string $str): string
+	{
+		// if number is in exponent form
+		/** @var string[] $match */
+		if (preg_match(self::PHP_EXPONENT_DNUM, $str, $match)) {
+			$parts = explode('.', $match[1]);
+			$m = ltrim($parts[0], '0');
+			$e = intval($match[2]);
+			// if mantissa had decimals
+			if (2 == count($parts)) {
+				$d = rtrim($parts[1], '0');
+				$e -= strlen($d);
+				$m .= $d;
+			}
+		} else {
+			// explode from decimal
+			$parts = explode('.', $str);
+			$m = ltrim($parts[0], '0');
+			// if number had decimals
+			if (2 == count($parts)) {
+				// exponent is negative number of the decimals
+				$e = -strlen($parts[1]);
+				// append decimals to the mantissa
+				$m .= $parts[1];
+			} else {
+				$e = 0;
+			}
+			// shift trailing zeroes from the mantissa to the exponent
+			while ('0' === substr($m, -1)) {
+				++$e;
+				$m = substr($m, 0, -1);
+			}
+		}
+		/* if exponent is zero, it must be prefixed with a "+" sign
          (X.690 07-2002, section 11.3.2.6) */
-        if (0 == $e) {
-            $es = '+';
-        } else {
-            $es = $e < 0 ? '-' : '';
-        }
-        return sprintf('%s.E%s%d', $m, $es, abs($e));
-    }
+		if (0 == $e) {
+			$es = '+';
+		} else {
+			$es = $e < 0 ? '-' : '';
+		}
+		return sprintf('%s.E%s%d', $m, $es, abs($e));
+	}
 
-    /**
-     * Convert NR3 form number to decimal.
-     *
-     * @param string $str
-     *
-     * @throws \UnexpectedValueException
-     *
-     * @return float
-     */
-    private static function _nr3ToDecimal(string $str): float
-    {
-        /** @var string[] $match */
-        if (!preg_match(self::NR3_REGEX, $str, $match)) {
-            throw new \UnexpectedValueException(
-                "'${str}' is not a valid NR3 form real.");
-        }
-        $m = $match[2];
-        // if number started with minus sign
-        $inv = '-' == $match[1];
-        $e = intval($match[3]);
-        // positive exponent
-        if ($e > 0) {
-            // pad with trailing zeroes
-            $num = $m . str_repeat('0', $e);
-        } elseif ($e < 0) {
-            // pad with leading zeroes
-            if (strlen($m) < abs($e)) {
-                $m = str_repeat('0', intval(abs($e)) - strlen($m)) . $m;
-            }
-            // insert decimal point
-            $num = substr($m, 0, $e) . '.' . substr($m, $e);
-        } else {
-            $num = empty($m) ? '0' : $m;
-        }
-        // if number is negative
-        if ($inv) {
-            $num = "-${num}";
-        }
-        return floatval($num);
-    }
+	/**
+	 * Convert NR3 form number to decimal.
+	 *
+	 * @param string $str
+	 *
+	 * @throws \UnexpectedValueException
+	 *
+	 * @return float
+	 */
+	private static function _nr3ToDecimal(string $str): float
+	{
+		/** @var string[] $match */
+		if (!preg_match(self::NR3_REGEX, $str, $match)) {
+			throw new \UnexpectedValueException(
+				"'${str}' is not a valid NR3 form real.");
+		}
+		$m = $match[2];
+		// if number started with minus sign
+		$inv = '-' == $match[1];
+		$e = intval($match[3]);
+		// positive exponent
+		if ($e > 0) {
+			// pad with trailing zeroes
+			$num = $m . str_repeat('0', $e);
+		} elseif ($e < 0) {
+			// pad with leading zeroes
+			if (strlen($m) < abs($e)) {
+				$m = str_repeat('0', intval(abs($e)) - strlen($m)) . $m;
+			}
+			// insert decimal point
+			$num = substr($m, 0, $e) . '.' . substr($m, $e);
+		} else {
+			$num = empty($m) ? '0' : $m;
+		}
+		// if number is negative
+		if ($inv) {
+			$num = "-${num}";
+		}
+		return floatval($num);
+	}
 
-    /**
-     * Test that number is valid for this context.
-     *
-     * @param mixed $num
-     *
-     * @return bool
-     */
-    private static function _validateNumber($num): bool
-    {
-        if (!preg_match(self::NR3_REGEX, $num)) {
-            return false;
-        }
-        return true;
-    }
+	/**
+	 * Test that number is valid for this context.
+	 *
+	 * @param mixed $num
+	 *
+	 * @return bool
+	 */
+	private static function _validateNumber($num): bool
+	{
+		if (!preg_match(self::NR3_REGEX, $num)) {
+			return false;
+		}
+		return true;
+	}
 }

lib/ASN1/Util/Flags.php

Indentation +137 added lines, -137 removed lines

@@ -11,149 +11,149 @@
  */
 class Flags
 {
-    /**
-     * Flag octets.
-     *
-     * @var string
-     */
-    protected $_flags;
+	/**
+	 * Flag octets.
+	 *
+	 * @var string
+	 */
+	protected $_flags;
 
-    /**
-     * Number of flags.
-     *
-     * @var int
-     */
-    protected $_width;
+	/**
+	 * Number of flags.
+	 *
+	 * @var int
+	 */
+	protected $_width;
 
-    /**
-     * Constructor.
-     *
-     * @param int|string $flags Flags
-     * @param int        $width The number of flags. If width is larger than
-     *                          number of bits in $flags, zeroes are prepended
-     *                          to flag field.
-     */
-    public function __construct($flags, int $width)
-    {
-        if (!$width) {
-            $this->_flags = '';
-        } else {
-            // calculate number of unused bits in last octet
-            $last_octet_bits = $width % 8;
-            $unused_bits = $last_octet_bits ? 8 - $last_octet_bits : 0;
-            $num = gmp_init($flags);
-            // mask bits outside bitfield width
-            $mask = gmp_sub(gmp_init(1) << $width, 1);
-            $num &= $mask;
-            // shift towards MSB if needed
-            $data = gmp_export($num << $unused_bits, 1,
-                GMP_MSW_FIRST | GMP_BIG_ENDIAN);
-            $octets = unpack('C*', $data);
-            assert(is_array($octets), new \RuntimeException('unpack() failed'));
-            $bits = count($octets) * 8;
-            // pad with zeroes
-            while ($bits < $width) {
-                array_unshift($octets, 0);
-                $bits += 8;
-            }
-            $this->_flags = pack('C*', ...$octets);
-        }
-        $this->_width = $width;
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param int|string $flags Flags
+	 * @param int        $width The number of flags. If width is larger than
+	 *                          number of bits in $flags, zeroes are prepended
+	 *                          to flag field.
+	 */
+	public function __construct($flags, int $width)
+	{
+		if (!$width) {
+			$this->_flags = '';
+		} else {
+			// calculate number of unused bits in last octet
+			$last_octet_bits = $width % 8;
+			$unused_bits = $last_octet_bits ? 8 - $last_octet_bits : 0;
+			$num = gmp_init($flags);
+			// mask bits outside bitfield width
+			$mask = gmp_sub(gmp_init(1) << $width, 1);
+			$num &= $mask;
+			// shift towards MSB if needed
+			$data = gmp_export($num << $unused_bits, 1,
+				GMP_MSW_FIRST | GMP_BIG_ENDIAN);
+			$octets = unpack('C*', $data);
+			assert(is_array($octets), new \RuntimeException('unpack() failed'));
+			$bits = count($octets) * 8;
+			// pad with zeroes
+			while ($bits < $width) {
+				array_unshift($octets, 0);
+				$bits += 8;
+			}
+			$this->_flags = pack('C*', ...$octets);
+		}
+		$this->_width = $width;
+	}
 
-    /**
-     * Initialize from BitString.
-     *
-     * @param BitString $bs
-     * @param int       $width
-     *
-     * @return self
-     */
-    public static function fromBitString(BitString $bs, int $width): self
-    {
-        $num_bits = $bs->numBits();
-        $num = gmp_import($bs->string(), 1, GMP_MSW_FIRST | GMP_BIG_ENDIAN);
-        $num >>= $bs->unusedBits();
-        if ($num_bits < $width) {
-            $num <<= ($width - $num_bits);
-        }
-        return new self(gmp_strval($num, 10), $width);
-    }
+	/**
+	 * Initialize from BitString.
+	 *
+	 * @param BitString $bs
+	 * @param int       $width
+	 *
+	 * @return self
+	 */
+	public static function fromBitString(BitString $bs, int $width): self
+	{
+		$num_bits = $bs->numBits();
+		$num = gmp_import($bs->string(), 1, GMP_MSW_FIRST | GMP_BIG_ENDIAN);
+		$num >>= $bs->unusedBits();
+		if ($num_bits < $width) {
+			$num <<= ($width - $num_bits);
+		}
+		return new self(gmp_strval($num, 10), $width);
+	}
 
-    /**
-     * Check whether a bit at given index is set.
-     *
-     * Index 0 is the leftmost bit.
-     *
-     * @param int $idx
-     *
-     * @throws \OutOfBoundsException
-     *
-     * @return bool
-     */
-    public function test(int $idx): bool
-    {
-        if ($idx >= $this->_width) {
-            throw new \OutOfBoundsException('Index is out of bounds.');
-        }
-        // octet index
-        $oi = (int) floor($idx / 8);
-        $byte = $this->_flags[$oi];
-        // bit index
-        $bi = $idx % 8;
-        // index 0 is the most significant bit in byte
-        $mask = 0x01 << (7 - $bi);
-        return (ord($byte) & $mask) > 0;
-    }
+	/**
+	 * Check whether a bit at given index is set.
+	 *
+	 * Index 0 is the leftmost bit.
+	 *
+	 * @param int $idx
+	 *
+	 * @throws \OutOfBoundsException
+	 *
+	 * @return bool
+	 */
+	public function test(int $idx): bool
+	{
+		if ($idx >= $this->_width) {
+			throw new \OutOfBoundsException('Index is out of bounds.');
+		}
+		// octet index
+		$oi = (int) floor($idx / 8);
+		$byte = $this->_flags[$oi];
+		// bit index
+		$bi = $idx % 8;
+		// index 0 is the most significant bit in byte
+		$mask = 0x01 << (7 - $bi);
+		return (ord($byte) & $mask) > 0;
+	}
 
-    /**
-     * Get flags as an octet string.
-     *
-     * Zeroes are appended to the last octet if width is not divisible by 8.
-     *
-     * @return string
-     */
-    public function string(): string
-    {
-        return $this->_flags;
-    }
+	/**
+	 * Get flags as an octet string.
+	 *
+	 * Zeroes are appended to the last octet if width is not divisible by 8.
+	 *
+	 * @return string
+	 */
+	public function string(): string
+	{
+		return $this->_flags;
+	}
 
-    /**
-     * Get flags as a base 10 integer.
-     *
-     * @return string Integer as a string
-     */
-    public function number(): string
-    {
-        $num = gmp_import($this->_flags, 1, GMP_MSW_FIRST | GMP_BIG_ENDIAN);
-        $last_octet_bits = $this->_width % 8;
-        $unused_bits = $last_octet_bits ? 8 - $last_octet_bits : 0;
-        $num >>= $unused_bits;
-        return gmp_strval($num, 10);
-    }
+	/**
+	 * Get flags as a base 10 integer.
+	 *
+	 * @return string Integer as a string
+	 */
+	public function number(): string
+	{
+		$num = gmp_import($this->_flags, 1, GMP_MSW_FIRST | GMP_BIG_ENDIAN);
+		$last_octet_bits = $this->_width % 8;
+		$unused_bits = $last_octet_bits ? 8 - $last_octet_bits : 0;
+		$num >>= $unused_bits;
+		return gmp_strval($num, 10);
+	}
 
-    /**
-     * Get flags as an integer.
-     *
-     * @return int
-     */
-    public function intNumber(): int
-    {
-        $num = new BigInt($this->number());
-        return $num->intVal();
-    }
+	/**
+	 * Get flags as an integer.
+	 *
+	 * @return int
+	 */
+	public function intNumber(): int
+	{
+		$num = new BigInt($this->number());
+		return $num->intVal();
+	}
 
-    /**
-     * Get flags as a BitString.
-     *
-     * Unused bits are set accordingly. Trailing zeroes are not stripped.
-     *
-     * @return BitString
-     */
-    public function bitString(): BitString
-    {
-        $last_octet_bits = $this->_width % 8;
-        $unused_bits = $last_octet_bits ? 8 - $last_octet_bits : 0;
-        return new BitString($this->_flags, $unused_bits);
-    }
+	/**
+	 * Get flags as a BitString.
+	 *
+	 * Unused bits are set accordingly. Trailing zeroes are not stripped.
+	 *
+	 * @return BitString
+	 */
+	public function bitString(): BitString
+	{
+		$last_octet_bits = $this->_width % 8;
+		$unused_bits = $last_octet_bits ? 8 - $last_octet_bits : 0;
+		return new BitString($this->_flags, $unused_bits);
+	}
 }