generated from Nodarx/template
135 lines
5.0 KiB
PHP
135 lines
5.0 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
|
*/
|
|
|
|
namespace KTXM\ProviderImap\Providers;
|
|
|
|
use Gricob\IMAP\Configuration;
|
|
use KTXF\Resource\Provider\ResourceServiceLocationInterface;
|
|
|
|
/**
|
|
* IMAP Service Location
|
|
*
|
|
* Connection details for an IMAP server (host / port / encryption).
|
|
*/
|
|
class ServiceLocation implements ResourceServiceLocationInterface
|
|
{
|
|
public function __construct(
|
|
private string $host = '',
|
|
private int $port = 993,
|
|
private string $encryption = 'ssl', // ssl | tls | starttls | none
|
|
private bool $verifyPeer = true,
|
|
private bool $verifyPeerName = true,
|
|
private bool $allowSelfSigned = false,
|
|
) {}
|
|
|
|
// ── Serialisation ────────────────────────────────────────────────────────
|
|
|
|
public function toStore(): array
|
|
{
|
|
return $this->jsonSerialize();
|
|
}
|
|
|
|
public function fromStore(array $data): static
|
|
{
|
|
return $this->jsonDeserialize($data);
|
|
}
|
|
|
|
public function jsonSerialize(): array
|
|
{
|
|
return array_filter([
|
|
'type' => self::TYPE_URI,
|
|
'host' => $this->host,
|
|
'port' => $this->port,
|
|
'encryption' => $this->encryption,
|
|
'verifyPeer' => $this->verifyPeer,
|
|
'verifyPeerName' => $this->verifyPeerName,
|
|
'allowSelfSigned' => $this->allowSelfSigned,
|
|
], fn($v) => $v !== null && $v !== '');
|
|
}
|
|
|
|
public function jsonDeserialize(array|string $data): static
|
|
{
|
|
if (is_string($data)) {
|
|
$data = json_decode($data, true);
|
|
}
|
|
|
|
$this->host = $data['host'] ?? '';
|
|
$this->port = (int)($data['port'] ?? 993);
|
|
$this->encryption = $data['encryption'] ?? 'ssl';
|
|
$this->verifyPeer = $data['verifyPeer'] ?? true;
|
|
$this->verifyPeerName = $data['verifyPeerName'] ?? true;
|
|
$this->allowSelfSigned = $data['allowSelfSigned'] ?? false;
|
|
|
|
return $this;
|
|
}
|
|
|
|
// ── ResourceServiceLocationInterface ─────────────────────────────────────
|
|
|
|
public function type(): string
|
|
{
|
|
return self::TYPE_URI;
|
|
}
|
|
|
|
public function location(): string
|
|
{
|
|
return $this->encryption . '://' . $this->host . ':' . $this->port;
|
|
}
|
|
|
|
// ── Accessors ────────────────────────────────────────────────────────────
|
|
|
|
public function getHost(): string { return $this->host; }
|
|
public function setHost(string $v): void { $this->host = $v; }
|
|
|
|
public function getPort(): int { return $this->port; }
|
|
public function setPort(int $v): void { $this->port = $v; }
|
|
|
|
public function getEncryption(): string { return $this->encryption; }
|
|
public function setEncryption(string $v): void { $this->encryption = $v; }
|
|
|
|
public function getVerifyPeer(): bool { return $this->verifyPeer; }
|
|
public function setVerifyPeer(bool $v): void { $this->verifyPeer = $v; }
|
|
|
|
public function getVerifyPeerName(): bool { return $this->verifyPeerName; }
|
|
public function setVerifyPeerName(bool $v): void { $this->verifyPeerName = $v; }
|
|
|
|
public function getAllowSelfSigned(): bool { return $this->allowSelfSigned; }
|
|
public function setAllowSelfSigned(bool $v): void { $this->allowSelfSigned = $v; }
|
|
|
|
// ── gricob helper ────────────────────────────────────────────────────────
|
|
|
|
/**
|
|
* Build a Gricob IMAP Configuration from this location.
|
|
*
|
|
* gricob passes the transport directly to stream_socket_client:
|
|
* 'ssl' → ssl://host:port (implicit TLS, port 993)
|
|
* 'tcp' → tcp://host:port (plain TCP; STARTTLS negotiation is not
|
|
* supported by gricob, so starttls/none both
|
|
* use plain TCP)
|
|
*/
|
|
public function toConfiguration(): Configuration
|
|
{
|
|
// Map our encryption label to a stream_socket_client transport.
|
|
// gricob has no STARTTLS negotiation, so starttls falls back to tcp.
|
|
$transport = match ($this->encryption) {
|
|
'ssl', 'tls' => 'ssl',
|
|
default => 'tcp', // starttls, none
|
|
};
|
|
|
|
return new Configuration(
|
|
transport: $transport,
|
|
host: $this->host,
|
|
port: $this->port,
|
|
verifyPeer: $this->verifyPeer,
|
|
verifyPeerName: $this->verifyPeerName,
|
|
allowSelfSigned: $this->allowSelfSigned,
|
|
useUid: true,
|
|
);
|
|
}
|
|
}
|