Recommend this page to a friend! |
Download |
Info | Example | Files | Install with Composer | Download | Reputation | Support forum | Blog | Links |
Ratings | Unique User Downloads | Download Rankings | ||||
Not yet rated by the users | Total: 95 | All time: 9,870 This week: 206 |
Version | License | PHP version | Categories | |||
php-hashing 1.0.0 | MIT/X Consortium ... | 5 | PHP 5, Cryptography |
Description | Author | |||||||||||||||||||||||
This package can generate and verify hashed passwords using Argon2. |
|
<?php |
This Package provides secure Bcrypt and Argon2 hashing for storing user passwords.
> The Argon2i driver requires PHP 7.2.0 or greater and the Argon2id > driver requires PHP 7.3.0 or greater.
> Bcrypt is a great choice for hashing passwords because its "work factor" is adjustable, which means that the time it takes to generate a hash can be increased as hardware power increases.
Installing this package is very simple, first ensure you have the right PHP version and composer installed then in your terminal/(command prompt) run:
## Basic Usage
You may hash a password by calling the `make` method on the Hashing Class:
<?php use Lablnet\Hashing; require '../vendor/autoload.php';
$hashing = new Hashing();
//Original password $password = 123456; //Hash the password $password_hash = $hashing->make($password); echo $password_hash;
### Adjusting The Bcrypt Work Factor
If you are using the Bcrypt algorithm, the `make` method allows you to manage the work factor of the algorithm using the cost option:
$hashing = new Hashing('bcrypt'); $password_hash = $hashing->make($password, [
'cost' => 12
]);
### Adjusting The Argon2 Work Factor
If you are using the Argon2I or Argon2Id algorithm, the `make` method allows you to manage the work factor of the algorithm using the memory, time, and threads options:
$hashing = new Hashing('argon2i'); $password_hash = $hashing->make($password, [
'memory' => 1024,
'time' => 2,
'threads' => 2,
]);
> For more information on these options, check out the official PHP documentation.
>
### Verifying A Password Against A Hash
The `verify` method allows you to verify that a given plain-text string corresponds to a given hash
if ($hashing->verify($password,$password_hash)) {
//The password matched.
}
### Checking If A Password Needs To Be Rehashed
The `needsRehash` function allows you to determine if the work factor used by the hashing has changed since the password was hashed:
if ($hashing->needsRehash($hashed)) {
$password_hash = $hashing->make($password);
}
## Supported algorithm
in this library three algorithm are supported
- Bcrypt
- Argon2I
- Argon2ID
### Switch between algorithm
$hashing = new Hashing('supported-algorithm'); $bvcryptHashing = new Hashing('bcrypt');
#### Default work factors
You can provide default work factors like
//Argon2 $argon2Hashing = new Hashing('argon2i',[
'memory' => 1024,
'time' => 2,
'threads' => 2,
'verify' => false,
]);
//Bcrypt $vcryptHashing = new Hashing('bcrypt'[
'cost' => 12,
'verify' => false,
]);
here verify option is additional indicate that if this set to true the algorithm is also sticky check on verify, if both algorithm are not matched then means password is not correct.
Files (8) |
File | Role | Description | ||
---|---|---|---|---|
example (1 file) | ||||
src (4 files) | ||||
composer.json | Data | Auxiliary data | ||
LICENSE | Lic. | License text | ||
readme.md | Doc. | Read me |
Files (8) | / | src |
File | Role | Description |
---|---|---|
AbstractHashing.php | Class | Class source |
ArgonHashing.php | Class | Class source |
BcryptHashing.php | Class | Class source |
Hashing.php | Class | Class source |
The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page. |
Install with Composer |
Version Control | Unique User Downloads | Download Rankings | |||||||||||||||
100% |
|
|
Applications that use this package |
If you know an application of this package, send a message to the author to add a link here.