This wraps a bunch of the API-specific parameter validation logic. More...

Collaboration diagram for MediaWiki\Api\Validator\ApiParamValidator:

[legend]

Public Member Functions
	__construct (ApiMain $main, ObjectFactory $objectFactory)

	checkSettings (ApiBase $module, array $params, string $name, array $options)
	Check settings for the Action API.

	getHelpInfo (ApiBase $module, string $name, $settings, array $options)
	Describe parameter settings in human-readable format.

	getParamInfo (ApiBase $module, string $name, $settings, array $options)
	Describe parameter settings in a machine-readable format.

	getValue (ApiBase $module, string $name, $settings, array $options=[])
	Get and validate a value.

	knownTypes ()
	List known type names.

	normalizeSettings ( $settings)
	Adjust certain settings where ParamValidator differs from historical Action API behavior.

	validateValue (ApiBase $module, string $name, $value, $settings, array $options=[])
	Valiate a parameter value using a settings array.

Private Member Functions
	checkSettingsMessage (ApiBase $module, string $key, $value, array &$ret)
	Check an API settings message.

	convertValidationException (ApiBase $module, ValidationException $ex)
	Convert a ValidationException to an ApiUsageException.

	mapDeprecatedSettingsMessages (array $settings)
	Map deprecated styles for messages for ParamValidator.

Private Attributes
MessageConverter	$messageConverter

ParamValidator	$paramValidator

const	TYPE_DEFS
	Type defs for ParamValidator.

Detailed Description

This wraps a bunch of the API-specific parameter validation logic.

It's intended to be used in ApiMain by composition.

Since: 1.35

Definition at line 37 of file ApiParamValidator.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Api\Validator\ApiParamValidator::__construct	(	ApiMain	$main,
		ObjectFactory	$objectFactory
	)

Definition at line 82 of file ApiParamValidator.php.

Member Function Documentation

◆ checkSettings()

MediaWiki\Api\Validator\ApiParamValidator::checkSettings	(	ApiBase	$module,
		array	$params,
		string	$name,
		array	$options
	)

Check settings for the Action API.

Parameters

ApiBase	$module
array	$params	All module params to test
string	$name	Parameter to test
array	$options	Options array

Returns: array As for ParamValidator::checkSettings()

Definition at line 177 of file ApiParamValidator.php.

◆ checkSettingsMessage()

MediaWiki\Api\Validator\ApiParamValidator::checkSettingsMessage	(	ApiBase	$module,
		string	$key,
			$value,
		array &	$ret
	)

private

Check an API settings message.

Parameters

ApiBase	$module
string	$key
mixed	$value
array	&$ret

Definition at line 160 of file ApiParamValidator.php.

◆ convertValidationException()

MediaWiki\Api\Validator\ApiParamValidator::convertValidationException	(	ApiBase	$module,
		ValidationException	$ex
	)

private

Convert a ValidationException to an ApiUsageException.

Parameters

ApiBase	$module
ValidationException	$ex

Exceptions

ApiUsageException always

Definition at line 325 of file ApiParamValidator.php.

◆ getHelpInfo()

MediaWiki\Api\Validator\ApiParamValidator::getHelpInfo	(	ApiBase	$module,
		string	$name,
			$settings,
		array	$options
	)

Describe parameter settings in human-readable format.

Parameters

ApiBase	$module
string	$name	Parameter name being described.
array \| mixed	$settings	Default value or an array of settings using PARAM_* constants.
array	$options	Options array.

Returns: Message[]

Definition at line 409 of file ApiParamValidator.php.

◆ getParamInfo()

MediaWiki\Api\Validator\ApiParamValidator::getParamInfo	(	ApiBase	$module,
		string	$name,
			$settings,
		array	$options
	)

Describe parameter settings in a machine-readable format.

Parameters

ApiBase	$module
string	$name	Parameter name.
array \| mixed	$settings	Default value or an array of settings using PARAM_* constants.
array	$options	Options array.

Returns: array

Definition at line 393 of file ApiParamValidator.php.

◆ getValue()

MediaWiki\Api\Validator\ApiParamValidator::getValue	(	ApiBase	$module,
		string	$name,
			$settings,
		array	$options = `[]`
	)

Get and validate a value.

Parameters

ApiBase	$module
string	$name	Parameter name, unprefixed
array \| mixed	$settings	Default value or an array of settings using PARAM_* constants.
array	$options	Options array

Returns: mixed Validated parameter value

Exceptions

ApiUsageException if the value is invalid

Definition at line 347 of file ApiParamValidator.php.

References ApiBase\encodeParamName().

◆ knownTypes()

MediaWiki\Api\Validator\ApiParamValidator::knownTypes ( )

List known type names.

Returns: string[]

Definition at line 98 of file ApiParamValidator.php.

◆ mapDeprecatedSettingsMessages()

MediaWiki\Api\Validator\ApiParamValidator::mapDeprecatedSettingsMessages ( array $settings )

private

Map deprecated styles for messages for ParamValidator.

Parameters

array $settings

Returns: array

Definition at line 107 of file ApiParamValidator.php.

References ApiMessage\create().

◆ normalizeSettings()

MediaWiki\Api\Validator\ApiParamValidator::normalizeSettings ( $settings )

Adjust certain settings where ParamValidator differs from historical Action API behavior.

Parameters

array | mixed $settings

Returns: array

Definition at line 137 of file ApiParamValidator.php.

◆ validateValue()

MediaWiki\Api\Validator\ApiParamValidator::validateValue	(	ApiBase	$module,
		string	$name,
			$value,
			$settings,
		array	$options = `[]`
	)

Valiate a parameter value using a settings array.

Parameters

ApiBase	$module
string	$name	Parameter name, unprefixed
mixed	$value	Parameter value
array \| mixed	$settings	Default value or an array of settings using PARAM_* constants.
array	$options	Options array

Returns: mixed Validated parameter value(s)

Exceptions

ApiUsageException if the value is invalid

Definition at line 370 of file ApiParamValidator.php.

References ApiBase\encodeParamName().

Member Data Documentation

◆ $messageConverter

MessageConverter MediaWiki\Api\Validator\ApiParamValidator::$messageConverter

private

Definition at line 43 of file ApiParamValidator.php.

◆ $paramValidator

ParamValidator MediaWiki\Api\Validator\ApiParamValidator::$paramValidator

private

Definition at line 40 of file ApiParamValidator.php.

◆ TYPE_DEFS

const MediaWiki\Api\Validator\ApiParamValidator::TYPE_DEFS

private

Initial value:

= [
        'boolean' => [ 'class' => PresenceBooleanDef::class ],
        'enum' => [ 'class' => EnumDef::class ],
        'expiry' => [ 'class' => ExpiryDef::class ],
        'integer' => [ 'class' => IntegerDef::class ],
        'limit' => [ 'class' => LimitDef::class ],
        'namespace' => [
            'class' => NamespaceDef::class,
            'services' => [ 'NamespaceInfo' ],
        ],
        'NULL' => [
            'class' => StringDef::class,
            'args' => [ [
                'allowEmptyWhenRequired' => true,
            ] ],
        ],
        'password' => [ 'class' => PasswordDef::class ],
        'string' => [ 'class' => StringDef::class ],
        'submodule' => [ 'class' => SubmoduleDef::class ],
        'tags' => [ 'class' => TagsDef::class ],
        'text' => [ 'class' => StringDef::class ],
        'timestamp' => [
            'class' => TimestampDef::class,
            'args' => [ [
                'defaultFormat' => TS_MW,
            ] ],
        ],
        'user' => [ 'class' => UserDef::class ],
        'upload' => [ 'class' => UploadDef::class ],
    ]

Type defs for ParamValidator.

Definition at line 46 of file ApiParamValidator.php.

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

includes/api/Validator/ApiParamValidator.php

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ checkSettings()

◆ checkSettingsMessage()

◆ convertValidationException()

◆ getHelpInfo()

◆ getParamInfo()

◆ getValue()

◆ knownTypes()

◆ mapDeprecatedSettingsMessages()

◆ normalizeSettings()

◆ validateValue()

Member Data Documentation

◆ $messageConverter

◆ $paramValidator

◆ TYPE_DEFS