MediaWiki\Utils\MWRestrictions Class Reference

A class to check request restrictions expressed as a JSON object. More...

Inherits Stringable.

Collaboration diagram for MediaWiki\Utils\MWRestrictions:

Public Member Functions
	__toString ()
	check (WebRequest $request)
	Test against the passed WebRequest.
	checkIP ( $ip)
	Test if an IP address is allowed by the restrictions.
	toArray ()
	Return the restrictions as an array.
	toJson ( $pretty=false)
	Return the restrictions as a JSON string.
	userCan (LinkTarget $target)
	Test whether an action on the target is allowed by the restrictions.

Static Public Member Functions
static	newDefault ()
static	newFromArray (array $restrictions)
static	newFromJson ( $json)

Public Attributes
StatusValue	$validity

Protected Member Functions
	__construct (?array $restrictions=null)

Detailed Description

A class to check request restrictions expressed as a JSON object.

Definition at line 24 of file MWRestrictions.php.

Constructor & Destructor Documentation

__construct()

MediaWiki\Utils\MWRestrictions::__construct ( ?array $restrictions = null )

protected

Parameters

array | null

$restrictions

Exceptions

InvalidArgumentException

Definition at line 38 of file MWRestrictions.php.

Member Function Documentation

__toString()

MediaWiki\Utils\MWRestrictions::__toString

(

)

Definition at line 129 of file MWRestrictions.php.

References MediaWiki\Utils\MWRestrictions\toJson().

check()

MediaWiki\Utils\MWRestrictions::check

(

WebRequest

$request

)

Test against the passed WebRequest.

Parameters

WebRequest

$request

Returns

Status

Definition at line 138 of file MWRestrictions.php.

References MediaWiki\Utils\MWRestrictions\checkIP(), and MediaWiki\Request\WebRequest\getIP().

checkIP()

MediaWiki\Utils\MWRestrictions::checkIP

(

$ip

)

Test if an IP address is allowed by the restrictions.

Parameters

string

$ip

Returns

bool

Definition at line 166 of file MWRestrictions.php.

Referenced by MediaWiki\Utils\MWRestrictions\check().

newDefault()

static MediaWiki\Utils\MWRestrictions::newDefault ( )

static

Returns

MWRestrictions

Definition at line 48 of file MWRestrictions.php.

Referenced by MediaWiki\HTMLForm\Field\HTMLRestrictionsField\getDefault().

newFromArray()

static MediaWiki\Utils\MWRestrictions::newFromArray ( array $restrictions )

static

Parameters

array

$restrictions

Returns

MWRestrictions

Exceptions

InvalidArgumentException

Definition at line 57 of file MWRestrictions.php.

Referenced by MediaWiki\HTMLForm\Field\HTMLRestrictionsField\loadDataFromRequest().

newFromJson()

static MediaWiki\Utils\MWRestrictions::newFromJson ( $json )

static

Parameters

string

$json

JSON representation of the restrictions

Returns

MWRestrictions

Exceptions

InvalidArgumentException

Definition at line 66 of file MWRestrictions.php.

toArray()

MediaWiki\Utils\MWRestrictions::toArray

(

)

Return the restrictions as an array.

Returns

array

Definition at line 112 of file MWRestrictions.php.

Referenced by MediaWiki\Utils\MWRestrictions\toJson().

toJson()

MediaWiki\Utils\MWRestrictions::toJson

(

$pretty = false

)

Return the restrictions as a JSON string.

Parameters

bool | string

$pretty

Pretty-print the JSON output, see FormatJson::encode

Returns

string

Definition at line 125 of file MWRestrictions.php.

References MediaWiki\Utils\MWRestrictions\toArray().

Referenced by MediaWiki\Utils\MWRestrictions\__toString().

userCan()

MediaWiki\Utils\MWRestrictions::userCan

(

LinkTarget

$target

)

Test whether an action on the target is allowed by the restrictions.

Access: internal

Parameters

LinkTarget

$target

Returns

StatusValue

Definition at line 154 of file MWRestrictions.php.

Member Data Documentation

$validity

StatusValue MediaWiki\Utils\MWRestrictions::$validity

Definition at line 32 of file MWRestrictions.php.

---

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

• includes/Utils/MWRestrictions.php