Open main menu


Available from version 1.13.0
Called when setting user cookies
Define function:
public static function onUserSetCookies( User $user, array &$session, array &$cookies ) { ... }
Attach hook:

In extension.json:

	"Hooks": {
		"UserSetCookies": "MyExtensionHooks::onUserSetCookies"

For MediaWiki ≤1.25:

$wgHooks['UserSetCookies'][] = 'MyExtensionHooks::onUserSetCookies';
Called from:File(s): session/CookieSessionProvider.php
Function(s): persistSession

For more information about attaching hooks, see Manual:Hooks.
For examples of extensions using this hook, see Category:UserSetCookies extensions.


  • $user: User object
  • &$session: session array, will be added to $_SESSION
  • &$cookies: cookies array mapping cookie name to its value