Skip to content

Latest commit

 

History

History
258 lines (224 loc) · 7.01 KB

tls-reporting.md

File metadata and controls

258 lines (224 loc) · 7.01 KB
Raw

TLS reporting (text) records

Create

Create from constructor

$record = new TlsReporting([
	'host' => "_smtp._tls.bluelibraries.com",
	'ttl' => 3600,
	'txt' => "v=TLSRPTv1; rua=mailto:postmaster@test.com"
]);

echo 'getHost = ' . $record->getHost() . PHP_EOL;
echo 'getTtl = ' . $record->getTtl() . PHP_EOL;
echo 'getClass = ' . $record->getClass() . PHP_EOL;
echo 'getTypeName = ' . $record->getTypeName() . PHP_EOL;
echo 'getVersion = ' . $record->getVersion() . PHP_EOL;
echo 'getRua = ' . $record->getRua() . PHP_EOL;
echo 'getTxt = ' . $record->getTxt() . PHP_EOL;
getHost = _smtp._tls.bluelibraries.com
getTtl = 3600
getClass = IN
getTypeName = TLS-REPORTING
getVersion = TLSRPTv1
getRua = mailto:postmaster@test.com
getTxt = v=TLSRPTv1; rua=mailto:postmaster@test.com

Create with a setter

$record = new TlsReporting();
                $record->setData([
	'host' => "_smtp._tls.bluelibraries.com",
	'ttl' => 3600,
	'txt' => "v=TLSRPTv1; rua=mailto:postmaster@test.com"
]);

echo 'getHost = ' . $record->getHost() . PHP_EOL;
echo 'getTtl = ' . $record->getTtl() . PHP_EOL;
echo 'getClass = ' . $record->getClass() . PHP_EOL;
echo 'getTypeName = ' . $record->getTypeName() . PHP_EOL;
echo 'getVersion = ' . $record->getVersion() . PHP_EOL;
echo 'getRua = ' . $record->getRua() . PHP_EOL;
echo 'getTxt = ' . $record->getTxt() . PHP_EOL;
getHost = _smtp._tls.bluelibraries.com
getTtl = 3600
getClass = IN
getTypeName = TLS-REPORTING
getVersion = TLSRPTv1
getRua = mailto:postmaster@test.com
getTxt = v=TLSRPTv1; rua=mailto:postmaster@test.com

Create from string

$record = Record::fromString('_smtp._tls.bluelibraries.com 3600 IN TXT "v=TLSRPTv1; rua=mailto:postmaster@test.com"');

echo 'getHost = ' . $record->getHost() . PHP_EOL;
echo 'getTtl = ' . $record->getTtl() . PHP_EOL;
echo 'getClass = ' . $record->getClass() . PHP_EOL;
echo 'getTypeName = ' . $record->getTypeName() . PHP_EOL;
echo 'getVersion = ' . $record->getVersion() . PHP_EOL;
echo 'getRua = ' . $record->getRua() . PHP_EOL;
echo 'getTxt = ' . $record->getTxt() . PHP_EOL;
getHost = _smtp._tls.bluelibraries.com
getTtl = 3600
getClass = IN
getTypeName = TLS-REPORTING
getVersion = TLSRPTv1
getRua = mailto:postmaster@test.com
getTxt = v=TLSRPTv1; rua=mailto:postmaster@test.com

Create from initialized array

$record = Record::fromNormalizedArray([
	'host' => "_smtp._tls.bluelibraries.com",
	'ttl' => 3600,
	'txt' => "v=TLSRPTv1; rua=mailto:postmaster@test.com",
	'type' => "TXT"
]);

echo 'getHost = ' . $record->getHost() . PHP_EOL;
echo 'getTtl = ' . $record->getTtl() . PHP_EOL;
echo 'getClass = ' . $record->getClass() . PHP_EOL;
echo 'getTypeName = ' . $record->getTypeName() . PHP_EOL;
echo 'getVersion = ' . $record->getVersion() . PHP_EOL;
echo 'getRua = ' . $record->getRua() . PHP_EOL;
echo 'getTxt = ' . $record->getTxt() . PHP_EOL;
getHost = _smtp._tls.bluelibraries.com
getTtl = 3600
getClass = IN
getTypeName = TLS-REPORTING
getVersion = TLSRPTv1
getRua = mailto:postmaster@test.com
getTxt = v=TLSRPTv1; rua=mailto:postmaster@test.com

Retrieve from Internet

Retrieve with helper

$records = DNS::getRecords('_smtp._tls.bluelibraries.com', RecordTypes::TXT);

print_r($records);
Array
(
    [0] => BlueLibraries\Dns\Records\Types\Txt\TLSReporting Object
        (
            [txtRegex:BlueLibraries\Dns\Records\Types\Txt\TLSReporting:private] => /^v=TLSRPTv1; rua=mailto:([a-z.\-_@]+)((,mailto\:([a-z.\-_@]+))+)?$/i
            [data:protected] => Array
                (
                    [host] => _smtp._tls.bluelibraries.com
                    [ttl] => 3600
                    [txt] => v=TLSRPTv1; rua=mailto:postmaster@test.com
                    [type] => TXT
                    [class] => IN
                )

            [parsedValues:BlueLibraries\Dns\Records\Types\Txt\TLSReporting:private] => Array
                (
                )

        )

)

Retrieve without helper

$dns = new DnsRecords();
$records = $dns->get('_smtp._tls.bluelibraries.com', RecordTypes::TXT);

print_r($records);
Array
(
    [0] => BlueLibraries\Dns\Records\Types\Txt\TLSReporting Object
        (
            [txtRegex:BlueLibraries\Dns\Records\Types\Txt\TLSReporting:private] => /^v=TLSRPTv1; rua=mailto:([a-z.\-_@]+)((,mailto\:([a-z.\-_@]+))+)?$/i
            [data:protected] => Array
                (
                    [host] => _smtp._tls.bluelibraries.com
                    [ttl] => 3600
                    [txt] => v=TLSRPTv1; rua=mailto:postmaster@test.com
                    [type] => TXT
                    [class] => IN
                )

            [parsedValues:BlueLibraries\Dns\Records\Types\Txt\TLSReporting:private] => Array
                (
                )

        )

)

Retrieve without helper, using custom handler settings

$dnsHandler = new TCP();
$dnsHandler->setRetries(2);
$dnsHandler->setTimeout(3);
$dnsHandler->setNameserver('8.8.8.8');

$dns = new DnsRecords($dnsHandler);

$records = $dns->get('_smtp._tls.bluelibraries.com', RecordTypes::TXT);

print_r($records);
Array
(
    [0] => BlueLibraries\Dns\Records\Types\Txt\TLSReporting Object
        (
            [txtRegex:BlueLibraries\Dns\Records\Types\Txt\TLSReporting:private] => /^v=TLSRPTv1; rua=mailto:([a-z.\-_@]+)((,mailto\:([a-z.\-_@]+))+)?$/i
            [data:protected] => Array
                (
                    [host] => _smtp._tls.bluelibraries.com
                    [ttl] => 3600
                    [txt] => v=TLSRPTv1; rua=mailto:postmaster@test.com
                    [type] => TXT
                    [class] => IN
                )

            [parsedValues:BlueLibraries\Dns\Records\Types\Txt\TLSReporting:private] => Array
                (
                )

        )

)

Transform

Transform to String

$record = new TlsReporting([
	'host' => "_smtp._tls.bluelibraries.com",
	'ttl' => 3600,
	'txt' => "v=TLSRPTv1; rua=mailto:postmaster@test.com"
]);

echo 'string1 = ' . json_encode($record->toString()) . PHP_EOL;
echo 'string2 = ' . json_encode((string)$record) . PHP_EOL;
string1 = "_smtp._tls.bluelibraries.com 3600 IN TXT \"v=TLSRPTv1; rua=mailto:postmaster@test.com\""
string2 = "_smtp._tls.bluelibraries.com 3600 IN TXT \"v=TLSRPTv1; rua=mailto:postmaster@test.com\""

Transform to JSON

$record = new TlsReporting([
	'host' => "_smtp._tls.bluelibraries.com",
	'ttl' => 3600,
	'txt' => "v=TLSRPTv1; rua=mailto:postmaster@test.com"
]);

echo 'JSON = ' . json_encode($record) . PHP_EOL;
JSON = {"host":"_smtp._tls.bluelibraries.com","ttl":3600,"txt":"v=TLSRPTv1; rua=mailto:postmaster@test.com","class":"IN","type":"TXT"}

Transform to Array

$record = new TlsReporting([
	'host' => "_smtp._tls.bluelibraries.com",
	'ttl' => 3600,
	'txt' => "v=TLSRPTv1; rua=mailto:postmaster@test.com"
]);

print_r($record->toArray());
Array
(
    [host] => _smtp._tls.bluelibraries.com
    [ttl] => 3600
    [txt] => v=TLSRPTv1; rua=mailto:postmaster@test.com
    [class] => IN
    [type] => TXT
)