SWAMPy

✎ CARVE FLESH

EDITING: LOC.php

<?php

declare(strict_types=1);

/*
 * This file is part of Badcow DNS Library.
 *
 * (c) Samuel Williams <sam@badcow.co>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Badcow\DNS\Rdata;

use Badcow\DNS\Parser\Tokens;

/**
 * Class LocRdata.
 *
 * Mechanism to allow the DNS to carry location
 * information about hosts, networks, and subnets.
 *
 * @see http://tools.ietf.org/html/rfc1876
 */
class LOC implements RdataInterface
{
    use RdataTrait;

public const TYPE = 'LOC';
    public const TYPE_CODE = 29;
    public const LATITUDE = 'LATITUDE';
    public const LONGITUDE = 'LONGITUDE';
    public const FORMAT_DECIMAL = 'DECIMAL';
    public const FORMAT_DMS = 'DMS';

/**
     * @var float|null
     */
    private $latitude;

/**
     * @var float|null
     */
    private $longitude;

/**
     * @var float
     */
    private $altitude = 0.0;

/**
     * @var float
     */
    private $size = 1.0;

/**
     * @var float
     */
    private $horizontalPrecision = 10000.0;

/**
     * @var float
     */
    private $verticalPrecision = 10.0;

public function setLatitude(float $latitude): void
    {
        $this->latitude = (float) $latitude;
    }

/**
     * @return float|string|null
     */
    public function getLatitude(string $format = self::FORMAT_DECIMAL)
    {
        if (self::FORMAT_DMS === $format) {
            return $this->toDms($this->latitude ?? 0, self::LATITUDE);
        }

return $this->latitude;
    }

public function setLongitude(float $longitude): void
    {
        $this->longitude = (float) $longitude;
    }

/**
     * @return float|string|null
     */
    public function getLongitude(string $format = self::FORMAT_DECIMAL)
    {
        if (self::FORMAT_DMS === $format) {
            return $this->toDms($this->longitude ?? 0, self::LONGITUDE);
        }

return $this->longitude;
    }

/**
     * @throws \OutOfRangeException
     */
    public function setAltitude(float $altitude): void
    {
        if ($altitude < -100000.00 || $altitude > 42849672.95) {
            throw new \OutOfRangeException('The altitude must be on [-100000.00, 42849672.95].');
        }

$this->altitude = (float) $altitude;
    }

public function getAltitude(): float
    {
        return $this->altitude;
    }

/**
     * @throws \OutOfRangeException
     */
    public function setHorizontalPrecision(float $horizontalPrecision): void
    {
        if ($horizontalPrecision < 0 || $horizontalPrecision > 9e9) {
            throw new \OutOfRangeException('The horizontal precision must be on [0, 9e9].');
        }

$this->horizontalPrecision = (float) $horizontalPrecision;
    }

public function getHorizontalPrecision(): float
    {
        return $this->horizontalPrecision;
    }

/**
     * @throws \OutOfRangeException
     */
    public function setSize(float $size): void
    {
        if ($size < 0 || $size > 9e9) {
            throw new \OutOfRangeException('The size must be on [0, 9e9].');
        }

$this->size = (float) $size;
    }

public function getSize(): float
    {
        return $this->size;
    }

/**
     * @throws \OutOfRangeException
     */
    public function setVerticalPrecision(float $verticalPrecision): void
    {
        if ($verticalPrecision < 0 || $verticalPrecision > 9e9) {
            throw new \OutOfRangeException('The vertical precision must be on [0, 9e9].');
        }

$this->verticalPrecision = $verticalPrecision;
    }

public function getVerticalPrecision(): float
    {
        return $this->verticalPrecision;
    }

public function toText(): string
    {
        return sprintf(
            '%s %s %.2fm %.2fm %.2fm %.2fm',
            $this->getLatitude(self::FORMAT_DMS),
            $this->getLongitude(self::FORMAT_DMS),
            $this->altitude,
            $this->size,
            $this->horizontalPrecision,
            $this->verticalPrecision
        );
    }

/**
     * Determine the degree minute seconds value from decimal.
     */
    private function toDms(float $decimal, string $axis = self::LATITUDE): string
    {
        $d = (int) floor(abs($decimal));
        $m = (int) floor((abs($decimal) - $d) * 60);
        $s = ((abs($decimal) - $d) * 60 - $m) * 60;
        if (self::LATITUDE === $axis) {
            $h = ($decimal < 0) ? 'S' : 'N';
        } else {
            $h = ($decimal < 0) ? 'W' : 'E';
        }

return sprintf('%d %d %.3f %s', $d, $m, $s, $h);
    }

public function toWire(): string
    {
        return pack(
            'CCCClll',
            0,
            self::numberToExponentValue($this->size),
            self::numberToExponentValue($this->horizontalPrecision),
            self::numberToExponentValue($this->verticalPrecision),
            (int) floor($this->latitude * 3600000),
            (int) floor($this->longitude * 3600000),
            (int) floor($this->altitude)
        );
    }

private static function numberToExponentValue(float $num): int
    {
        $exponent = (int) floor(log($num, 10));
        $base = (int) ceil($num / (10 ** $exponent));

return $base * 16 + $exponent;
    }

private static function exponentValueToNumber(int $val): float
    {
        $base = ($val & 0b11110000) / 16;
        $exponent = ($val & 0b00001111);

return $base * 10 ** $exponent;
    }

/**
     * Transform a DMS string to a decimal representation. Used for LOC records.
     *
     * @param int    $deg        Degrees
     * @param int    $min        Minutes
     * @param float  $sec        Seconds
     * @param string $hemisphere Either 'N', 'S', 'E', or 'W'
     */
    public static function dmsToDecimal(int $deg, int $min, float $sec, string $hemisphere): float
    {
        $multiplier = ('S' === $hemisphere || 'W' === $hemisphere) ? -1 : 1;

return $multiplier * ($deg + ($min / 60) + ($sec / 3600));
    }

public function fromText(string $text): void
    {
        $rdata = explode(Tokens::SPACE, $text);
        $lat = self::dmsToDecimal((int) array_shift($rdata), (int) array_shift($rdata), (float) array_shift($rdata), (string) array_shift($rdata));
        $lon = self::dmsToDecimal((int) array_shift($rdata), (int) array_shift($rdata), (float) array_shift($rdata), (string) array_shift($rdata));

$this->setLatitude($lat);
        $this->setLongitude($lon);
        $this->setAltitude((float) array_shift($rdata));
        $this->setSize((float) array_shift($rdata));
        $this->setHorizontalPrecision((float) array_shift($rdata));
        $this->setVerticalPrecision((float) array_shift($rdata));
    }

/**
     * @throws DecodeException
     */
    public function fromWire(string $rdata, int &$offset = 0, ?int $rdLength = null): void
    {
        if (false === $values = unpack('C<version>/C<size>/C<hp>/C<vp>/l<lat>/l<lon>/l<alt>', $rdata, $offset)) {
            throw new DecodeException(static::TYPE, $rdata);
        }
        $offset += 16;

$this->setSize(self::exponentValueToNumber($values['<size>']));
        $this->setHorizontalPrecision(self::exponentValueToNumber($values['<hp>']));
        $this->setVerticalPrecision(self::exponentValueToNumber($values['<vp>']));
        $this->setLatitude($values['<lat>'] / 3600000);
        $this->setLongitude($values['<lon>'] / 3600000);
        $this->setAltitude($values['<alt>']);
    }
}

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📄 A.php	PHP	1.9 KB	2022-12-15 15:25	EDIT
📄 AAAA.php	PHP	1.1 KB	2022-12-15 15:25	EDIT
📄 AFSDB.php	PHP	2.2 KB	2022-12-15 15:25	EDIT
📄 APL.php	PHP	4.1 KB	2022-12-15 15:25	EDIT
📄 CAA.php	PHP	4.1 KB	2022-12-15 15:25	EDIT
📄 CDNSKEY.php	PHP	450 B	2022-12-15 15:25	EDIT
📄 CDS.php	PHP	431 B	2022-12-15 15:25	EDIT
📄 CERT.php	PHP	5.5 KB	2022-12-15 15:25	EDIT
📄 CNAME.php	PHP	1.3 KB	2022-12-15 15:25	EDIT
📄 CSYNC.php	PHP	2.5 KB	2022-12-15 15:25	EDIT
📄 DecodeException.php	PHP	933 B	2022-12-15 15:25	EDIT
📄 DHCID.php	PHP	5.6 KB	2022-12-15 15:25	EDIT
📄 DLV.php	PHP	455 B	2022-12-15 15:25	EDIT
📄 DNAME.php	PHP	674 B	2022-12-15 15:25	EDIT
📄 DNSKEY.php	PHP	1 KB	2022-12-15 15:25	EDIT
📄 DS.php	PHP	3.9 KB	2022-12-15 15:25	EDIT
📄 Factory.php	PHP	17.4 KB	2022-12-15 15:25	EDIT
📄 HINFO.php	PHP	2.2 KB	2022-12-15 15:25	EDIT
📄 HIP.php	PHP	4.4 KB	2022-12-15 15:25	EDIT
📄 IPSECKEY.php	PHP	9.3 KB	2022-12-15 15:25	EDIT
📄 KEY.php	PHP	3.3 KB	2022-12-15 15:25	EDIT
📄 KX.php	PHP	2.4 KB	2022-12-15 15:25	EDIT
📄 LOC.php	PHP	7.4 KB	2022-12-15 15:25	EDIT
📄 MX.php	PHP	2.5 KB	2022-12-15 15:25	EDIT
📄 NAPTR.php	PHP	7.1 KB	2022-12-15 15:25	EDIT
📄 NS.php	PHP	442 B	2022-12-15 15:25	EDIT
📄 NSEC.php	PHP	4.1 KB	2022-12-15 15:25	EDIT
📄 NSEC3.php	PHP	8.1 KB	2022-12-15 15:25	EDIT
📄 NSEC3PARAM.php	PHP	3.6 KB	2022-12-15 15:25	EDIT
📄 OPT.php	PHP	2.8 KB	2022-12-15 15:25	EDIT
📄 PolymorphicRdata.php	PHP	2 KB	2022-12-15 15:25	EDIT
📄 PTR.php	PHP	4.2 KB	2022-12-15 15:25	EDIT
📄 RdataInterface.php	PHP	1.7 KB	2022-12-15 15:25	EDIT
📄 RdataTrait.php	PHP	803 B	2022-12-15 15:25	EDIT
📄 RP.php	PHP	1.8 KB	2022-12-15 15:25	EDIT
📄 RRSIG.php	PHP	8 KB	2022-12-15 15:25	EDIT
📄 SIG.php	PHP	378 B	2022-12-15 15:25	EDIT
📄 SOA.php	PHP	5.8 KB	2022-12-15 15:25	EDIT
📄 SPF.php	PHP	432 B	2022-12-15 15:25	EDIT
📄 SRV.php	PHP	4.6 KB	2022-12-15 15:25	EDIT
📄 SSHFP.php	PHP	3.4 KB	2022-12-15 15:25	EDIT
📄 TA.php	PHP	441 B	2022-12-15 15:25	EDIT
📄 TKEY.php	PHP	7.4 KB	2022-12-15 15:25	EDIT
📄 TLSA.php	PHP	4.7 KB	2022-12-15 15:25	EDIT
📄 TSIG.php	PHP	6.5 KB	2022-12-15 15:25	EDIT
📄 TXT.php	PHP	3.4 KB	2022-12-15 15:25	EDIT
📄 Types.php	PHP	10.3 KB	2022-12-15 15:25	EDIT
📄 UnknownType.php	PHP	2.2 KB	2022-12-15 15:25	EDIT
📄 UnsupportedTypeException.php	PHP	477 B	2022-12-15 15:25	EDIT
📄 URI.php	PHP	3.7 KB	2022-12-15 15:25	EDIT