wp_hash_password_options │ filter-hook │ WP 6.8.0

Filters the options passed to the password_hash() and password_needs_rehash() functions.

The default hashing algorithm is bcrypt, but this can be changed via the wp_hash_password_algorithm filter. You must ensure that the options are appropriate for the algorithm in use.

Usage

add_filter( 'wp_hash_password_options', 'wp_kama_hash_password_options_filter', 10, 2 );

/**
 * Function for `wp_hash_password_options` filter-hook.
 * 
 * @param array  $options   Array of options to pass to the password hashing functions. By default this is an empty array which means the default options will be used.
 * @param string $algorithm The hashing algorithm in use.
 *
 * @return array
 */
function wp_kama_hash_password_options_filter( $options, $algorithm ){

	// filter...
	return $options;
}

$options(array)

Array of options to pass to the password hashing functions. By default this is an empty array which means the default options will be used.

$algorithm(string)

The hashing algorithm in use.

Changelog

Where the hook is called

$options = apply_filters( 'wp_hash_password_options', array(), $algorithm );

$options = apply_filters( 'wp_hash_password_options', array(), $algorithm );

Where the hook is used in WordPress