wp_get_current_user

Retrieve the current user object.

Description

(WP_User) wp_get_current_user(); 

Will set the current user, if the current user is not set. The current user will be set to the logged-in person. If no user is logged-in, then it will set the current user to 0, which is invalid and won't have any permissions.

Returns (WP_User)

Current WP_User instance.

Usage

  1. if ( !function_exists( 'wp_get_current_user' ) ) { 
  2.     require_once ABSPATH . WPINC . '/pluggable.php'; 
  3. } 
  4.  
  5.   
  6. // NOTICE! Understand what this does before running. 
  7. $result = wp_get_current_user(); 
  8.     

Defined (2)

The function is defined in the following location(s).

/wp-includes/pluggable.php  
  1. function wp_get_current_user() { 
  2.     return _wp_get_current_user(); 
  3. } 
/wp-includes/user.php  
  1. function _wp_get_current_user() { 
  2.     global $current_user; 
  3.  
  4.     if ( ! empty( $current_user ) ) { 
  5.         if ( $current_user instanceof WP_User ) { 
  6.             return $current_user; 
  7.         } 
  8.  
  9.         // Upgrade stdClass to WP_User 
  10.         if ( is_object( $current_user ) && isset( $current_user->ID ) ) { 
  11.             $cur_id = $current_user->ID; 
  12.             $current_user = null; 
  13.             wp_set_current_user( $cur_id ); 
  14.             return $current_user; 
  15.         } 
  16.  
  17.         // $current_user has a junk value. Force to WP_User with ID 0. 
  18.         $current_user = null; 
  20.         return $current_user; 
  21.     } 
  22.  
  23.     if ( defined('XMLRPC_REQUEST') && XMLRPC_REQUEST ) { 
  25.         return $current_user; 
  26.     } 
  27.  
  28.     /** 
  29.      * Filters the current user. 
  30.      * 
  31.      * The default filters use this to determine the current user from the 
  32.      * request's cookies, if available. 
  33.      * 
  34.      * Returning a value of false will effectively short-circuit setting 
  35.      * the current user. 
  36.      * 
  37.      * @since 3.9.0 
  38.      * 
  39.      * @param int|bool $user_id User ID if one has been determined, false otherwise. 
  40.      */ 
  41.     $user_id = apply_filters( 'determine_current_user', false ); 
  42.     if ( ! $user_id ) { 
  44.         return $current_user; 
  45.     } 
  46.  
  47.     wp_set_current_user( $user_id ); 
  48.  
  49.     return $current_user; 
  50. }