Class Context

Application Context

This class provides an interface for using the library within an large application.

<?php
$passlibContext = new PHPassLib\Application\Context;
$passlibContext->addConfig('bcrypt'); // Use bcrypt with default options

$hash = $passlibContext->hash($password);
if ($passlibContext->verify($password, $hash) {
    // ...
}

The context also allows us to check if a user's stored hash needs to be updated to a newer version.

<?php
$passlibContext = new PHPassLib\Application\Context;

// The first added config becomes the default
// This is important for methods like hash() and needsUpdate()
$passlibContext->addConfig('pbkdf2', array ('digest' => 'sha256'));

// Additional configs are supported by verify()
$passlibContext->addConfig('bcrypt');

if ($passlibContext->verify($password, $hash)) {
    // needsUpdate() will return true if the provided hash fails to
    // match the default config in any way. This means bcrypt hashes as
    // well as PBKDF2 hashes which use a digest other than SHA-256.
    if ($passlibContext->needsUpdate($hash)) {
        // $newHash will be a PBKDF2 hash
        $newHash = $passlibContext->hash($password);
        // Store $newHash into the user object
    }
    // ...
}