wikimedia/mediawiki-extensions-Wikibase

<?php

declare( strict_types = 1 );

namespace Wikibase\Lib;

use MediaWiki\Language\Language;
use MediaWiki\Message\Message;
use MediaWiki\StubObject\StubUserLang;
use MessageLocalizer;
use Wikimedia\Message\MessageSpecifier;

/**
 * A provider for messages in a particular language.
 *
 * The language is not optional – this service distinguished from {@see MessageLocalizer}
 * by being agnostic of the user language.
 *
 * @license GPL-2.0-or-later
 */
interface MessageInLanguageProvider {

    /**
     * Get a translated interface message in the specified language.
     *
     * @see MessageLocalizer::msg()
     * @see Message::inLanguage()
     *
     * @param string|string[]|MessageSpecifier $key
     * @param Language|StubUserLang|string $language
     * @param mixed ...$params
     * @return Message
     */
    public function msgInLang( $key, $language, ...$params ): Message;

}