wp_create_nonce()生成一个随机的、一次性的令牌

目录

描述

译文

生成一个随机的、一次性的令牌。

参数

$action

(字符串)(整数)要添加到随机数的标量值。

默认值:-1

返回的值

返回一次性使用的令牌的字符串

原文

Generates and returns a nonce. The nonce is generated based on the current time, the $action argument, and the current user ID.

wp_create_nonce() 描述

用法

<?php wp_create_nonce$action ); ?>

wp_create_nonce() 用法

参数

$action

(string/int) (可选) Action name. Should give the context to what is taking place. Optional but recommended.

默认值: -1

wp_create_nonce() 参数

返回值

(string

The one use form token.

wp_create_nonce() 返回值

注意

  • The function should be called using the init or any subsequent 动作 hook. Calling it outside of an 动作 hook can lead to problems, see the ticket #14024 for details.
  • 使用到: apply_filters() to apply the nonce_user_logged_out 过滤器s on the current user ID used to generate a nonce.
  • 使用到: wp_nonce_tick() as a time-dependent factor to generate a nonce.

wp_create_nonce() 注意

历史

  • 添加于 版本: 2.0.3

wp_create_nonce() 历史

源文件

wp_create_nonce() 函数的代码位于 wp-includes/pluggable.php.

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */
/**
 * Creates a cryptographic token tied to a specific action, user, and window of time.
 *
 * @since 2.0.3
 *
 * @param string|int $action Scalar value to add context to the nonce.
 * @return string The token.
 */
function wp_create_nonce($action = -1) {
	$user = wp_get_current_user();
	$uid = (int) $user->ID;
	if ( ! $uid ) {
		/** This filter is documented in wp-includes/pluggable.php */
		$uid = apply_filters( 'nonce_user_logged_out', $uid, $action );
	}

	$token = wp_get_session_token();
	$i = wp_nonce_tick();

	return substr( wp_hash( $i . '|' . $action . '|' . $uid . '|' . $token, 'nonce' ), -12, 10 );
}
endif;

if ( !function_exists('wp_salt') ) :

wp_create_nonce() 源文件

相关