Download the PHP package volnix/csrf without Composer
On this page you can find all versions of the php package volnix/csrf. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package csrf
Short Description CSRF protection library that compares provided token to session token to ensure request validity.
License MIT
Homepage https://github.com/volnix/csrf
Informations about the package csrf
Volnix\CSRF
CSRF protection library that compares provided token to session token to ensure request validity. Token values are stored in session and validated against that session store to verify the request. Tokens are changed on every request so ensure frequently changes and increase the difficulty in guessing the token value.
Installation
This package is installed via composer and is pulled in as the volnix/csrf
package.
Unit Tests
The unit tests for this application live in the ./tests
directory. There is a test for each library in the security package. The PHPUnit xml file is in the root of the project (./phpunit.xml
).
Usage
This library is used for preventing cross-site request forgery. Currently you can retrieve the token, a pre-built query string, or a pre-built hidden input tag.
There are two main pieces to this library:
- Injection of a CSRF token
- Validation of the CSRF token
1. Injection of token
There are a variety of ways to get your CSRF token into your form markup:
Value only:
Hidden input string:
Query string:
If a different token name is desired, you may pass it in on any call that retrieves the token (getToken()
, getHiddenInputString()
, getQueryString()
):
2. Validation of token
To validate your token, just pass in your array of POST/GET/REQUEST data. If you have a custom token name, then there is an optional second argument for it.
Note: token validation is done using a constant-time comparison method to protect against timing attacks.
Basic POST data validation:
Using Symfony's HTTP Foundation:
Validating a custom-named token: