MediaWiki REL1_39
MediaWiki\Session\CsrfTokenSet Class Reference

Public Member Functions

 __construct (WebRequest $request)
 
 getToken ( $salt='')
 Initialize (if necessary) and return a current user CSRF token value which can be used in edit forms to show that the user's login credentials aren't being hijacked with a foreign form submission.
 
 matchToken (?string $value, $salt='')
 Check if a value matches with the token value stored in the session.
 
 matchTokenField (string $fieldName=self::DEFAULT_FIELD_NAME, $salt='')
 Check if a request contains a value named $valueName with the token value stored in the session.
 

Detailed Description

Definition at line 31 of file CsrfTokenSet.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Session\CsrfTokenSet::__construct ( WebRequest  $request)
Parameters
WebRequest$request

Definition at line 46 of file CsrfTokenSet.php.

Member Function Documentation

◆ getToken()

MediaWiki\Session\CsrfTokenSet::getToken (   $salt = '')

Initialize (if necessary) and return a current user CSRF token value which can be used in edit forms to show that the user's login credentials aren't being hijacked with a foreign form submission.

The $salt for 'edit' and 'csrf' tokens is the default (empty string).

Parameters
string | string[]$saltOptional function-specific data for hashing
Returns
Token
Since
1.37

Definition at line 62 of file CsrfTokenSet.php.

◆ matchToken()

MediaWiki\Session\CsrfTokenSet::matchToken ( ?string  $value,
  $salt = '' 
)

Check if a value matches with the token value stored in the session.

A match should confirm that the form was submitted from the user's own login session, not a form submission from a third-party site.

Parameters
string | null$value
string | string[]$salt
Returns
bool
Since
1.37

Definition at line 97 of file CsrfTokenSet.php.

◆ matchTokenField()

MediaWiki\Session\CsrfTokenSet::matchTokenField ( string  $fieldName = self::DEFAULT_FIELD_NAME,
  $salt = '' 
)

Check if a request contains a value named $valueName with the token value stored in the session.

Parameters
string$fieldName
string | string[]$salt
Returns
bool
Since
1.37
See also
self::matchCSRFToken

Definition at line 80 of file CsrfTokenSet.php.


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