Formats errors and warnings for the API, and add them to the associated ApiResult. More...

Inheritance diagram for ApiErrorFormatter:

Collaboration diagram for ApiErrorFormatter:

[legend]

Public Member Functions
	__construct (ApiResult $result, Language $lang, $format, $useDB=false)

	addError ( $modulePath, $msg, $code=null, $data=null)
	Add an error to the result.

	addMessagesFromStatus ( $modulePath, StatusValue $status, $types=[ 'warning', 'error'], array $filter=[])
	Add warnings and errors from a StatusValue object to the result.

	addWarning ( $modulePath, $msg, $code=null, $data=null)
	Add a warning to the result.

	arrayFromStatus (StatusValue $status, $type='error', $format=null)
	Format messages from a StatusValue as an array.

	formatException ( $exception, array $options=[])
	Format an exception as an array.

	formatMessage ( $msg, $format=null)
	Format a message as an array.

	getFormat ()
	Fetch the format for this formatter.

	getLanguage ()
	Fetch the Language for this formatter.

	getMessageFromException ( $exception, array $options=[])
	Get an ApiMessage from an exception.

	newWithFormat ( $format)
	Return a formatter like this one but with a different format.

Static Public Member Functions
static	isValidApiCode ( $code)
	Test whether a code is a valid API error code.

static	stripMarkup ( $text)
	Turn wikitext into something resembling plaintext.

Protected Member Functions
	addWarningOrError ( $tag, $modulePath, $msg)
	Actually add the warning or error to the result.

	formatMessageInternal ( $msg, $format)
	Format a message as an array.

	getDummyTitle ()
	Fetch a dummy title to set on Messages.

Protected Attributes
	$format = 'none'

Language	$lang

ApiResult	$result

	$useDB = false

Private Member Functions
	formatRawMessage (MessageSpecifier $msg)
	Format a Message object for raw format.

Static Private Attributes
static Title	$dummyTitle = null
	Dummy title to silence warnings from MessageCache::parse()

Detailed Description

Formats errors and warnings for the API, and add them to the associated ApiResult.

Since: 1.25

-file-suppress PhanUndeclaredMethod Undeclared methods in IApiMessage

Definition at line 31 of file ApiErrorFormatter.php.

Constructor & Destructor Documentation

◆ __construct()

ApiErrorFormatter::__construct	(	ApiResult	$result,
		Language	$lang,
			$format,
			$useDB = `false`
	)

Parameters

ApiResult	$result	Into which data will be added
Language	$lang	Used for i18n
string	$format	plaintext: Error message as something vaguely like plaintext (it's basically wikitext with HTML tags stripped and entities decoded) wikitext: Error message as wikitext html: Error message as HTML raw: Raw message key and parameters, no human-readable text none: Code and data only, no human-readable text
bool	$useDB	Whether to use local translations for errors and warnings.

Definition at line 55 of file ApiErrorFormatter.php.

References $format, $lang, $result, and $useDB.

Member Function Documentation

◆ addError()

ApiErrorFormatter::addError	(	$modulePath,
		$msg,
		$code = `null`,
		$data = `null`
	)

Add an error to the result.

Parameters

string \| null	$modulePath
Message \| array \| string	$msg	Warning message. See ApiMessage::create().
string \| null	$code	See ApiMessage::create().
array \| null	$data	See ApiMessage::create().

Definition at line 144 of file ApiErrorFormatter.php.

References addWarningOrError(), ApiMessage\create(), and getDummyTitle().

◆ addMessagesFromStatus()

ApiErrorFormatter::addMessagesFromStatus	(		$modulePath,
		StatusValue	$status,
			$types = `[ 'warning', 'error' ]`,
		array	$filter = `[]`
	)

Add warnings and errors from a StatusValue object to the result.

Parameters

string \| null	$modulePath
StatusValue	$status
string[] \| string	$types	'warning' and/or 'error'
string[]	$filter	Messages to filter out (since 1.33)

Definition at line 159 of file ApiErrorFormatter.php.

References $filter, addWarningOrError(), ApiMessage\create(), getDummyTitle(), StatusValue\getErrors(), and StatusValue\isGood().

Referenced by arrayFromStatus().

◆ addWarning()

ApiErrorFormatter::addWarning	(	$modulePath,
		$msg,
		$code = `null`,
		$data = `null`
	)

Add a warning to the result.

Parameters

string \| null	$modulePath
Message \| array \| string	$msg	Warning message. See ApiMessage::create().
string \| null	$code	See ApiMessage::create().
array \| null	$data	See ApiMessage::create().

Definition at line 129 of file ApiErrorFormatter.php.

References addWarningOrError(), ApiMessage\create(), and getDummyTitle().

◆ addWarningOrError()

ApiErrorFormatter::addWarningOrError	(	$tag,
		$modulePath,
		$msg
	)

protected

Actually add the warning or error to the result.

Parameters

string	$tag	'warning' or 'error'
string \| null	$modulePath
ApiMessage \| ApiRawMessage	$msg

Reimplemented in ApiErrorFormatter_BackCompat.

Definition at line 375 of file ApiErrorFormatter.php.

References $path, ApiResult\ADD_ON_TOP, formatMessageInternal(), and ApiResult\NO_SIZE_CHECK.

Referenced by addError(), addMessagesFromStatus(), and addWarning().

◆ arrayFromStatus()

ApiErrorFormatter::arrayFromStatus	(	StatusValue	$status,
			$type = `'error'`,
			$format = `null`
	)

Format messages from a StatusValue as an array.

Parameters

StatusValue	$status
string	$type	'warning' or 'error'
string \| null	$format

Returns: array

Reimplemented in ApiErrorFormatter_BackCompat.

Definition at line 267 of file ApiErrorFormatter.php.

References $format, $result, $type, $useDB, addMessagesFromStatus(), StatusValue\getErrors(), ApiResult\getResultData(), and StatusValue\isGood().

◆ formatException()

ApiErrorFormatter::formatException	(		$exception,
		array	$options = `[]`
	)

Format an exception as an array.

Since: 1.29

Parameters

Exception \| Throwable	$exception
array	$options	See self::getMessageFromException(), plus format: (string) Format override

Returns: array

Reimplemented in ApiErrorFormatter_BackCompat.

Definition at line 238 of file ApiErrorFormatter.php.

References formatMessage(), and getMessageFromException().

◆ formatMessage()

ApiErrorFormatter::formatMessage	(	$msg,
		$format = `null`
	)

Format a message as an array.

Parameters

Message \| array \| string	$msg	Message. See ApiMessage::create().
string \| null	$format

Returns: array

Definition at line 252 of file ApiErrorFormatter.php.

References $format, ApiMessage\create(), formatMessageInternal(), and getDummyTitle().

Referenced by formatException().

◆ formatMessageInternal()

ApiErrorFormatter::formatMessageInternal	(	$msg,
		$format
	)

protected

Format a message as an array.

Since: 1.29

Parameters

ApiMessage \| ApiRawMessage	$msg
string \| null	$format

Returns: array

Reimplemented in ApiErrorFormatter_BackCompat.

Definition at line 329 of file ApiErrorFormatter.php.

References $format, formatRawMessage(), ApiResult\META_CONTENT, ApiResult\META_TYPE, and stripMarkup().

Referenced by addWarningOrError(), and formatMessage().

◆ formatRawMessage()

ApiErrorFormatter::formatRawMessage ( MessageSpecifier $msg )

private

Format a Message object for raw format.

Parameters

MessageSpecifier $msg

Returns: array

Definition at line 306 of file ApiErrorFormatter.php.

References formatRawMessage(), MessageSpecifier\getKey(), MessageSpecifier\getParams(), and ApiResult\setIndexedTagName().

Referenced by formatMessageInternal(), and formatRawMessage().

◆ getDummyTitle()

ApiErrorFormatter::getDummyTitle ( )

protected

Fetch a dummy title to set on Messages.

Returns: Title

Definition at line 115 of file ApiErrorFormatter.php.

References $dummyTitle, and NS_SPECIAL.

Referenced by addError(), addMessagesFromStatus(), addWarning(), formatMessage(), and getMessageFromException().

◆ getFormat()

ApiErrorFormatter::getFormat ( )

Fetch the format for this formatter.

Since: 1.32

Returns: string

Reimplemented in ApiErrorFormatter_BackCompat.

Definition at line 98 of file ApiErrorFormatter.php.

References $format.

◆ getLanguage()

ApiErrorFormatter::getLanguage ( )

Fetch the Language for this formatter.

Since: 1.29

Returns: Language

Definition at line 107 of file ApiErrorFormatter.php.

References $lang.

◆ getMessageFromException()

ApiErrorFormatter::getMessageFromException	(		$exception,
		array	$options = `[]`
	)

Get an ApiMessage from an exception.

Since: 1.29

Parameters

Exception \| Throwable	$exception
array	$options	wrap: (string\|array\|MessageSpecifier) Used to wrap the exception's message if it's not an ILocalizedException. The exception's message will be added as the final parameter. code: (string) Default code data: (array) Default extra data

Returns: IApiMessage

Definition at line 201 of file ApiErrorFormatter.php.

References ApiMessage\create(), getDummyTitle(), Message\newFromSpecifier(), and wfEscapeWikiText().

Referenced by formatException().

◆ isValidApiCode()

static ApiErrorFormatter::isValidApiCode ( $code )

static

Test whether a code is a valid API error code.

A valid code contains only ASCII letters, numbers, underscore, and hyphen and is not the empty string.

For backwards compatibility, any code beginning 'internal_api_error_' is also allowed.

Parameters

string $code

Returns: bool

Definition at line 74 of file ApiErrorFormatter.php.

Referenced by setApiCode(), and ApiMain\substituteResultWithError().

◆ newWithFormat()

ApiErrorFormatter::newWithFormat ( $format )

Return a formatter like this one but with a different format.

Since: 1.32

Parameters

string $format New format.

Returns: ApiErrorFormatter

Definition at line 89 of file ApiErrorFormatter.php.

References $format, $lang, $result, and $useDB.

◆ stripMarkup()

static ApiErrorFormatter::stripMarkup ( $text )

static

Turn wikitext into something resembling plaintext.

Since: 1.29

Parameters

string $text

Returns: string

Definition at line 291 of file ApiErrorFormatter.php.

Referenced by ApiUsageException\__construct(), ApiUsageException\__toString(), ApiErrorFormatter_BackCompat\addWarningOrError(), ApiLogin\formatMessage(), and formatMessageInternal().

Member Data Documentation

◆ $dummyTitle

Title ApiErrorFormatter::$dummyTitle = null

staticprivate

Dummy title to silence warnings from MessageCache::parse()

Definition at line 33 of file ApiErrorFormatter.php.

Referenced by getDummyTitle().

◆ $format

ApiErrorFormatter::$format = 'none'

protected

Definition at line 41 of file ApiErrorFormatter.php.

Referenced by __construct(), arrayFromStatus(), formatMessage(), formatMessageInternal(), getFormat(), and newWithFormat().

◆ $lang

Language ApiErrorFormatter::$lang

protected

Definition at line 39 of file ApiErrorFormatter.php.

Referenced by __construct(), getLanguage(), and newWithFormat().

◆ $result

ApiResult ApiErrorFormatter::$result

protected

Definition at line 36 of file ApiErrorFormatter.php.

Referenced by ApiErrorFormatter_BackCompat\__construct(), __construct(), arrayFromStatus(), ApiErrorFormatter_BackCompat\arrayFromStatus(), and newWithFormat().

◆ $useDB

ApiErrorFormatter::$useDB = false

protected

Definition at line 40 of file ApiErrorFormatter.php.

Referenced by __construct(), arrayFromStatus(), and newWithFormat().

The documentation for this class was generated from the following file:

includes/api/ApiErrorFormatter.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addError()

◆ addMessagesFromStatus()

◆ addWarning()

◆ addWarningOrError()

◆ arrayFromStatus()

◆ formatException()

◆ formatMessage()

◆ formatMessageInternal()

◆ formatRawMessage()

◆ getDummyTitle()

◆ getFormat()

◆ getLanguage()

◆ getMessageFromException()

◆ isValidApiCode()

◆ newWithFormat()

◆ stripMarkup()

Member Data Documentation

◆ $dummyTitle

◆ $format

◆ $lang

◆ $result

◆ $useDB