Improved comments

This commit is contained in:
the-djmaze 2024-03-31 15:32:44 +02:00
parent b9e2d6caca
commit a9e5f1c6f8

View file

@ -28,11 +28,11 @@ abstract class Autoconfig
{ {
$emailaddress = \urlencode($emailaddress); $emailaddress = \urlencode($emailaddress);
foreach ([ foreach ([
// 4.1. Mail provider // Mail provider https://www.ietf.org/archive/id/draft-bucksch-autoconfig-02.html#section-4.1
"https://autoconfig.{$domain}/.well-known/mail-v1.xml?emailaddress={$emailaddress}", "https://autoconfig.{$domain}/.well-known/mail-v1.xml?emailaddress={$emailaddress}",
"https://{$domain}/.well-known/autoconfig/mail/config-v1.1.xml", "https://{$domain}/.well-known/autoconfig/mail/config-v1.1.xml",
"http://autoconfig.{$domain}/mail/config-v1.1.xml", "http://autoconfig.{$domain}/mail/config-v1.1.xml",
// 4.2. Central database // Central database https://www.ietf.org/archive/id/draft-bucksch-autoconfig-02.html#section-4.2
"https://autoconfig.thunderbird.net/v1.1/{$domain}" "https://autoconfig.thunderbird.net/v1.1/{$domain}"
] as $url) { ] as $url) {
$data = \file_get_contents($url); $data = \file_get_contents($url);
@ -87,6 +87,9 @@ abstract class Autoconfig
return $list ?: []; return $list ?: [];
} }
/**
* https://www.ietf.org/archive/id/draft-bucksch-autoconfig-02.html#section-4.3
*/
private static function mx(string $domain, string $emailaddress) : ?array private static function mx(string $domain, string $emailaddress) : ?array
{ {
$suffixes = static::publicsuffixes(); $suffixes = static::publicsuffixes();
@ -161,6 +164,7 @@ abstract class Autoconfig
/** /**
* This is Microsoft * This is Microsoft
* https://learn.microsoft.com/en-us/exchange/client-developer/web-service-reference/pox-autodiscover-web-service-reference-for-exchange
*/ */
private static function autodiscover(string $domain) : ?array private static function autodiscover(string $domain) : ?array
{ {