From 1c2b0762c7f1a91394c633ae812505919bd297ed Mon Sep 17 00:00:00 2001 From: Drew Jaynes Date: Mon, 4 Dec 2017 22:39:29 +0000 Subject: [PATCH] Docs: Improve the usefulness of docs for `wp_generate_password()` by noting the use of wp_rand() vs `rand()` or `mt_rand()`. Props webdevmattcrom. Fixes #42782. git-svn-id: https://develop.svn.wordpress.org/trunk@42373 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-includes/pluggable.php | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/wp-includes/pluggable.php b/src/wp-includes/pluggable.php index 28c3e43a46..17e3fed1cb 100644 --- a/src/wp-includes/pluggable.php +++ b/src/wp-includes/pluggable.php @@ -2312,6 +2312,9 @@ if ( ! function_exists( 'wp_generate_password' ) ) : /** * Generates a random password drawn from the defined set of characters. * + * Uses wp_rand() is used to create passwords with far less predictability + * than similar native PHP functions like `rand()` or `mt_rand()`. + * * @since 2.5.0 * * @param int $length Optional. The length of password to generate. Default 12. @@ -2348,7 +2351,7 @@ endif; if ( ! function_exists( 'wp_rand' ) ) : /** - * Generates a random number + * Generates a random number. * * @since 2.6.2 * @since 4.4.0 Uses PHP7 random_int() or the random_compat library if available.