1. class
  2. Drupal
  3. \
  4. Core
  5. \
  6. Flood
  7. \
  8. MemoryBackend

MemoryBackend

class MemoryBackend implements FloodInterface (View source)

Defines the memory flood backend. This is used for testing.

Properties

protected RequestStack $requestStack

The request stack.
protected $events

An array holding flood events, keyed by event name and identifier.

Methods

__construct(RequestStack $request_stack)

Construct the MemoryBackend.

register(string $name, int $window = 3600, string $identifier = NULL)

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

clear(string $name, string $identifier = NULL)

Makes the flood control mechanism forget an event for the current visitor.

true
isAllowed(string $name, int $threshold, int $window = 3600, string $identifier = NULL)

Checks whether a user is allowed to proceed with the specified event.

garbageCollection()

Cleans up expired flood events. This method is called automatically on cron run.

Details

at line 30
__construct(RequestStack $request_stack)

Construct the MemoryBackend.

Parameters

RequestStack $request_stack

The request stack used to retrieve the current request.

at line 37
register(string $name, int $window = 3600, string $identifier = NULL)

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. "mymodule.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).

at line 50
clear(string $name, string $identifier = NULL)

Makes the flood control mechanism forget an event for the current visitor.

Parameters

string $name

The name of an event.
string $identifier

(optional) Unique identifier of the current user. Defaults to the current user's IP address).

at line 60
true isAllowed(string $name, int $threshold, int $window = 3600, string $identifier = NULL)

Checks whether a user is allowed to proceed with the specified event.

Events can have thresholds saying that each user can only do that event a certain number of times in a time window. This function verifies that the current user has not exceeded this threshold.

Parameters

string $name

The name of an event.
int $threshold

The maximum number of times each user can do this event per time window.
int $window

(optional) Number of seconds in the time window for this event (default is 3600 seconds, or 1 hour).
string $identifier

(optional) Unique identifier of the current user. Defaults to the current user's IP address).

Return Value

true

if the user is allowed to proceed. FALSE if they have exceeded the threshold and should not be allowed to proceed.

at line 77
garbageCollection()

Cleans up expired flood events. This method is called automatically on cron run.