Registers an event for the current visitor to the flood control mechanism.

Parameters

string $name: The name of an event. To prevent unintended name clashes, it is recommended to use the module name first in the event name, optionally followed by a dot and the actual event name (e.g. "my_module.my_event").

int $window: (optional) Number of seconds before this event expires. Defaults to 3600 (1 hour). Typically uses the same value as the isAllowed() $window parameter. Expired events are purged on cron run to prevent the flood table from growing indefinitely.

string $identifier: (optional) Unique identifier of the current user. Defaults to the current user's IP address. The identifier can be given an additional prefix separated by "-". Flood backends may then optionally implement the PrefixFloodInterface which allows all flood events that share the same prefix to be cleared simultaneously.

Overrides FloodInterface::register

File

core/modules/user/src/UserFloodControl.php, line 80

Class

UserFloodControl

User Flood Control service.

Namespace

Drupal\user

Code

public function register($name, $window = 3600, $identifier = NULL) {
  return $this->flood
    ->register($name, $window, $identifier);
}

---