PHPackages                             mindforce/attempt - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Security](/categories/security)
4. /
5. mindforce/attempt

ActiveCakephp-plugin[Security](/categories/security)

mindforce/attempt
=================

A CakePHP plugin that helps to protect sensitive actions from brute force attacks

01.4kPHP

Since Oct 18Pushed 10y ago2 watchersCompare

[ Source](https://github.com/mindforce/Attempt)[ Packagist](https://packagist.org/packages/mindforce/attempt)[ RSS](/packages/mindforce-attempt/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Attempt Plugin
==============

[](#attempt-plugin)

A CakePHP 2.0 or 2.1 plugin that helps to protect sensitive actions from brute force attacks.

API
---

[](#api)

### count($action)

[](#countaction)

Returns the number of failed attempts for a certain action.

### limit($action, $limit = 5)

[](#limitaction-limit--5)

Returns false if the number of failed attempts is bigger than the passed limit.

### fail($action, $duration = '+10 minutes')

[](#failaction-duration--10-minutes)

Creates a failed attempt that counts towards the limit for the passed duration

### reset($action)

[](#resetaction)

Deletes all failed attempts for a certain action

### cleanup()

[](#cleanup)

Deletes all expired failed attempts from the database. This should be run via CakeShell (ideally as a CRON job) every now and then.

Schema
------

[](#schema)

Run `Console/cake schema create --plugin Attempt` or manually make a table:

```
CREATE TABLE `attempts` (
  `id` char(36) NOT NULL DEFAULT '',
  `ip` varchar(64) DEFAULT NULL,
  `action` varchar(32) DEFAULT NULL,
  `created` datetime DEFAULT NULL,
  `expires` datetime DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `ip` (`ip`,`action`),
  KEY `expires` (`expires`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8

```

Example Implementation
----------------------

[](#example-implementation)

```