WordPress\AiClient\Providers\ApiBasedImplementation

AbstractApiProvider{} │ abstract │ WP 0.2.0└─ AbstractProvider

Base class for API-based providers.

This abstract class provides URL construction utilities for providers that communicate with REST APIs. It standardizes the pattern of combining a base URL with endpoint paths.

No Hooks.

Usage

$AbstractApiProvider = new AbstractApiProvider();
// use class methods

Methods

  1. public baseUrl()
  2. public static url(string $path = '')

Changelog

Since 0.2.0 Introduced.

AbstractApiProvider{} code WP 7.0

wp-includes/php-ai-client/src/Providers/ApiBasedImplementation/AbstractApiProvider.php 
abstract class AbstractApiProvider extends AbstractProvider
{
    /**
     * Gets the base URL for the provider's API.
     *
     * The base URL should include the protocol and domain, and may include
     * the API version path (e.g., "https://api.example.com/v1").
     *
     * @since 0.2.0
     *
     * @return string The base URL for the provider's API.
     */
    abstract protected static function baseUrl(): string;
    /**
     * Constructs a full URL by combining the base URL with an optional path.
     *
     * This method ensures proper URL construction by:
     * - Using the provider's base URL
     * - Trimming leading slashes from the path to prevent double-slashes
     * - Joining the base URL and path with a single forward slash
     *
     * @since 0.2.0
     *
     * @param string $path Optional path to append to the base URL. Default empty string.
     * @return string The complete URL.
     */
    public static function url(string $path = ''): string
    {
        if ($path === '') {
            return static::baseUrl();
        }
        return static::baseUrl() . '/' . ltrim($path, '/');
    }
}