aboutsummaryrefslogtreecommitdiffstats
path: root/phpBB/phpbb/passwords/driver/driver_interface.php
blob: 3974484f138ad7cddd16cd6d101db4c62e5d7fde (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
<?php
/**
*
* This file is part of the phpBB Forum Software package.
*
* @copyright (c) phpBB Limited <https://www.phpbb.com>
* @license GNU General Public License, version 2 (GPL-2.0)
*
* For full copyright and license information, please see
* the docs/CREDITS.txt file.
*
*/

namespace phpbb\passwords\driver;

interface driver_interface
{
	/**
	* Check if hash type is supported
	*
	* @return bool		True if supported, false if not
	*/
	public function is_supported();

	/**
	* Check if hash type is a legacy hash type
	*
	* @return bool		True if it's a legacy hash type, false if not
	*/
	public function is_legacy();

	/**
	* Returns the hash prefix
	*
	* @return string	Hash prefix
	*/
	public function get_prefix();

	/**
	* Hash the password
	*
	* @param string $password The password that should be hashed
	*
	* @return bool|string	Password hash or false if something went wrong
	*			during hashing
	*/
	public function hash($password);

	/**
	* Check the password against the supplied hash
	*
	* @param string		$password The password to check
	* @param string		$hash The password hash to check against
	* @param array		$user_row User's row in users table
	*
	* @return bool		True if password is correct, else false
	*/
	public function check($password, $hash, $user_row = array());

	/**
	* Get only the settings of the specified hash
	*
	* @param string		$hash Password hash
	* @param bool		$full Return full settings or only settings
	*			related to the salt
	* @return string	String containing the hash settings
	*/
	public function get_settings_only($hash, $full = false);
}