151 lines
2.8 KiB
PHP
151 lines
2.8 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
|
*/
|
|
|
|
namespace KTXF\Resource\Provider;
|
|
|
|
/**
|
|
* Resource Service Location Uri
|
|
*
|
|
* URI-based service location for API and web services (e.g., https://api.example.com:443/v1/endpoint).
|
|
*
|
|
* @since 2025.05.01
|
|
*/
|
|
interface ResourceServiceLocationUri extends ResourceServiceLocationInterface {
|
|
|
|
/**
|
|
* Gets the complete location URI
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @return string Complete URI (e.g., "https://api.example.com:443/v1")
|
|
*/
|
|
public function location(): string;
|
|
|
|
/**
|
|
* Gets the URI scheme
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @return string Scheme (e.g., "https", "http")
|
|
*/
|
|
public function getScheme(): string;
|
|
|
|
/**
|
|
* Sets the URI scheme
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @param string $value
|
|
*
|
|
* @return void
|
|
*/
|
|
public function setScheme(string $value): void;
|
|
|
|
/**
|
|
* Gets the host
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @return string Host (e.g., "api.example.com")
|
|
*/
|
|
public function getHost(): string;
|
|
|
|
/**
|
|
* Sets the host
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @param string $value
|
|
*
|
|
* @return void
|
|
*/
|
|
public function setHost(string $value): void;
|
|
|
|
/**
|
|
* Gets the port
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @return int Port number
|
|
*/
|
|
public function getPort(): int;
|
|
|
|
/**
|
|
* Sets the port
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @param int $value
|
|
*
|
|
* @return void
|
|
*/
|
|
public function setPort(int $value): void;
|
|
|
|
/**
|
|
* Gets the path
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @return string Path (e.g., "/v1/api")
|
|
*/
|
|
public function getPath(): string;
|
|
|
|
/**
|
|
* Sets the path
|
|
*
|
|
* @since 2025.05.01
|
|
*
|
|
* @param string $value
|
|
*
|
|
* @return void
|
|
*/
|
|
public function setPath(string $value): void;
|
|
|
|
/**
|
|
* Gets whether to verify SSL/TLS peer certificate
|
|
*
|
|
* @since 2025.12.01
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getVerifyPeer(): bool;
|
|
|
|
/**
|
|
* Sets whether to verify SSL/TLS peer certificate
|
|
*
|
|
* @since 2025.12.01
|
|
*
|
|
* @param bool $value
|
|
*
|
|
* @return void
|
|
*/
|
|
public function setVerifyPeer(bool $value): void;
|
|
|
|
/**
|
|
* Gets whether to verify SSL/TLS certificate host
|
|
*
|
|
* @since 2025.12.01
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function getVerifyHost(): bool;
|
|
|
|
/**
|
|
* Sets whether to verify SSL/TLS certificate host
|
|
*
|
|
* @since 2025.12.01
|
|
*
|
|
* @param bool $value
|
|
*
|
|
* @return void
|
|
*/
|
|
public function setVerifyHost(bool $value): void;
|
|
|
|
}
|