WordPress at a glance
function is not described

WP_Session_Tokens::create() public WP 4.0.0

Generates a session token and attaches session information to it.

A session token is a long, random string. It is used in a cookie to link that cookie to an expiration time and to ensure the cookie becomes invalidated when the user logs out.

This function generates a token and stores it with the associated expiration time (and potentially other session information via the 'attach_session_information' filter).

{} It's a method of the class: WP_Session_Tokens{}

Hooks from the method
Return

String. Session token.

Usage

$WP_Session_Tokens = new WP_Session_Tokens();
$WP_Session_Tokens->create( $expiration );
$expiration(int) (required)
Session expiration timestamp.

Changelog

Since 4.0.0 Introduced.

Code of WP_Session_Tokens::create() WP 5.5.1

<?php
final public function create( $expiration ) {
	/**
	 * Filters the information attached to the newly created session.
	 *
	 * Can be used to attach further information to a session.
	 *
	 * @since 4.0.0
	 *
	 * @param array $session Array of extra data.
	 * @param int   $user_id User ID.
	 */
	$session               = apply_filters( 'attach_session_information', array(), $this->user_id );
	$session['expiration'] = $expiration;

	// IP address.
	if ( ! empty( $_SERVER['REMOTE_ADDR'] ) ) {
		$session['ip'] = $_SERVER['REMOTE_ADDR'];
	}

	// User-agent.
	if ( ! empty( $_SERVER['HTTP_USER_AGENT'] ) ) {
		$session['ua'] = wp_unslash( $_SERVER['HTTP_USER_AGENT'] );
	}

	// Timestamp.
	$session['login'] = time();

	$token = wp_generate_password( 43, false, false );

	$this->update( $token, $session );

	return $token;
}