rtckit/php-sip

<?php
/**
 * RTCKit\SIP\Header\CallIdHeader Class
 */
declare(strict_types = 1);

namespace RTCKit\SIP\Header;

use RTCKit\SIP\Response;
use RTCKit\SIP\Exception\InvalidDuplicateHeaderException;
use RTCKit\SIP\Exception\InvalidHeaderValueException;

/**
 * Call-ID header class
 */
class CallIdHeader
{
    /** @var string Call-ID value */
    public string $value;

    final public function __construct() {}

    /**
     * Call-ID header value parser
     *
     * @param list<string> $hbody Header body
     * @throws InvalidDuplicateHeaderException
     * @return CallIdHeader
     */
    public static function parse(array $hbody): CallIdHeader
    {
        if (isset($hbody[1])) {
            throw new InvalidDuplicateHeaderException('Cannot have more than one Call-ID header', Response::BAD_REQUEST);
        }

        $ret = new static;
        $ret->value = trim($hbody[0]);

        return $ret;
    }

    /**
     * Call-ID header value renderer
     *
     * @param string $hname Header field name
     * @throws InvalidHeaderValueException
     * @return string
     */
    public function render(string $hname): string
    {
        if (!isset($this->value[0])) {
            throw new InvalidHeaderValueException('Missing Call-ID header value');
        }

        return "{$hname}: {$this->value}\r\n";
    }
}