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.

Built from https://develop.svn.wordpress.org/trunk@42373


git-svn-id: http://core.svn.wordpress.org/trunk@42202 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2017-12-04 22:40:47 +00:00
parent 39c7daf7db
commit f4faaa53c7
2 changed files with 5 additions and 2 deletions

View File

@ -2312,6 +2312,9 @@ if ( ! function_exists( 'wp_generate_password' ) ) :
/** /**
* Generates a random password drawn from the defined set of characters. * 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 * @since 2.5.0
* *
* @param int $length Optional. The length of password to generate. Default 12. * @param int $length Optional. The length of password to generate. Default 12.
@ -2348,7 +2351,7 @@ endif;
if ( ! function_exists( 'wp_rand' ) ) : if ( ! function_exists( 'wp_rand' ) ) :
/** /**
* Generates a random number * Generates a random number.
* *
* @since 2.6.2 * @since 2.6.2
* @since 4.4.0 Uses PHP7 random_int() or the random_compat library if available. * @since 4.4.0 Uses PHP7 random_int() or the random_compat library if available.

View File

@ -4,7 +4,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '5.0-alpha-42368'; $wp_version = '5.0-alpha-42373';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.